jichangmom.mom机场测评与选购指南 · 机场推荐

AI 工具AI 工具 · 约 11 分钟

GitHub Copilot 网络设置:编辑器设置、证书与排查

GitHub Copilot 网络设置:Copilot 连不上,先别急着换节点。它是编辑器里的插件,请求从编辑器发出,所以关键是编辑器有没有把请求交给代理。VS Code 看 http.proxy,JetBrains 看 IDE 的 HTTP 代理设置,嫌麻烦就开 TUN。公司电脑还要多考虑一层:代理认证和证书。

GitHub Copilot 网络设置,先说结论:代理要设在编辑器这一层

GitHub Copilot 不是一个独立的程序,而是装在编辑器里的插件。它发出的请求属于编辑器进程,所以“浏览器能上 GitHub”说明不了 Copilot 一定能连上。让 Copilot 走代理,有三种层级可选:

个人电脑上,TUN 最省事;不方便开 TUN 的,按编辑器分别设置。公司电脑上,第一步不是动手配置,而是弄清公司的网络规定,这一点后面单独讲。

GitHub 和 Copilot 有自己的服务范围和使用条款,是否可以使用、如何订阅和付费,以 GitHub 官方说明为准,请遵守其条款;在公司网络里使用,还要遵守公司的规定。

本文只讲网络配置,账号和付款问题不在本文范围。

Copilot 在连哪些地方

Copilot 的一次补全或一次对话,大致要经过三类地址:GitHub 本身(登录和身份验证)、Copilot 的服务接口、以及插件更新和遥测等辅助地址。

从代理客户端的连接页看,常见的后缀有 github.com、githubcopilot.com、githubusercontent.com,完整清单以你在连接页里实际看到的和 GitHub 官方文档为准。

这三类地址要落在同一个出口上。常见的失败形态是:GitHub 本身被规则送去了代理,Copilot 的接口却漏在直连里,于是登录成功、补全却一直转圈。

和 Cursor 类似,Copilot 的流量也有两种形态:

所以给 Copilot 选节点,延迟和稳定比带宽重要得多。

VS Code 里的设置

VS Code 的网络设置对所有扩展生效,Copilot 也在其中。

  1. 先试系统代理代理客户端打开系统代理,完全退出 VS Code 再打开。VS Code 默认会参考系统的代理设置,很多人到这一步就能用了。
  2. 不行就明确填写打开设置,搜索 proxy,在 http.proxy 里填写本地代理地址,比如 http://127.0.0.1:7897,端口以你的客户端显示为准。
  3. 保持证书校验同一组里的 http.proxyStrictSSL 保持开启,不要为了消除报错而关掉它。
  4. 重启编辑器让所有扩展都用上新设置。
  5. 核对连接触发一次补全、发一次对话,到代理客户端的连接页里确认出现了 Copilot 相关的连接,并且命中的是你指定的策略组。

两点提醒:http.proxy 写死了本地端口,代理客户端关掉时 Copilot 会完全连不上;VS Code 的内置终端不读这项设置,终端里的命令要另外设置环境变量,见 Codex CLI 终端代理。

基于 VS Code 的其他编辑器设置方法相同,Cursor 的情况见 Cursor 网络设置。

远程开发的情况

用远程开发功能连到服务器、容器或 WSL 时,有些扩展运行在远程那一侧。

运行在远程的扩展,网络环境就是远程机器的,本机的代理设置不一定能传过去。

遇到“本地打开项目 Copilot 正常、连上服务器就不行”,先确认 Copilot 是在哪一侧运行的。

JetBrains 系 IDE 里的设置

IntelliJ IDEA、PyCharm、GoLand 等 JetBrains 系 IDE 有一个统一的 HTTP 代理设置,Copilot 插件跟随它。

  1. 打开代理设置在设置里找到 Appearance & Behavior 下的 System Settings,里面有 HTTP Proxy。也可以直接在设置的搜索框里输入 proxy。不同版本位置略有不同。
  2. 选择方式可以选自动检测,让 IDE 读取系统代理;更稳妥的是手动配置,类型选 HTTP,主机填 127.0.0.1,端口填代理客户端的本地端口。
  3. 检查连接设置页通常有检查连接的按钮,输入一个地址测试代理是否可用。
  4. 重启 IDE让插件重新建立连接。

JetBrains 的这个设置同样只管 IDE 自身和插件,IDE 里的终端仍然要靠环境变量或 TUN。

TUN 模式:一次覆盖所有编辑器

如果你同时用 VS Code 和 JetBrains,或者还要在终端里跑别的 AI 工具,在每个地方分别设置很容易漏。

TUN 模式把整台电脑的流量收进代理客户端,由规则决定去向,编辑器、插件、终端都不需要知道代理的存在。

对比项编辑器内设置TUN 模式
覆盖范围当前编辑器和它的插件整台电脑
需要系统权限不需要通常需要
多个编辑器每个都要设一次搞定
编辑器内终端不覆盖覆盖
和公司 VPN、公司代理共存容易配合容易冲突

