---
title: "Mac 上的 Could not connect to the server（NSURLErrorDomain -1004）· Kilobat 指南"
url: "https://kilobat.app/zh-hant/guides/nsurl-error-1004-could-not-connect-to-the-server"
description: "App 顯示 Could not connect to the server，NSURLErrorDomain 錯誤 -1004。找出是伺服器、防火牆還是代理伺服器拒絕了你。"
---

# 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 上的連接埠已被使用](https://kilobat.app/zh-hant/guides/port-already-in-use)。
- **防火牆、過濾器、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 連不上的原因](https://kilobat.app/zh-hant/guides/recipes/why-cant-it-connect)。

## 常見問題

**-1004 和 -1001 有什麼不同？**

-1004 是連線被拒絕或被阻擋。-1001 是逾時。請參閱 [Mac 上的「The request timed out.」](https://kilobat.app/zh-hant/guides/request-timed-out)。

**為什麼 localhost 會出現 -1004？**

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

## 資料來源

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

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

## 相關指南

- [Mac 上的「Safari 無法連接伺服器」](https://kilobat.app/zh-hant/guides/safari-cant-connect-to-server): Safari 找到了網站的位址，但無法與伺服器建立連線。
- [Mac 上的連接埠已被占用](https://kilobat.app/zh-hant/guides/port-already-in-use): 同一個 TCP 連接埠和位址只能有一個處理程序在監聽。
- [Mac 上的「要求已逾時。」](https://kilobat.app/zh-hant/guides/request-timed-out): 這是 macOS 對錯誤 -1001 顯示的文字。
- [代理伺服器設定讓 Mac 上的 App 無法連線](https://kilobat.app/zh-hant/guides/proxy-settings-breaking-apps): 代理伺服器設定會讓流量經由另一台伺服器傳送。
- [Mac 上的 IPv6 問題](https://kilobat.app/zh-hant/guides/ipv6-problems-mac): 大多數網路都會同時提供 IPv4 和 IPv6 位址給 Mac。
