本文根據 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 條評論
還沒有評論,來搶沙發~