开 TUN 时保持规则模式,并让客户端接管 DNS。具体开法见 Clash Verge Rev 教程,原理见 TUN 模式与系统代理。

无论用哪种方式,都建议建一个手动选择类型的 AI 策略组,把上面提到的 Copilot 相关后缀指向它。

注意 github.com 这个后缀也会影响你平时 clone 代码、打开 GitHub 网页,它们会一起走这个组,通常没有坏处。

公司网络与证书:先理解几个概念

在公司电脑上用 Copilot,网络问题往往不是“没有代理”,而是“已经有一层公司代理”。几个概念先弄明白,再决定怎么做。

公司代理

很多公司的网络要求所有对外请求都经过公司指定的代理服务器。

这时编辑器里的 http.proxy 应该填的是公司提供的地址,而不是你自己装的代理客户端。地址、端口以 IT 部门提供的为准。

代理认证

有的公司代理需要身份验证,可能是用户名密码,也可能是和你的域账号绑定的认证方式。

编辑器和插件对各种认证方式的支持程度不同,遇到反复弹出认证或一直 407 错误时,要找 IT 确认公司代理用的是哪种认证。

HTTPS 检查和公司根证书

为了安全审计,有的公司会在出口处解开 HTTPS 流量检查后再重新加密。

这样一来,你的编辑器收到的证书是公司签发的,而不是 GitHub 的。

如果系统里没有安装公司的根证书,编辑器就会报证书错误。

正确的处理方式是由 IT 部门把公司根证书安装到系统的证书存储里,让编辑器能识别它。

不要用关闭证书校验的方式“解决”问题:那会让任何中间人都能冒充 GitHub,风险远大于一时的不便。

防火墙放行

公司防火墙可能只放行列表里的域名。Copilot 用到的地址不在列表里,就会表现为部分功能可用、部分不可用。

需要放行哪些地址,以 GitHub 官方文档为准,由 IT 部门处理。

公司网络有自己的安全规定。

私自安装代理客户端、开启 TUN 绕过公司代理,可能违反公司制度,也可能和公司的安全软件冲突。

公司电脑上请先和 IT 部门沟通,本文的机场配置方法适用于你自己的个人电脑。

个人电脑上照着做:五步配好

下面是在自己的电脑上从零配好 Copilot 网络的顺序,每一步都确认过再往下走。

  1. 选好节点在代理客户端里建一个手动选择的 AI 策略组,选中一个延迟较低、晚上也稳定的支持地区节点,再备一个同地区的。
  2. 补齐规则把 Copilot 相关的域名后缀指向这个组,规则排在订阅自带规则的前面。
  3. 二选一接入只用一个编辑器、不想开虚拟网卡的,在编辑器里填本地代理地址;同时用多个编辑器、还要让终端也走代理的,开 TUN。不要两种同时折腾。
  4. 重启并登录完全退出编辑器后重新打开,按提示在浏览器里完成 GitHub 授权。
  5. 逐项验证依次试行内补全、对话、在对话里引用当前文件,同时盯着连接页,确认每类请求都命中了 AI 组,没有漏网的直连。

配完之后用上一两天,特别留意晚上八点以后补全出现的频率。

白天和晚上差别很大,说明节点在高峰期吃力,换同地区的备用节点对比一下,比反复改设置更有效。

连接失败怎么排查

排查 Copilot 的第一手资料是它自己的日志。

在 VS Code 里打开“输出”面板,在右上角的下拉列表里选择 Copilot 相关的条目,就能看到每次请求失败的具体原因。

JetBrains 里可以在帮助菜单里找到查看日志的入口。不同版本名称略有不同。

日志或现象网络侧的常见原因先做什么
连接超时、连接被重置请求没进代理,或节点不通看连接页有无 Copilot 连接;换同地区备用节点
证书相关错误公司做了 HTTPS 检查,或代理客户端开了 HTTPS 解密公司电脑找 IT;个人电脑检查客户端是否开了解密功能
407 或反复要求代理认证公司代理需要认证向 IT 确认认证方式
登录成功,补全一直转圈GitHub 走了代理,Copilot 接口漏在直连把 Copilot 相关后缀补进同一策略组
白天正常,晚上补全很少出现晚高峰延迟升高、丢包换延迟更低的节点,见 晚高峰卡
对话回答到一半停住策略组自动切换,或电脑休眠策略组改成手动选择

一次只改一样东西,改完重启编辑器再看日志。

如果日志里能看到明确的权限或账号相关提示,那就不是网络问题,按 GitHub 官方的说明处理。

更一般的“浏览器能上、软件不行”的问题,见 浏览器能上、软件不走代理。

网页、手机和命令行里的 Copilot

Copilot 不只在编辑器里。不同入口走代理的方式不一样,出问题时要先认清是哪一个。

入口请求从哪里发出怎么让它走代理
GitHub 网页上的 Copilot 对话浏览器系统代理即可,注意停用代理扩展
手机上的 GitHub App手机 App手机代理客户端开启,规则模式下相关域名指向 AI 组
命令行工具(如 gh 及其扩展)终端里的程序设置 HTTPS_PROXY 等环境变量,或开 TUN
编辑器插件编辑器进程编辑器的代理设置,或开 TUN

