跳到正文

GitHub Copilot 怎么走代理:VS Code 与 JetBrains 设置及验证

如何在 VS Code 和 JetBrains 中给 GitHub Copilot 设置代理、基本认证怎么用、GitHub 对证书怎么说,以及如何用 curl 验证。

代理不会改变什么

本文讨论网络设置,而非 Copilot 对你是否可用。GitHub 的贸易管制页面说,使用 GitHub 受美国出口管制和制裁法律约束,GitHub Copilot 不得提供给被禁运的目的地和某些受限国家。代理只改变网络出口,它不会让 Copilot 在原本不可用的地区变得可用,也不会改变 GitHub 的条款或你的套餐。

VS Code 里的代理

在 VS Code 里,GitHub 文档的写法是:File → Preferences → Settings,再到 Application → Proxy,在 Proxy 下的文本框里填代理地址,例如 http://localhost:3128。这一页描述的是这个输入框,没有写出 settings.json 里的键名。VS Code 文档里对应的设置叫 http.proxy,Proxy 框很可能就存成它,但两份文档都没有确认 Copilot 会读取它,所以请用下面的检查来确认。想以文本方式编辑,可在命令面板运行 Preferences: Open User Settings (JSON)。改完后重启 VS Code。

VS Code 里的代理:示例

http://USERNAME:PASSWORD@HOST:PORT

VS Code 的 Proxy 框填这个地址。把 HOST、PORT、USERNAME、PASSWORD 换成「我的资产」里的值。

JetBrains 里的代理

在 JetBrains 系列 IDE(IntelliJ IDEA、PyCharm、WebStorm 等)里,GitHub 文档的写法是:Settings → Appearance & Behavior → System Settings → HTTP Proxy,选 Manual proxy configuration 和 HTTP,再填主机名和端口号。需要用户名和密码时,在同一页勾选 Proxy authentication 并填入。文档提醒这些凭据会以明文保存。另一种做法是把凭据写进代理地址,再把这个地址设置在受支持的环境变量里。

编辑器里没设代理时:环境变量

如果编辑器里没有设置代理,Copilot 会按这个顺序查环境变量:HTTPS_PROXY、https_proxy、HTTP_PROXY、http_proxy。它用找到的第一个同时处理 HTTP 和 HTTPS 请求,GitHub 说明这不符合通常的惯例。在终端里设置的环境变量,从桌面图标启动的编辑器是看不到的,所以请在同一个终端里设置后再启动编辑器,或者直接用编辑器里的字段。

用户名和密码:基本认证

GitHub 文档说 Copilot 支持基本认证和 Kerberos。买到的带用户名和密码的代理,用的就是基本认证。在 VS Code 里,用户名和密码写进地址:http://USERNAME:PASSWORD@HOST:PORT(GitHub 自己的例子是 http://USERNAME:[email protected]:5187/),这个地址保存在 VS Code 设置或受支持的环境变量里。

百分号编码是通用的网址写法,GitHub 这一页没有讲:密码里有特殊字符时,把 @ 写成 %40,: 写成 %3A,/ 写成 %2F,# 写成 %23,% 写成 %25。

HTTP 还是 SOCKS5

GitHub 的网络页面说只支持基本的 HTTP 代理,以 https:// 开头的代理地址目前不支持。页面没有提到 SOCKS。VS Code 文档说 SOCKS5 代理的认证尚未实现。所以请选 HTTP,地址以 http:// 开头。

证书

如果你的代理会替换证书,GitHub 说 Copilot 会读取操作系统信任库里的证书,也会读取环境变量 NODE_EXTRA_CA_CERTS 指向的文件。只安装你核实过的证书:证书的持有者可以读取你的流量。

作为最后手段,GitHub 列出的做法是:在 VS Code 里关闭 Proxy Strict SSL,或在 JetBrains 的 Appearance & Behavior → System Settings → Server Certificates 下启用 Accept non-trusted certificates automatically,并说这会带来安全问题,不推荐。

如何验证代理是否正常工作

  1. 第 1 步

    在终端里测试代理。GitHub 的故障排查页给出的检查是运行下面的 curl 命令,连接正常会返回 HTTP 200。Copilot Chat 在同一页里改用 https://api.githubcopilot.com/_ping。

  2. 第 2 步

    看看代理显示的 IP。它会显示网站看到的 IP、国家和网络。ip、country、city 和 org 这几个字段怎么读,见代理 IP 怎么查。

  3. 第 3 步

    重启编辑器并打开 Copilot。重启后在编辑器里登录 GitHub,发一条简短的聊天消息或接受一条补全建议。如果仍然失败,GitHub 的页面建议打开编辑器的调试日志,并参阅它关于查看 Copilot 日志的文章。

  4. 第 4 步

    如果涉及公司防火墙,请放行 GitHub 给出的清单。GitHub 的允许清单参考里包括 https://github.com、https://api.github.com/copilot_internal/*、https://copilot-proxy.githubusercontent.com 和 https://*.githubcopilot.com/* 等。完整表格请到那一页看,公司版套餐的清单有所不同。

如何验证代理是否正常工作:示例

curl --verbose -x http://USERNAME:PASSWORD@HOST:PORT -i -L https://copilot-proxy.githubusercontent.com/_ping

把 HOST、PORT、USERNAME、PASSWORD 换成「我的资产」里的值。

查看网站看到的 IP

curl -x http://USERNAME:PASSWORD@HOST:PORT https://ipinfo.io/json

把 HOST、PORT、USERNAME、PASSWORD 换成「我的资产」里的值。

