GitHub Copilot 提示无法连接到服务怎么办:could not connect to server、ETIMEDOUT、证书错误的官方排查办法

Copilot 提示 could not connect to server、read ETIMEDOUT 或证书错误,多与代理、防火墙有关。本文按 GitHub 官方网络错误排查文档,讲 curl 测连通性、代理与认证限制、证书错误处理和公司网络放行清单。

NNathaniel bigo··原创首发·AI 辅助撰写
10 分钟读完
资料核对于 2026-10-31 · 依据官方文档与公开资料整理 免费账号 账号
本文根据 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,被证书错误挡住的人。

结论先说

  1. 官方文档说:如果你在公司设备上、通过 VPN 或 HTTP 代理访问网络,这类网络设置可能阻止 Copilot 连接 GitHub 的服务器;防火墙也可能干扰。
  2. 官方推荐先用 curl 测连通性:请求 https://copilot-proxy.githubusercontent.com/_ping,能连上会收到 HTTP 200。Chat 单独有问题,就改测 https://api.githubcopilot.com/_ping。
  3. 典型报错:GitHub Copilot could not connect to server. Extension activation failed: "read ETIMEDOUT" or "read ECONNRESET",官方说可能由一系列网络问题引起。
  4. 代理相关三点:代理地址以 https:// 开头目前不支持;需要认证时支持基本认证或 Kerberos;Copilot 可能拒绝自定义证书。
  5. 证书类报错(certificate signature failure、unable to verify the first certificate 等)通常是公司代理拦截并检查加密流量造成的,找 IT 处理。

Copilot 无法连接:按报错对照

图:本站根据 GitHub Docs:网络错误排查 整理的示意图

一、先用 curl 测一下

用 curl 测一下能不能连上

图:本站根据 GitHub Docs:网络错误排查 整理的示意图

  1. 打开命令行;
  2. 运行 curl --verbose https://copilot-proxy.githubusercontent.com/_ping,加 --verbose 能看到更多信息,方便发给 IT 或 GitHub 支持;
  3. 返回 HTTP 200 说明这条路是通的;
  4. 如果是 Copilot Chat 有问题,用 https://api.githubcopilot.com/_ping 再测一次;
  5. 如果你走代理,用 -x 指定代理地址再测一次,对比有无代理的差异;
  6. 官方说,如果出现与「证书吊销」相关的错误,可以加 --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 之类的提示,官方给的处理方向:

  1. 换一个不拦截加密连接的代理;
  2. 如果是公司代理,联系 IT,看能否配置为不拦截;
  3. 确认自定义证书已正确安装到操作系统的信任库。官方说明 Copilot 查找证书的方式:Windows 用 win-ca 包,macOS 用 mac-ca 包,Linux 检查标准的 OpenSSL 文件 /etc/ssl/certs/ca-certificates.crt 和 /etc/ssl/certs/ca-bundle.crt;
  4. 让 Copilot 忽略证书错误:VS Code 里取消 Proxy Strict SSL,JetBrains 里选择 Accept non-trusted certificates automatically。官方警告这会带来安全问题,不建议;
  5. 如果是安全软件监控了加密流量,需要为你的编辑器或 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。

