GitHub Codespaces 怎样修改转发端口的可见性

GitHub Codespaces 的转发端口默认只对自己可见。要让同一组织的成员访问，或让知道地址的访客直接打开，需要在 Codespace 的 PORTS 面板中修改 Port Visibility。常用路径是：找到端口 → 右键 → Port Visibility → 选择 Private to Organization 或 Public。也可以用 GitHub CLI 批量设置多个端口。

官方地址：https://github.com/

下面的界面图是原创操作示意，不是 GitHub、VS Code、浏览器或终端截图；示例中的端口、地址和工作区名称仅用于说明操作位置。

1. 先确认端口已经出现在 Ports 列表

端口可见性只能作用于已经转发的 TCP 端口。先在 Codespace 中启动自己的 Web 服务，例如让开发服务器监听 3000 端口；当终端输出本地地址，Codespaces 通常会自动发现并转发它。如果没有自动出现，也可以打开终端旁的 PORTS 面板，点击 Add port，输入端口号后按 Enter。

端口列表中至少要能看到端口号、协议、标签和访问地址。列表里没有目标端口时，不要直接寻找可见性设置，先完成转发。

2. 在 Ports 面板修改可见性

在 Codespace 中打开 PORTS 面板，找到需要分享的端口。右键该行，点击 Port Visibility，然后选择目标范围：

• Private：仅自己可见，也是转发端口的默认范围。
• Private to Organization：组织成员可以通过端口地址访问；此选项要求组织使用 GitHub Team 或 GitHub Enterprise Cloud。
• Public：知道 URL 和端口号的访问者可以打开，不需要再登录 GitHub。

选择后，点击端口右侧的复制图标，保存新的访问地址。完成标志是端口行的可见性标签已经变成目标状态，且复制出的地址对应当前端口，而不是浏览器地址栏中的 Codespace 页面地址。

3. 需要批量修改时使用 GitHub CLI

如果一个 Codespace 同时运行前端、API 和调试服务，可以用 GitHub CLI 的端口命令一次设置多个端口。命令执行后按提示选择目标 Codespace：

# 把前端端口设为公开，把内部 API 端口限制在组织内
gh codespace ports visibility 3000:public 8080:org

# 只把本地调试端口恢复为仅自己可见
gh codespace ports visibility 9229:private

这里的左侧数字是 Codespace 内正在转发的端口，右侧是可见性设置。private、org、public 分别对应仅自己、组织内和公开。若有多个 Codespace，命令交互界面会要求你选中要操作的那个实例。

也可以先列出端口，确认端口号与地址：

# 查看可选 Codespace 及其已转发端口
gh codespace ports

# 选定端口后再执行 visibility 命令，避免改错实例
gh codespace ports visibility 3000:public

CLI 只负责修改已存在的转发端口，不会替你启动应用，也不会因为端口号写在命令里就自动创建监听服务。

4. 根据访问方式判断修改结果

改完可见性后，可以按访问对象区分结果，不要把“能复制 URL”误认为“所有人都能打开”。

在桌面 VS Code 中，私有端口还可能提供本地地址，例如 127.0.0.1:4000；远程 Codespaces 地址通常形如 https://CODESPACENAME-PORT.app.github.dev。两类地址的访问规则不同，因此排查时先确认你复制的是本地地址还是远程地址。

5. 选项不见或切到 HTTPS 后怎么办

看不到 Private to Organization：先确认组织计划与账号权限，再检查组织所有者是否限制了端口向组织内共享。组织策略可以限制公开或组织内共享，所以同一套操作在不同组织下看到的选项可能不同。

公开端口仍无法访问：确认应用确实监听在被转发的端口，并检查复制的地址是否包含正确的 Codespace 名称和端口号。不要把私有端口的远程地址当成公开链接；私有远程地址需要使用 Codespace 创建的 GITHUB_TOKEN 做认证，令牌不要复制给其他人。

把协议改成 HTTPS 后可见性变了：Codespaces 默认用 HTTP 转发。若把一个公开端口改为 HTTPS，它的可见性会自动切回 Private。需要公开访问时，先确认业务是否真的需要 HTTPS，再重新检查可见性；协议选择会在当前 Codespace 生命周期内被记住。

希望以后自动转发：可以在仓库的 .devcontainer/devcontainer.json 中配置 forwardPorts，但这只负责让端口自动出现在转发列表，不等于把端口变成公开。可见性仍然要按当前组织策略和分享目标单独决定。

{
  "forwardPorts": [3000, 8080]
}

JSON 不支持注释，因此上面的配置保持严格 JSON；字段含义是在代码块旁说明的。

相关问题

Public 端口是否需要访问者登录 GitHub？按照官方说明，公开端口的 URL 对知道地址和端口号的人可访问，不需要 GitHub 身份认证；因此不应把 Public 当作内部共享选项。

可以只改变端口的协议而不改变可见性吗？可以从 Ports 菜单的 Change Port Protocol 修改 HTTP 或 HTTPS，但公开端口切换到 HTTPS 时会自动变为 Private，需要再次检查 Port Visibility。

修改仓库的 forwardPorts 就会改变端口权限吗？不会。forwardPorts 只描述哪些端口自动转发，端口的 Private、Organization、Public 仍由 Ports 面板或 CLI 单独设置。

最后按三项核对：目标端口已在 Ports 列表；可见性标签与分享范围一致；访问者使用的是正确地址并满足组织策略或认证要求。这样修改的才是“谁能访问”，而不是只修改了一个显示标签。

官方文档：https://docs.github.com/en/codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace