Mac 上的「Could not connect to the server」(NSURLErrorDomain -1004)

App 找到了伺服器的位址,但連線沒有開啟。伺服器拒絕了它,或路徑上有東西阻擋。

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

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

適用於:macOS 13 Ventura 以上版本。文字已在 macOS 27.2 的 CFNetwork 中核對。檢查日期:2026年10月29日

症狀

  • App 顯示「Could not connect to the server.」以及錯誤 -1004。
  • 「主控台」或記錄顯示 NSURLErrorDomain Code=-1004。
  • Safari 顯示類似的訊息「can’t connect to the server」。

可能原因

  • 伺服器已停機或沒有在監聽。該連接埠沒有任何東西接受連線。
  • 本機伺服器沒有執行。對於 localhost,你自己的伺服器必須在執行。請參閱 Mac 上的連接埠已被使用。
  • 防火牆、過濾器、VPN 或代理伺服器。有東西阻擋了連接埠或主機。
  • 位址或連接埠錯誤。App 使用了舊的網址。

如何檢查

  1. 用 5 秒逾時測試連接埠。

    nc -vz -G 5 example.com 443
  2. 請求該網頁,並顯示連線的每個步驟。

    curl -v -o /dev/null https://example.com
  3. 對於本機位址,查看是什麼在該連接埠上監聽。

    lsof -nP -iTCP:3000 -sTCP:LISTEN

如何修正

  1. 在另一部裝置上打開同一個位址。如果那裡也失敗,原因就在伺服器或網路。

  2. 啟動本機伺服器,並使用它印出的連接埠。

  3. 暫時關閉 VPN、代理伺服器或過濾器來測試,之後再重新開啟。

  4. 檢查 App 中的網址,確認主機和連接埠正確。

  5. 稍後再試。忙碌的伺服器可能會恢復。

使用 Kilobat

  1. 一次檢查 Wi-Fi、路由器、網際網路、DNS 和登入頁面。

    kilobat diagnose
  2. 如果是某個網站或服務失敗,找出擋住它的環節。

    kilobat why example.com
  3. CLI 是免費的。在 App 中,這些檢查提供的建議屬於 Kilobat Pro。請參閱找出某個網站或 API 連不上的原因。

常見問題

-1004 和 -1001 有什麼不同?

-1004 是連線被拒絕或被阻擋。-1001 是逾時。請參閱 Mac 上的「The request timed out.」。

為什麼 localhost 會出現 -1004?

該連接埠沒有任何東西在監聽,或伺服器監聽的是另一個位址。

資料來源

  • CFNetwork.framework 中的錯誤文字,macOS 27.2(Localizable.loctable)
  • curl(1) 和 nc(1),隨 macOS 27.2 安裝的使用手冊頁面

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