在您的 Codespace 中转发端口

当在 Codespace 中运行的应用程序将输出打印到包含 localhost URL 的终端时，例如 `https://127.0.0.1:PORT` 或 `http://127.0.0.1:PORT`，该端口将自动转发。如果您在浏览器或 Visual Studio Code 中使用 GitHub Codespaces，则终端中的 URL 字符串将转换为可点击的链接，以便您可以在本地计算机上查看网页。默认情况下，GitHub Codespaces 使用 HTTP 转发端口。

您可以编辑存储库的开发容器配置以自动转发一个或多个端口。您还可以手动转发端口、标记转发端口、与组织成员共享转发端口、公开共享转发端口以及将转发端口添加到 Codespace 配置。

转发端口

您可以手动转发未自动转发的端口。

1. 在 Codespace 中打开终端。

2. 点击“**端口**”选项卡。

3. 在端口列表下方，点击“**添加端口**”。

   

4. 键入端口号或地址，然后按 Enter。

   

使用 HTTPS 转发

默认情况下，GitHub Codespaces 使用 HTTP 转发端口，但您可以根据需要更新任何端口以使用 HTTPS。如果您更新具有公共可见性的端口以使用 HTTPS，则该端口的可见性将自动更改为私有。

1. 在 Codespace 中打开终端。

2. 点击“**端口**”选项卡。

3. 右键单击要更新的端口，然后将鼠标悬停在**更改端口协议**上。

   

4. 选择此端口所需的协议。您选择的协议将在 codespace 的整个生命周期内为此端口保留。

共享端口

如果要与他人共享已转发端口，则可以将其设为组织私有或设为公开。将端口设为组织私有后，组织中任何拥有该端口 URL 的人都可以查看正在运行的应用程序。将端口设为公开后，任何知道 URL 和端口号的人都可以查看正在运行的应用程序，而无需进行身份验证。

1. 在 Codespace 中打开终端。

2. 点击“**端口**”选项卡。

3. 右键单击要共享的端口，单击**端口可见性**，然后单击**组织私有**或**公开**。

   

4. 在端口的本地地址右侧，单击复制图标。

   

5. 将复制的 URL 发送给您要与之共享端口的人员。

使用命令行工具和 REST 客户端访问端口

转发端口后，您的应用程序将在 URL https://CODESPACENAME-PORT.app.github.dev 上可用。例如，https://monalisa-hot-potato-vrpqrxxrx7x2rxx-4000.app.github.dev。如果您从 VS Code 桌面应用程序转发私有端口，则您的应用程序也将在 localhost 端口（例如 127.0.0.1:4000）上可用。

要使用 REST 客户端（如 Postman）或命令行工具（如 curl）访问您的应用程序，如果您使用的是 localhost 端口，或者如果您正在访问远程域上的公共端口，则无需进行身份验证。但是，要连接到远程域上的私有端口，您必须使用请求中的 GITHUB_TOKEN 访问令牌进行身份验证。

查找要连接到的地址

1. 在 Codespace 中打开终端。

2. 单击**端口**选项卡。这将列出您已转发的所有端口。

3. 右键单击要连接到的端口，然后单击**复制本地地址**。

   

4. 将复制的地址粘贴到某个位置以供以后使用。

查找 GITHUB_TOKEN

1. 在 codespace 中的终端中，输入 echo $GITHUB_TOKEN。

   该令牌是一个以 ghu_ 开头的字符串。

2. 复制令牌。

   重要

   不要与任何人共享此访问令牌。

使用 curl 访问转发端口

在本地计算机上的终端中，输入

curl ADDRESS -H "X-Github-Token: TOKEN"

将 ADDRESS 和 TOKEN 替换为您之前复制的值。

使用 Postman 访问转发端口

1. 打开 Postman。

2. 创建一个新的 GET 请求。

3. 将您之前复制的地址粘贴为请求 URL。

   

4. 在**标头**选项卡中，创建一个新条目，其中键为“X-Github-Token”，值为之前复制的 GITHUB_TOKEN。

   

5. 单击**发送**。

自动转发端口

您可以将转发端口添加到存储库的 GitHub Codespaces 配置中，以便为从存储库创建的所有 codespace 自动转发端口。更新配置后，必须重建任何先前创建的 codespace 才能使更改生效。有关开发容器配置文件的更多信息，请参阅“开发容器简介”。

1. 在您的 codespace 中，打开要更新的开发容器配置文件。通常，此文件为 .devcontainer/devcontainer.json。

2. 添加 forwardPorts 属性。

   "forwardPorts": [NUMBER],
   

   将 NUMBER 替换为您要转发的端口号。这可以是端口号的逗号分隔列表。

3. 保存文件。

标记端口

当您在浏览器或 VS Code 桌面应用程序中打开 codespace 时，您可以标记转发端口以使其在列表中更容易识别。

1. 在 Codespace 中打开终端。

2. 点击“**端口**”选项卡。

3. 右键单击要标记的端口，然后单击**设置端口标签**。

   

4. 为您的端口键入标签，然后按 Enter。

   

自动标记转发端口

您可以标记端口并将更改写入存储库的开发容器配置文件。如果您对使用 forwardPorts 属性自动转发的端口执行此操作，则该标签将自动应用于使用该配置文件从存储库创建的所有未来 codespace 的该转发端口。

1. 在 Codespace 中打开终端。

2. 点击“**端口**”选项卡。

3. 右键单击要将其标签属性添加到 codespace 配置的端口，然后单击**设置标签并更新 devcontainer.json**。

   

4. 为您的端口键入标签，然后按 Enter。

   

5. 如果您的存储库有多个开发容器配置文件，系统将提示您选择要更新的文件。

   开发容器配置文件将更新为在 portsAttributes 属性中包含新标签。例如

   // Use 'forwardPorts' to make a list of ports inside the container available locally.
   "forwardPorts": [3333, 4444],
   
   "portsAttributes": {
     "3333": {
       "label": "app-standard-preview"
     },
     "4444": {
       "label": "app-pro-preview"
     }
   }