{"meta":{"title":"为 GitHub Copilot 配置网络设置","intro":"可以通过 HTTP 代理连接到 GitHub Copilot 并使用自定义证书。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/copilot","title":"GitHub Copilot"},{"href":"/zh/copilot/how-tos","title":"操作方法"},{"href":"/zh/copilot/how-tos/configure-personal-settings","title":"配置个人设置"},{"href":"/zh/copilot/how-tos/configure-personal-settings/configure-network-settings","title":"配置网络设置"}],"documentType":"article"},"body":"# 为 GitHub Copilot 配置网络设置\n\n可以通过 HTTP 代理连接到 GitHub Copilot 并使用自定义证书。\n\n<div class=\"ghd-tool visualstudio\">\n\n> \\[!NOTE] GitHub Copilot 当前无法与 Visual Studio for Mac 结合使用。\n\n</div>\n\n你可以通过 HTTP 代理连接到 Copilot 并使用自定义证书。 如果您正在处理需要代理服务器的公司网络，或者需要检查 Copilot 的安全连接内容，这将非常有用。 请参阅 [GitHub Copilot 的网络设置](/zh/copilot/concepts/network-settings-for-github-copilot)。\n\n## 配置 Copilot 的代理设置\n\n可以在所选编辑器中配置 Copilot 的 HTTP 代理。 要查看编辑器的说明，请使用本文顶部的选项卡。\n\n<div class=\"ghd-tool jetbrains\">\n\n1. 在 JetBrains IDE 中，单击“文件”\\*\\*\\*\\* 菜单 (Windows) 或菜单栏中的应用程序名称 (macOS)，然后单击“设置”\\*\\*\\*\\*。\n2. 在“外观与行为”下，单击“系统设置”，然后单击“HTTP 代理”  。\n3. 依次选择“手动代理配置”和“HTTP”。\n4. 在“主机名”字段中，输入代理服务器的主机名，并在“端口号”字段中输入代理服务器的端口号。\n5. （可选）若要将 Copilot 配置为忽略证书错误，请在左侧栏中单击“**外观和行为**”，单击“**系统设置**”，单击“**服务器证书**”，然后选择或取消选择“**自动接受不受信任的证书**”。\n\n   > \\[!WARNING] 忽略证书错误可能会导致安全问题，因此不建议这样做。\n\n如果已配置代理但仍遇到连接错误，请参阅 [排查 GitHub Copilot 的网络错误](/zh/copilot/troubleshooting-github-copilot/troubleshooting-network-errors-for-github-copilot#troubleshooting-proxy-errors)。\n\n### 基本身份验证\n\nJetBrains 的 Copilot 支持基本身份验证。 要进行身份验证，你可以在“手动代理配置”页面上选择“代理身份验证”\\*\\*\\*\\*，然后输入你的凭据。\n\n这会将你的凭据以纯文本形式存储在编辑器的设置中。 或者，您可以选择将您的凭据包含在代理 URL 中（例如：`http://USERNAME:PASSWORD@10.203.0.1:5187/`），然后将此 URL 设置为 [Proxy settings for Copilot](/zh/copilot/concepts/network-settings-for-github-copilot#proxy-settings-for-copilot) 中列出的受支持的环境变量之一。\n\n</div>\n\n<div class=\"ghd-tool vscode\">\n\n1. 在“文件”菜单中，导航到“首选项”，然后单击“设置”  。\n\n   ![Visual Studio Code 设置的屏幕截图。](/assets/images/help/copilot/vsc-settings.png)\n2. 在“设置”选项卡的左侧面板中，单击“应用程序”，然后选择“代理” 。\n3. 在“Proxy”下的文本框中，键入代理服务器的地址，例如 `http://localhost:3128`。\n4. （可选）要将 Copilot 配置为忽略证书错误，请在“Proxy Strict SSL”下选中或取消选中此复选框。\n\n   > \\[!WARNING] 忽略证书错误可能会导致安全问题，因此不建议这样做。\n\n如果已配置代理但仍遇到连接错误，请参阅 [排查 GitHub Copilot 的网络错误](/zh/copilot/troubleshooting-github-copilot/troubleshooting-network-errors-for-github-copilot#troubleshooting-proxy-errors)。\n\n### 基本身份验证\n\nVS Code 的 Copilot 支持基本身份验证。 要进行身份验证，你可以将凭据包含在代理 URL 中，例如：`http://USERNAME:PASSWORD@10.203.0.1:5187/`。 可以将此 URL 存储在 VS Code 设置中或 [Copilot 的代理设置](/zh/copilot/concepts/network-settings-for-github-copilot#proxy-settings-for-copilot)中列出的其中一个环境变量中。\n\n</div>\n\n<div class=\"ghd-tool visualstudio\">\n\nVisual Studio 的 Copilot 从 Windows 读取代理设置。 有关在 Windows 上配置代理设置的信息，请参阅 Microsoft 文档的“在 Windows 中使用代理服务器”[](https://support.microsoft.com/en-us/windows/use-a-proxy-server-in-windows-03096c53-0554-4ffe-b6ab-8b1deee8dae1)中的“手动设置代理服务器连接”下的说明。\n\n如果已配置代理但仍遇到连接错误，请参阅 [排查 GitHub Copilot 的网络错误](/zh/copilot/troubleshooting-github-copilot/troubleshooting-network-errors-for-github-copilot#troubleshooting-proxy-errors)。\n\n### 基本身份验证\n\n虽然适用于 Visual Studio 的 Copilot 会从 Windows 读取代理设置，但它不会从这些 Windows 设置中获取身份验证凭据。\n\n如果需要向代理进行身份验证，可以尝试以下操作之一：\n\n1. 通过将环境变量 `COPILOT_USE_DEFAULTPROXY` 设置为 `true`，可以启用默认代理凭据的传递。\n   * Windows 示例\\*\\*\\*\\*：打开命令提示符，并运行以下命令：\n\n     ```bash\n     setx COPILOT_USE_DEFAULTPROXY true\n     ```\n\n     这会为你的用户帐户永久设置该变量。 重启需要使用此变量的任何应用程序。\n2. 可以将凭据包含在代理 URL 中（例如：`http://USERNAME:PASSWORD@10.203.0.1:5187/`），然后将此 URL 设置为[Proxy settings for Copilot](/zh/copilot/concepts/network-settings-for-github-copilot#proxy-settings-for-copilot)中所列的受支持环境变量之一。\n\n</div>\n\n<div class=\"ghd-tool vscode\">\n\n### 在 VS Code 中替代默认 SPN\n\n1. 按 <kbd>Shift</kbd>+<kbd>Command</kbd>+<kbd>P</kbd> (Mac)/<kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (Windows/Linux) 来打开 VS Code Command Palette。\n2. 键入 `settings`，然后单击“首选项：打开用户设置 (JSON)”\\*\\*\\*\\*。\n3. 在 JSON 对象中，添加以下顶级属性，以将 `YOUR-SPN` 替换为你的代理服务的正确 SPN。\n\n   ```json copy\n   \"http.proxyKerberosServicePrincipal\": \"YOUR-SPN\",\n   ```\n\n</div>\n\n<div class=\"ghd-tool jetbrains\">\n\n### 替代 JetBrains IDE 中的默认 SPN\n\n1. 在 JetBrains IDE 中，单击“文件”\\*\\*\\*\\* 菜单 (Windows) 或菜单栏中的应用程序名称 (macOS)，然后单击“设置”\\*\\*\\*\\*。\n   可重用资源.copilot.jetbrains-tools %}，然后单击 **网络**。\n2. 在“替代 Kerberos 代理服务主体名称”字段中，键入代理服务的 SPN。\n\n</div>\n\n## 安装自定义证书\n\n通常，如果你使用的是公司设备，公司的 IT 部门应已在计算机上安装任何必需的证书。 如果你需要安装证书，请参阅以下说明。\n\n> \\[!WARNING] 安装自定义证书就是指示计算机信任证书创建者，这可能会导致创建者截获来自你的计算机的所有互联网流量。 应非常小心地验证你是否安装正确的证书。\n\n* 对于 Windows，请参阅 Microsoft 文档中的[安装受信任的根证书](https://learn.microsoft.com/en-us/skype-sdk/sdn/articles/installing-the-trusted-root-certificate)。\n* 有关 macOS，请参阅钥匙串访问用户指南中的[在 Mac 上使用钥匙串访问将证书添加到钥匙串](https://support.apple.com/en-gb/guide/keychain-access/kyca2431/mac)。\n* 对于 Linux，请参阅 Ubuntu 文档中的[在信任存储中安装根 CA 证书](https://ubuntu.com/server/docs/security-trust-store)。 类似的说明应适用于大多数 Linux 发行版。\n\n如果你已经安装证书但 Copilot 未检测到它，请参阅 [排查 GitHub Copilot 的网络错误](/zh/copilot/troubleshooting-github-copilot/troubleshooting-network-errors-for-github-copilot#troubleshooting-certificate-related-errors)。"}