常见的情况是:编辑器里 Copilot 正常,终端里的命令行工具却报连接失败。这和编辑器无关,按终端程序处理,方法见 Claude Code 终端代理。

手机上的配置见 iPhone 怎么用机场 和 安卓怎么用机场。

几件不建议做的事

求助时准备哪些信息

找公司 IT、问机场客服或者到社区提问,把下面几样一次给全,比一句“Copilot 用不了”有用得多:

  1. 环境编辑器名称和版本、Copilot 插件版本、操作系统。
  2. 接入方式用的是系统代理、编辑器里填的代理地址,还是 TUN;公司电脑还要说明公司代理的情况。
  3. 日志原文输出面板里 Copilot 条目下的报错文字,去掉令牌等敏感内容。
  4. 连接页情况Copilot 相关连接命中的规则和节点,有没有漏在直连里的。
  5. 复现条件从什么时候开始、是否只在晚上、换节点或换网络后有没有变化。

换节点能改善的,找机场;公司网络里的证书、认证、防火墙问题,找 IT;账号和订阅权限问题,按 GitHub 官方说明处理。

选机场时看什么

公开资料里标注支持 Copilot 的有 二猫云、唯兔云、TNTCloud、银河云 和 WgetCloud(优质档及以上)。

其中唯兔云、TNTCloud、银河云只支持官方客户端,没法给编辑器填本地端口时,要先问清官方客户端是否提供类似 TUN 的全局接管;二猫云和 WgetCloud 支持通用客户端。

这些都是公开资料标注,需自行验证:买最短周期,在日常写代码的时段用上一周。更多候选见 AI 机场推荐。

一句话:Copilot 的代理设在编辑器里,或者用 TUN 兜底;在公司电脑上,先问 IT。

参考来源

本文涉及的客户端功能、协议和服务规则,以下面的官方文档和项目页面为准:

  1. GitHub Docs:Configuring network settings for GitHub Copilot:在编辑器里为 Copilot 配置代理
  2. GitHub Docs:Troubleshooting network errors for GitHub Copilot:连接失败与证书错误的排查
  3. GitHub Docs:Copilot allowlist reference:Copilot 需要放行的域名
  4. JetBrains 文档:HTTP Proxy 设置:JetBrains IDE 的代理设置

常见问题

GitHub 网页能打开,Copilot 却一直显示连接失败,为什么?

浏览器和编辑器是两个程序。浏览器遵守系统代理,编辑器里的插件不一定遵守。

先在编辑器里明确设置代理,或者打开代理客户端的 TUN 模式,再到客户端的连接页确认出现了 Copilot 相关的连接。

Copilot 登录时卡在授权那一步怎么办?

登录通常要在浏览器里完成 GitHub 授权,再回到编辑器。

浏览器那一侧要能正常打开 GitHub,编辑器那一侧要能连上 GitHub 的接口,两边任何一边没走代理都会卡住。

授权完成后在编辑器里多等一会儿,仍不行就重启编辑器再登录一次。

公司电脑上能不能自己装代理客户端给 Copilot 用?

先看公司规定。很多公司对开发电脑的网络有统一要求,私自安装代理软件或绕过公司代理可能违反制度。

正确的做法是问 IT 部门:公司网络是否允许访问 Copilot,代理地址是什么,需不需要安装公司证书。

提示证书错误,能不能直接关掉证书校验?

不建议。证书校验是确认你连的确实是 GitHub 的唯一手段,关掉之后任何中间人都能冒充。

公司网络里出现证书错误,一般是公司对 HTTPS 流量做了检查,需要把公司的根证书装到系统里,这件事应当由 IT 部门指导完成。

JetBrains 里的 Copilot 和 VS Code 里的配置能共用吗?

不能。两个 IDE 各有各的代理设置,Copilot 插件分别跟随所在的 IDE。如果两个都在用,要么分别设置,要么开 TUN 让两者都不需要单独配置。

用 TUN 的话,记得把 Copilot 相关域名指向同一个手动选择的策略组。

Copilot 需要用特定地区的节点吗?

GitHub 和 Copilot 有自己的服务范围和条款,以官方说明为准。

网络上更重要的是稳定:选一个延迟低、晚高峰不丢包的节点固定使用,策略组用手动选择。

地区之间的取舍见 AI 工具用哪个地区的节点。

编辑器里 Copilot 正常,终端里的命令行工具却连不上?

编辑器的代理设置只管编辑器和插件,终端里的程序看的是环境变量。

在终端里设置 HTTPS_PROXY 等变量指向代理客户端的本地端口,或者开 TUN 模式,然后用 curl 验证一下再用。

个人电脑上没有公司网络,为什么 Copilot 也报证书错误?

检查代理客户端有没有开启 HTTPS 解密或类似的抓包功能,开着时编辑器收到的是客户端自己签发的证书。

关掉这个功能、重启编辑器再试。不要用关闭证书校验的方式处理。

AI 工具里的其他文章

其他栏目