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 條評論

登入 後參與評論

還沒有評論,來搶沙發~