GitHub Codespace中IPv6端口转发无法访问，该如何解决？

问题分析 #

GitHub Codespaces 的自动端口转发机制默认对 IPv4 端口支持更完善，当应用仅监听 IPv6 地址时，自动转发无法识别并建立访问通道，这是导致无法访问的核心原因。

可行解决方案 #

• 修改应用监听地址，同时支持 IPv4/IPv6
  多数应用支持通过配置监听 0.0.0.0 或 :: 来同时绑定 IPv4 和 IPv6 接口。以 Node.js 应用为例：

  // 原仅监听 IPv6 的代码
  app.listen(8080, '::1', () => console.log('Listening on IPv6'));
  // 修改为监听所有接口（兼容 IPv4/IPv6）
  app.listen(8080, '0.0.0.0', () => console.log('Listening on all interfaces'));
  // 或省略地址参数，默认监听所有接口
  app.listen(8080, () => console.log('Listening on all interfaces'));
  

  修改后执行 lsof -i :8080 会看到同时存在 IPv4 和 IPv6 的监听进程，Codespaces 的自动转发会自动识别并生效。

• 通过工具手动实现端口映射
  若无法修改应用代码，可使用 socat 工具将 IPv6 端口映射到 IPv4 端口，让 Codespaces 的转发机制识别：

  1. 安装 socat：

     sudo apt update && sudo apt install socat -y
     

  2. 执行转发命令（将 IPv6 的 8080 端口映射到 IPv4 的 8081 端口）：

     socat TCP4-LISTEN:8081,fork TCP6:localhost:8080
     

  3. 在 Codespaces 的「端口」面板中手动添加 8081 端口的转发规则，即可通过该端口访问原 IPv6 应用。

• 检查并启用 Codespaces 的 IPv6 网络

  1. 在终端执行 ip addr，确认实例是否分配了 IPv6 地址（查找 inet6 开头的条目）。
  2. 若未分配 IPv6 地址，尝试重启 Codespaces 实例，部分场景下重启后会自动获取 IPv6 地址。

内容的提问来源于stack exchange，提问作者Estevanbs