Skip to main content

排查与 GitHub Codespaces 的连接问题

连接到 GitHub Codespaces 的故障排除帮助。

503 Codespace服务不可用

Codespaces 设置为在无任何活动 30 分钟后停止。 如果你在 codespace 停止后尝试与其交互,你可能会看到 错误。

  • 如果 Visual Studio Code 或浏览器窗口中显示“开始”按钮,请单击“开始”以重新连接到 codespace 。
  • 通过重新加载窗口来重置代码空间。 从 Visual Studio Code 中的命令面板,单击“开发人员: 重新加载窗口”。

浏览器无法连接

有时,您可能无法从浏览器访问代码空间。 如果出现这种情况,请访问指定页面并尝试从该页面连接到 Codespace。

  • 如果该页面上未列出代码空间,请检查您是尝试连接到的代码空间的所有者。 您只能打开自己创建的代码空间。
  • 如果列出了代码空间,但您无法从该页面进行连接,请检查是否可以使用其他浏览器进行连接。

通过错误消息进行诊断

“很不幸,你似乎已离线”

检查你的互联网连接是否稳定,并且你的公司网络是否未阻止连接。 如果可能,请检查设备上是否有被拒绝连接的日志记录。

如果看到连接被拒绝,请确保防火墙没有阻止 REST API 终结点所记录的域名。 有关详细信息,请参阅“AUTOTITLE”。

要获取 GitHub Codespaces 所需域的列表,请使用 GitHub CLI 执行以下命令:

gh api meta --jq .domains.codespaces

“我们在提取您的代码空间信息时遇到问题。”

这是一个暂时性错误。 请在等待几分钟后重试。

“我们无法完成连接的身份验证”

这表示身份验证存在问题。 尝试清除本地存储和 Cookie,然后重试。

如果仍然无法连接,并且你看到的消息未在此列表中,请在 githubstatus.com 上检查 Codespaces 的服务可用性。 如果 Codespaces 服务可用,则 可能需要联系支持人员。 有关详细信息,请参阅“与 GitHub Codespaces 支持协作”。

无法连接到 JupyterLab 中的代码空间

若要在 JupyterLab 中使用 codespace,必须确保已在 codespace 中安装了 JupyterLab。 GitHub Codespaces 使用的默认开发容器映像包括 JupyterLab,但如果已自定义开发容器配置,则必须手动安装 JupyterLab。

如果您的代码空间使用基于 Debian 的映像,可以在开发容器中安装 JupyterLab,方法是在文件中添加 JupyterLab 这一功能,并将配置选项设置为启用。 否则,请直接将其安装在 Dockerfile 中。 有关安装说明,请参阅 JupyterLab 文档中的安装。

有关 功能的详细信息,请参阅 存储库中的自述文件页。 关于文件和 Dockerfile 的详细信息,请参阅 AUTOTITLE。

如果仍然无法连接,可能需要联系支持人员。 有关详细信息,请参阅“与 GitHub Codespaces 支持协作”。

Visual Studio Code 的 GitHub Codespaces 扩展无法连接

如果无法从 Visual Studio Code 桌面连接到代码空间,请使用以下故障排除步骤。

  1. 检查您是否安装了最新版本的 GitHub Codespaces 扩展。 该扩展是预览版,并且频繁发布更新。
    1. 在 Visual Studio Code 中,显示“Extensions(扩展)”选项卡。
    2. 选择 GitHub Codespaces 扩展以显示扩展的概述页面。
    3. 如果有可用更新,则会显示一个按钮,单击“更新到 X.X.X”以升级到最新版本。
  2. 检查你使用的是 Visual Studio Code 稳定版还是 Visual Studio Code 内部版(每晚更新)。 如果您正在使用内部版本,请尝试安装稳定版本。
  3. 确保公司网络没有阻止连接。
    1. 如果收到错误(如 、、 或其他类似错误),则防火墙可能会阻止与连接服务的连接。 若要验证这一点,请访问此 URL。 如果请求失败或未看到任何数据,则可能需要与系统管理员协作,将 添加到防火墙的 IP 允许列表。
    2. 如果看到错误 ,则可能是防火墙正在执行 TLS 检查并注入自签名证书,GitHub 无法对其进行验证。 若要解决此问题,系统管理员需要允许系统绕过检查,或者在本地计算机上安装防火墙注入的根 CA。

如果仍然无法连接,可能需要联系支持人员。 有关详细信息,请参阅“与 GitHub Codespaces 支持协作”。

代码空间存在延迟问题

如果代码空间看起来特别慢或存在延迟问题,则可能是在远离您的区域中创建的。 要解决此问题,可以手动设置 GitHub Codespaces 区域。