Nathaniel 的更多内容

  1. 01

    Microsoft Copilot 官网入口在哪、怎么下载:网页版、Windows 应用、手机应用和工作账号入口怎么选

    Microsoft Copilot 有网页版、Windows 应用、手机应用,工作或学校账号还有单独入口。本文按微软支持页面讲清各入口、各自支持的登录账号、Windows 应用从 Microsoft Store 下载,以及怎么区分微软的 Copilot 和 GitHub Copilot。

    其他 AI 工具0
  2. 02

    GitHub Copilot 报错「Language model unavailable」怎么办:VS Code 团队说的头号原因,以及怎么收集诊断信息

    VS Code 里 Copilot Chat 提示 Language model unavailable,官方没有单独说明。本文按 VS Code 团队的说法讲头号原因(公司防火墙没放行新端点)、怎么看 Failed to fetch models、运行 Chat Diagnostics。

    GitHub Copilot0
  3. 03

    Windows 里的 Copilot 是什么软件、能卸载吗、怎么关闭:卸载路径、Copilot 键和 Win+C 的处理,公司电脑怎么管

    Windows 11 新电脑上的 Copilot 是微软的 AI 助手应用,可以卸载。本文按微软官方文档讲清它是什么、卸载路径、不想被 Copilot 键或 Win+C 唤起怎么改、卸载后怎么装回来,以及公司电脑上 IT 管理员的 AppLocker 和 PowerShell 做法。

    其他 AI 工具0
  4. 04

    Cursor 报错「User is unauthorized」怎么办:官方员工给的排查顺序,以及怎么取到 Request ID 反馈

    Cursor 里发消息时提示 User is unauthorized,官方帮助中心没有单独说明。本文整理官方论坛里员工的回复:先检查有没有自定义 Base URL、退出重新登录并完全重启,仍不行就用 Report AI Action 取新的 Request ID 反馈;邮箱域名被拦截的情况官方怎么说。

    Cursor0
  5. 05

    Cursor 登录提示「Can't verify the user is human」怎么办:人机验证失败的常见原因,以及登录域名迁移后的放行清单

    Cursor 登录时提示无法验证用户为真人,官方帮助中心没有这条报错的专门说明。本文整理官方论坛里反馈的常见情形(拦截人机验证请求、密码管理器自动点继续、换浏览器),并按官方帮助页说明 Cursor 登录页正迁移到 accounts.spacex.ai 与 accounts.x.ai,公司网络需要放行。

    Cursor0
  6. 06

    智谱 GLM Coding Plan 是什么:Lite、Pro、Max 三档积分额度、5 小时与每周限额、能在哪些工具用、退款和取消

    GLM Coding Plan 是智谱推出的编程订阅套餐,按积分计量,设每 5 小时和每周两层上限。本文按智谱开放文档讲清 Lite、Pro、Max 的积分额度、非高峰时段 50% 抵扣、可用模型与工具、哪些场景不能用套餐额度,以及取消续费、退款政策和账号规范。

    其他 AI 工具0

同产品的其他教程

  1. 01

    copilot-instructions.md 怎么写:用途、范例、按路径生效的 instructions 文件与 AGENTS.md 的区别

    copilot-instructions.md 是什么、放哪、怎么写?按 GitHub 官方文档讲清仓库级指令、.github/instructions 下按路径生效的 *.instructions.md(applyTo / excludeAgent)、AGENTS.md 三者的分工,附可改写的中文范例与不生效排查。

    GitHub Copilot0
  2. 02

    GitHub Copilot CLI 安装与使用:npm / winget / brew 安装、登录、常用指令与工具权限

    GitHub Copilot CLI 怎么安装、怎么用?按官方文档讲清三种安装方式(npm 需 Node.js 22+)、/login 登录与令牌登录、交互模式常用快捷键、copilot -p 非交互调用,以及 --allow-tool / --deny-tool 工具权限的写法。

    GitHub Copilot0
  3. 03

    用 AI 读代码:快速看懂陌生代码库的提问顺序与 20 个可复制问题

    接手陌生项目怎么用 AI 读代码?按 GitHub Copilot 与 Cursor 官方教程整理出从整体到细节的五轮提问:项目概览、入口与构建、数据流、定位具体功能、画架构图;讲清精确搜索与按含义搜索的区别,附 20 个可复制的问题。

    GitHub Copilot其他 AI 工具0
  4. 04

    GitHub Copilot Code Review 怎么用:PR 里请求审查、自动审查、审查力度与自定义指令

    GitHub Copilot 代码审查教程:在 PR 的 Reviewers 里点 Request、应用建议与 Fix with Copilot、开启自动审查、Lite / Balanced 两档审查力度、用 instructions 定制审查重点、哪些文件不审,以及计费方式,按 GitHub 官方文档整理。

    GitHub Copilot0
  5. 05

    Copilot Skills 是什么、怎么用:VS Code 里的 Agent Skills 目录、字段与调用

    GitHub Copilot 的 Skills 放在哪个文件夹、怎么创建和调用?按 VS Code 官方文档讲清 .github/skills 等六个技能目录、SKILL.md 的字段、/ 斜杠调用与自动加载的四种组合、和自定义指令的区别,以及使用别人分享的技能前要做的检查。

    GitHub Copilot0
  6. 06

    GitHub Copilot 学生认证怎么申请:GitHub Education 条件、材料、激活 Copilot Student 与常见卡点

    GitHub Copilot 学生认证官方流程:谁有资格、要准备什么证明材料、学校邮箱的三种情况、在 Education benefits 页提交申请、通过后怎么激活 Copilot Student、它和 Pro 的区别,以及通过了却仍显示 Free 或付费页时怎么办。

    GitHub Copilot0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~