跳至主要内容

GitHub Codespaces 端口转发故障排除

常见端口转发问题的故障排除步骤。

当在 Codespace 中运行的应用程序将端口输出到控制台时,GitHub Codespaces 会检测到 localhost URL 模式并自动转发端口。有关更多信息,请参阅 "在 Codespace 中转发端口"。

如果端口未自动转发,您可以手动转发它。有关更多信息,请参阅 "在 Codespace 中转发端口"。

如果端口转发已设置,请检查以下内容

  • 使用 VS Code 右下角弹出的通知“提示”中的链接,或单击终端中的 URL,打开转发的端口。如果您通过浏览器连接到 Codespace,则在本地机器上键入 localhost:8000(例如)将不起作用。
  • 请确保您的应用程序仍在您的 Codespace 中运行。如果您的 Codespace 在一段时间不活动后停止运行,您需要在 Codespace 重新启动后重新启动您的应用程序。

通常,您可以将转发端口公开访问,或在拥有存储库的组织内访问。有关更多信息,请参阅“在您的 Codespace 中转发端口”。如果公开或组织可见性的选项之一或两者都不可用,则表示已配置组织级策略。有关更多信息,请参阅“限制转发端口的可见性”。

GitHub 用于端口转发的域可能会不时更改。如果您在代码中引用了转发端口,例如在测试中,我们建议您使用环境变量而不是硬编码 URL。有关更多信息,请参阅“Codespace 的默认环境变量”。