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 檢查,並告訴我發現了什麼。列出只有我才能完成的步驟。變更任何設定之前先問我。
症狀
- App 顯示「Could not connect to the server.」以及錯誤 -1004。
- 「主控台」或記錄顯示 NSURLErrorDomain Code=-1004。
- Safari 顯示類似的訊息「can’t connect to the server」。
可能原因
- 伺服器已停機或沒有在監聽。該連接埠沒有任何東西接受連線。
- 本機伺服器沒有執行。對於
localhost,你自己的伺服器必須在執行。請參閱 Mac 上的連接埠已被使用。 - 防火牆、過濾器、VPN 或代理伺服器。有東西阻擋了連接埠或主機。
- 位址或連接埠錯誤。App 使用了舊的網址。
如何檢查
用 5 秒逾時測試連接埠。
nc -vz -G 5 example.com 443請求該網頁,並顯示連線的每個步驟。
curl -v -o /dev/null https://example.com對於本機位址,查看是什麼在該連接埠上監聽。
lsof -nP -iTCP:3000 -sTCP:LISTEN
如何修正
在另一部裝置上打開同一個位址。如果那裡也失敗,原因就在伺服器或網路。
啟動本機伺服器,並使用它印出的連接埠。
暫時關閉 VPN、代理伺服器或過濾器來測試,之後再重新開啟。
檢查 App 中的網址,確認主機和連接埠正確。
稍後再試。忙碌的伺服器可能會恢復。
使用 Kilobat
一次檢查 Wi-Fi、路由器、網際網路、DNS 和登入頁面。
kilobat diagnose如果是某個網站或服務失敗,找出擋住它的環節。
kilobat why example.comCLI 是免費的。在 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 日。