---
title: "Mac 上的 curl: (7) Failed to connect · Kilobat 指南"
url: "https://kilobat.app/zh-hant/guides/curl-7-failed-to-connect"
description: "Mac 上的 curl 以 (7) Failed to connect 停止。請檢查連接埠、服務、防火牆、代理伺服器，以及 curl 嘗試連線的位址。"
---

# 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 連不上的原因](https://kilobat.app/zh-hant/guides/recipes/why-cant-it-connect)。

## 常見問題

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

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

**和 (6) 有什麼不同？**

結束代碼 6 表示主機名稱無法解析。代碼 7 表示連線失敗。請參閱 [Mac 上的「curl: (6) Could not resolve host」](https://kilobat.app/zh-hant/guides/curl-could-not-resolve-host)。

## 資料來源

- [curl：libcurl error codes](https://curl.se/libcurl/c/libcurl-errors.html)

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

## 相關指南

- [Mac 上的「curl: (6) Could not resolve host」](https://kilobat.app/zh-hant/guides/curl-could-not-resolve-host): curl 結束代碼 6 表示 curl 無法取得主機名稱的位址。
- [Mac 版 Chrome 的 ERR_CONNECTION_REFUSED](https://kilobat.app/zh-hant/guides/err-connection-refused): ERR_CONNECTION_REFUSED 是 Chrome 的網路錯誤。
- [Mac 上的 Homebrew 失敗並顯示「curl: (28)」](https://kilobat.app/zh-hant/guides/homebrew-curl-28-timed-out): Homebrew 使用 curl 下載。
- [代理伺服器設定讓 Mac 上的 App 無法連線](https://kilobat.app/zh-hant/guides/proxy-settings-breaking-apps): 代理伺服器設定會讓流量經由另一台伺服器傳送。
