---
title: "Mac 上的 Could not connect to the server（NSURLErrorDomain -1004）· Kilobat 指南"
url: "https://kilobat.app/zh-hans/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-hans/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-hans/guides/port-already-in-use)。
- **防火墙、过滤器、VPN 或代理。**有设备阻止了该端口或主机。
- **地址或端口不对。**App 使用了旧的 URL。

## 如何检查

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 中的 URL 主机和端口是否正确。
5. 稍后再试。繁忙的服务器可能会恢复。

## 使用 Kilobat

1. 一步检查 Wi-Fi、路由器、互联网、DNS 和登录页面。

   ```
   kilobat diagnose
   ```
2. 如果某个网站或服务连不上，找出阻断它的环节。

   ```
   kilobat why example.com
   ```
3. CLI 免费。在 App 中，这些检查给出的建议属于 Kilobat Pro。请参阅[找出某个网站或 API 连不上的原因](https://kilobat.app/zh-hans/guides/recipes/why-cant-it-connect)。

## 常见问题

**-1004 与 -1001 有什么不同？**

-1004 是连接被拒绝或被阻止。-1001 是超时。参见[Mac 上的“The request timed out.”](https://kilobat.app/zh-hans/guides/request-timed-out)。

**为什么 localhost 会出现 -1004？**

该端口上没有任何程序在监听，或者服务器监听的是另一个地址。

## 参考资料

- CFNetwork.framework 中的错误文字，macOS 27.2（Localizable.loctable）
- curl(1) 和 nc(1)，macOS 27.2 自带的 man 手册页

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

## 相关指南

- [Mac 上提示“Safari 浏览器无法连接服务器”](https://kilobat.app/zh-hans/guides/safari-cant-connect-to-server): Safari 浏览器找到了网站的地址，但无法与服务器建立连接。
- [Mac 上端口已被占用](https://kilobat.app/zh-hans/guides/port-already-in-use): 一个 TCP 端口和地址只能由一个进程监听。
- [Mac 上提示“请求超时。”（The request timed out.）](https://kilobat.app/zh-hans/guides/request-timed-out): 这是 macOS 中错误 -1001 的提示文字。
- [Mac 上代理设置导致 App 无法连接](https://kilobat.app/zh-hans/guides/proxy-settings-breaking-apps): 代理设置会让流量经由另一台服务器转发。
- [Mac 上的 IPv6 问题](https://kilobat.app/zh-hans/guides/ipv6-problems-mac): 大多数网络会同时为 Mac 分配 IPv4 和 IPv6 地址。
