本文根据 GitHub 官方文档《Troubleshooting network errors for GitHub Copilot》和《Copilot allowlist reference》整理,资料核对于 2026-10-31。说的是编辑器里的 GitHub Copilot,不是 Windows 里的 Copilot 应用。配图为本站整理的示意图,不是软件截图。
适用于谁
- 在 VS Code、JetBrains 等编辑器里用 GitHub Copilot,提示 could not connect to server、read ETIMEDOUT、read ECONNRESET 的人;
- 在公司网络下用 Copilot,被证书错误挡住的人。
结论先说
- 官方文档说:如果你在公司设备上、通过 VPN 或 HTTP 代理访问网络,这类网络设置可能阻止 Copilot 连接 GitHub 的服务器;防火墙也可能干扰。
- 官方推荐先用 curl 测连通性:请求
https://copilot-proxy.githubusercontent.com/_ping,能连上会收到 HTTP 200。Chat 单独有问题,就改测https://api.githubcopilot.com/_ping。 - 典型报错:
GitHub Copilot could not connect to server. Extension activation failed: "read ETIMEDOUT" or "read ECONNRESET",官方说可能由一系列网络问题引起。 - 代理相关三点:代理地址以 https:// 开头目前不支持;需要认证时支持基本认证或 Kerberos;Copilot 可能拒绝自定义证书。
- 证书类报错(certificate signature failure、unable to verify the first certificate 等)通常是公司代理拦截并检查加密流量造成的,找 IT 处理。

图:本站根据 GitHub Docs:网络错误排查 整理的示意图
一、先用 curl 测一下

图:本站根据 GitHub Docs:网络错误排查 整理的示意图
- 打开命令行;
- 运行
curl --verbose https://copilot-proxy.githubusercontent.com/_ping,加--verbose能看到更多信息,方便发给 IT 或 GitHub 支持; - 返回 HTTP 200 说明这条路是通的;
- 如果是 Copilot Chat 有问题,用
https://api.githubcopilot.com/_ping再测一次; - 如果你走代理,用
-x指定代理地址再测一次,对比有无代理的差异; - 官方说,如果出现与「证书吊销」相关的错误,可以加
--insecure重试,但这只用来判断问题出在证书上,不应作为长期做法。
curl 帮不上忙的时候,官方建议在编辑器里开启详细日志,把日志给公司 IT 或 GitHub 支持。
二、代理问题
官方说明:GitHub Copilot 用自定义代码连接代理,所以编辑器支持的代理设置不一定被 Copilot 支持。常见原因:
| 情况 | 官方说明 |
|---|---|
代理 URL 以 https:// 开头 | 目前不支持 |
| 代理需要认证 | 支持基本认证或 Kerberos;用 Kerberos 要确保有有效票据且服务主体名称正确 |
| 自定义证书 | Copilot 可能拒绝,见下节 |
| 公司代理 | 公司还需要在公司层面为 Copilot 配置代理设置,见白名单参考 |
配置方法官方有单独页面「Configuring network settings for GitHub Copilot」,需要时到那里查看。本文不提供绕过公司网络策略的方法,改代理前请先问 IT。
三、证书错误
遇到 certificate signature failure、custom certificate、unable to verify the first certificate 之类的提示,官方给的处理方向:
- 换一个不拦截加密连接的代理;
- 如果是公司代理,联系 IT,看能否配置为不拦截;
- 确认自定义证书已正确安装到操作系统的信任库。官方说明 Copilot 查找证书的方式:Windows 用 win-ca 包,macOS 用 mac-ca 包,Linux 检查标准的 OpenSSL 文件
/etc/ssl/certs/ca-certificates.crt和/etc/ssl/certs/ca-bundle.crt; - 让 Copilot 忽略证书错误:VS Code 里取消 Proxy Strict SSL,JetBrains 里选择 Accept non-trusted certificates automatically。官方警告这会带来安全问题,不建议;
- 如果是安全软件监控了加密流量,需要为你的编辑器或 Copilot 扩展配置例外,具体方法问安全软件厂商。
四、公司网络的放行清单
官方白名单参考里,需要允许的域名包括:github.com/login/(认证)、api.github.com/copilot_internal/、copilot-proxy.githubusercontent.com、origin-tracker.githubusercontent.com,以及 .githubcopilot.com(若用基于订阅的网络路由,则按套餐用 .individual、.business、.enterprise 对应域名)。推荐用 gh api meta 查询通配域名。详细对照见 /guides/github-copilot-language-model-unavailable。
常见问题
Q:个人电脑没有代理,也提示连不上?
先看 githubstatus.com 有没有 Copilot 事件,再用 curl 测,通了就重启编辑器;如果是登录问题,在编辑器里重新登录 GitHub 账号。安装与登录步骤见 /guides/github-copilot-vscode-setup,JetBrains 见 /guides/github-copilot-jetbrains-idea-plugin。
Q:这和 Windows 里的 Copilot 是一回事吗?
不是。Windows 里的是微软的聊天应用,见 /guides/microsoft-copilot-official-entry-download。
Q:想换用别的 AI 编程工具?
对比见 /guides/ai-coding-tools-codex-claude-code-cursor-gemini;ChatGPT 会员见 /chongzhi/chatgpt-plus。
参考资料
- GitHub Docs:Troubleshooting network errors for GitHub Copilot — https://docs.github.com/en/copilot/troubleshooting-github-copilot/troubleshooting-network-errors-for-github-copilot
- GitHub Docs:Copilot allowlist reference — https://docs.github.com/en/copilot/reference/copilot-allowlist-reference
更多 AI 会员开通可看 /chongzhi。
0 条评论
还没有评论,来抢沙发~