排查连接到 GitHub Codespaces 的问题

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

本文内容

503 codespace 服务不可用

Codespaces 在 30 分钟内没有任何活动后将停止。如果您尝试在 codespace 停止后与它交互，您可能会看到 503 服务不可用 错误。

  • 如果 Visual Studio Code 或浏览器窗口中显示了 **启动** 按钮，请单击 **启动** 以重新连接到 codespace。
  • 通过重新加载窗口来重置您的 codespace。在 Visual Studio Code 的 命令面板 中，单击 **开发者：重新加载窗口**。

浏览器无法连接

有时您可能无法从浏览器访问 Codespace。如果发生这种情况，请访问 https://github.com/codespaces 并尝试从该页面连接到 Codespace。

  • 如果该页面未列出 Codespace，请检查您是否为要连接到的 Codespace 的所有者。您只能打开自己创建的 Codespace。
  • 如果列出了 Codespace，但您无法从该页面连接，请检查您是否可以使用其他浏览器连接。

通过错误消息诊断

"糟糕，看起来您处于离线状态"

检查您是否拥有稳定的互联网连接，以及您的公司网络是否阻止了连接。如果可能，请检查设备上拒绝连接的日志。

如果您看到拒绝连接，请确保您的防火墙未阻止 /meta REST API 端点记录的域。有关更多信息，请参阅 "元数据的 REST API 端点"。

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

gh api meta | jq .domains.codespaces

"我们无法获取您的 Codespace 信息"

这是一个过渡性错误。请等待几分钟，然后重试。

"我们无法验证您的连接"

这表明身份验证出现问题。尝试清除本地存储和 Cookie，然后重试。

如果您仍然无法连接，并且您看到的错误消息不在此列表中，请在 githubstatus.com 上检查 Codespaces 的服务可用性。如果 Codespaces 服务可用，您可能需要联系支持。有关更多信息，请参阅 "GitHub Codespaces 支持"。

无法在 JupyterLab 中连接到您的 Codespace

要能够在 JupyterLab 中使用 Codespace，您必须确保您的 Codespace 已安装它。GitHub Codespaces 使用的默认开发容器映像包含 JupyterLab，但如果您已自定义开发容器配置，则需要手动安装 JupyterLab。

如果您的 Codespace 使用基于 Debian 的映像，您可以在开发容器中通过将 python 功能添加到您的 devcontainer.json 文件中，并将 installJupyterlab 选项设置为 true 来安装 JupyterLab。否则，请直接在您的 Dockerfile 中安装它。有关安装说明，请参阅 JupyterLab 文档中的 "安装"。

有关 python 功能的更多信息，请参阅 devcontainers/features 存储库 中的 README 页面。有关 devcontainer.json 文件和 Dockerfile 的更多信息，请参阅 "开发容器简介"。

如果您仍然无法连接，您可能需要联系支持。有关更多信息，请参阅“与 GitHub Codespaces 支持人员合作”。

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

如果您无法从 Visual Studio Code 桌面连接到 codespace，请使用以下故障排除步骤。

  1. 检查您是否安装了最新版本的 GitHub Codespaces 扩展。该扩展是预览版，会经常发布更新。
    1. 在 Visual Studio Code 中，显示“扩展”选项卡。
    2. 选择 GitHub Codespaces 扩展以显示扩展的概述页面。
    3. 如果有更新可用，将显示一个按钮，单击更新到 X.X.X 以升级到最新版本。
  2. 检查您是否使用的是 Visual Studio Code 的稳定版本或Visual Studio Code Insiders 版本（每日更新）。如果您使用的是 Insiders 版本，请尝试安装稳定版本。
  3. 确保您的公司网络没有阻止连接。
    1. 如果您收到类似 connect EACCES、connect ECONNREFUSED、getaddrinfo ENOTFOUND 或其他类似错误的错误，您的防火墙可能正在阻止与我们的连接服务的连接。要验证这一点，请访问此 URL。如果请求失败或您没有看到任何数据，您可能需要与系统管理员合作将 *.visualstudio.com 添加到防火墙的 IP 允许列表中。
    2. 如果您看到错误 隧道服务 HTTPS 证书无效。这可能是由于使用自签名证书或防火墙拦截连接造成的，则您的防火墙可能正在执行 TLS 检查并注入 GitHub 无法验证的自签名证书。要解决此问题，您的系统管理员需要允许 *.visualstudio.com 绕过检查，或者在您的本地机器上安装防火墙正在注入的根 CA。

如果您仍然无法连接，您可能需要联系支持。有关更多信息，请参阅“与 GitHub Codespaces 支持人员合作”。

codespace 存在延迟问题

如果您的 Codespace 速度特别慢或存在延迟问题，则可能是它是在距离您很远的区域创建的。要解决此问题，您可以手动设置您的 GitHub Codespaces 区域。