常见错误

• Copilot 启动时出现 read ETIMEDOUT 或 read ECONNRESET。 GitHub 点出两个常见原因:代理地址以 https:// 开头(不支持),以及认证问题。请改用 http://,并重新核对用户名和密码。

• 代理有响应但登录失败。 从「我的资产」重新复制数据,并检查百分号编码。本文所用的 GitHub 页面没有点名 407 错误。

• 出现 unable to verify the first certificate 之类的证书提示。 按上文把代理证书加入操作系统信任库,或设置 NODE_EXTRA_CA_CERTS;关闭校验只是最后手段。

• curl 超时。 代理没有在该端口响应,或 IP 租约已到期。

• 公司代理。 GitHub 说代理服务器或防火墙的管理员也需要为 Copilot 配置网络设置。

用 Proxy302 怎么做

静态住宅 ISP 代理适合 Copilot:每位开发者在整个租期内用同一个固定地址,购买时选择 HTTP 即可。GitHub Copilot 代理设置一页有详细说明和现成预设,产品本身见静态住宅(ISP)代理。

用 Proxy302 怎么做:步骤

  1. 第 1 步

    打开静态住宅 ISP 页面,选择国家,把「协议」设为 HTTP,再选「租期」和「数量」,然后点击「确认费用并生成」。

  2. 第 2 步

    打开「我的资产」并复制 HOST、PORT、USERNAME 和 PASSWORD。「连接工具」页里有填好你自己连接信息的现成示例。HTTP 端口为 2222。

  3. 第 3 步

    把 HTTP 地址填进 VS Code 的 Proxy 框,或填进 JetBrains HTTP Proxy 页面的主机、端口和 Proxy authentication,然后重启编辑器。

  4. 第 4 步

    用 curl 请求 GitHub 的 ping 地址,然后登录并试用 Copilot。

价格与限制

静态住宅 ISP IP 的价格是一天 US$0.50、30 天 US$7.99,约合每天 US$0.27,各国价格一致。各国的库存每天都会变化,以下单页面为准。没有免费试用,最小购买量是 1 个 IP、1 天。

常见问题

Copilot 该选 HTTP 还是 SOCKS5?

HTTP。GitHub 说只支持基本的 HTTP 代理,VS Code 文档说 SOCKS5 的认证尚未实现。

能用 https:// 开头的代理地址吗?

不能。GitHub 的网络页面说以 https:// 开头的代理地址目前不支持。请把地址写成 http://。

VS Code 和 JetBrains 用同一个设置吗?

不是,各有各的字段:VS Code 设置里的 Proxy 框,JetBrains 的 HTTP Proxy 页面。环境变量是两者共用的备选。

代理会让 Copilot 在我所在的国家可用吗?

不会。代理只改变网络出口,GitHub 的条款和贸易管制规则依然适用。

参考资料

7
  1. GitHub 文档:Configuring network settings for GitHub Copilot

    官方文档 · 确认日期:

    2026 年 11 月 2 日阅读:VS Code 路径(File → Preferences → Settings → Application → Proxy)、Proxy Strict SSL、把凭据写进地址的基本认证、JetBrains 路径(Settings → Appearance & Behavior → System Settings → HTTP Proxy)、Proxy authentication、明文存储警告,以及证书相关设置。

    该页没有写出 http.proxy 键名,也没有列出需要放行的网址。

  2. GitHub 文档:Network settings for GitHub Copilot

    官方文档 · 确认日期:

    2026 年 11 月 2 日阅读:环境变量顺序(HTTPS_PROXY、https_proxy、HTTP_PROXY、http_proxy)、只支持基本的 HTTP 代理、不支持 https:// 代理地址、基本认证与 Kerberos、操作系统信任库和 NODE_EXTRA_CA_CERTS。

    该页没有提到 SOCKS,也没有测试命令。

  3. GitHub 文档:Troubleshooting network errors for GitHub Copilot

    官方文档 · 确认日期:

    2026 年 11 月 2 日阅读:对 https://copilot-proxy.githubusercontent.com/_ping 和 https://api.githubcopilot.com/_ping 的 curl 检查、证书提示与处理办法、ETIMEDOUT 和 ECONNRESET 这两种代理错误。

    该页没有提到 http.proxy 或 407 错误。

  4. GitHub 文档:Copilot allowlist reference

    官方文档 · 确认日期:

    2026 年 11 月 2 日阅读:GitHub.com 需放行的网址表,包括 github.com、api.github.com/copilot_internal、copilot-proxy.githubusercontent.com 和 *.githubcopilot.com。

  5. GitHub 文档:GitHub and trade controls

    官方文档 · 确认日期:

    2026 年 11 月 2 日阅读:使用 GitHub 受美国出口管制和制裁法律约束;GitHub Copilot 不提供给被禁运的目的地。

  6. Visual Studio Code 文档:Network Connections

    官方文档 · 确认日期:

    2026 年 11 月 2 日阅读:存在 http.proxy、http.proxyStrictSSL 和 http.proxyAuthorization 设置(VS Code 说它们只在部分场景下生效,且扩展尚未获得同样的代理支持),带认证的代理(Basic、Digest、NTLM、Negotiate),以及 SOCKS5 认证尚未实现。

  7. Proxy302 产品事实与价格表

    产品观察 · 确认日期:

    站点的产品事实表(数值已于 2026 年 10 月 18-19 日对照控制台、后端和价格表核对):产品、美元价格(1 PTC = 1 美元)、租期、协议与端口、国家数、数量上限、没有免费试用。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。