Mac 上的「curl: (7) Failed to connect」

curl 結束代碼 7 表示某個步驟失敗。curl 文件寫道:「Failed to connect() to host or proxy.」

讓你的代理程式來解決拷貝一則提示詞,適用於 Claude Code、Codex 或任何能使用終端機的代理程式。

我的 Mac 出現了這個問題:Mac 上的「curl: (7) Failed to connect」。請閱讀 https://kilobat.app/zh-hant/guides/curl-7-failed-to-connect.md,並和我一起逐步處理。如果缺少 Kilobat CLI,請安裝:brew install seifip/kilobat/kilobat。請你自己執行指南中的終端機和 kilobat 檢查,並告訴我發現了什麼。列出只有我才能完成的步驟。變更任何設定之前先問我。

適用於:macOS 內建的 curl 和 Homebrew 的 curl,所有目前的 macOS 版本。檢查日期:2026年10月29日

症狀

  • 終端機顯示 curl: (7) Failed to connect to host port 443。
  • 訊息後面常加上「Couldn't connect to server」或「Connection refused」。
  • 腳本和安裝程式以結束代碼 7 停止。

可能原因

  • 連接埠沒有任何服務在監聽。服務已停止,或使用了其他連接埠。
  • 防火牆或代理伺服器。防火牆可能拒絕連線。如果設定了代理伺服器但連不上,curl 也會失敗。
  • 位址錯誤。網址中的主機或連接埠有誤。腳本中的變數可能是空的。
  • IPv6 或 VPN 路由。curl 可能嘗試了網路無法連上的位址。

如何檢查

  1. 印出完整的網址,檢查主機和連接埠。

  2. 用詳細模式執行 curl。最前面幾行會顯示失敗的位址。

    curl -v https://example.com
  3. 測試連接埠。

    nc -vz example.com 443
  4. 顯示代理伺服器環境變數。

    env | grep -i proxy

如何修正

  1. 如果服務是你的,請啟動它,並使用它印出的連接埠。

  2. 強制使用 IPv4,以測試是否為 IPv6 的問題。

    curl -4 -v https://example.com
  3. 取消錯誤的代理伺服器設定。

    unset https_proxy http_proxy
  4. 暫時關閉 VPN 來測試,之後再重新開啟。

使用 Kilobat

  1. Kilobat 的連線診斷會逐層測試位址:網路、代理伺服器、DNS、規則、IPv4、IPv6、TLS 和伺服器。它會指出失敗的那一層。

    kilobat why https://example.com
  2. 這些 Kilobat 檢查都是免費的。AI 代理程式可透過 MCP 以 diagnose_connection 和 diagnose_network 執行。請參閱找出某個網站或 API 連不上的原因。

常見問題

結束代碼 7 表示主機已停機嗎?

不一定。curl 無法連上主機或代理伺服器。用 curl -v 找出是哪一個。

和 (6) 有什麼不同?

結束代碼 6 表示主機名稱無法解析。代碼 7 表示連線失敗。請參閱 Mac 上的「curl: (6) Could not resolve host」。

資料來源

查核日期:2026 年 10 月 29 日。