---
title: "Mac 上的“curl: (7) Failed to connect”· Kilobat 指南"
url: "https://kilobat.app/zh-hans/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-hans/guides/curl-7-failed-to-connect.md，并和我一起逐步处理。如果缺少 Kilobat CLI，请安装：brew install seifip/kilobat/kilobat。请你自己运行指南中的终端和 kilobat 检查，并告诉我发现了什么。列出只有我才能完成的步骤。更改任何设置之前先问我。

适用于：所有当前 macOS 版本上 macOS 自带的 curl 和 Homebrew 版 curl。 · 核查日期：2026年10月29日

## 症状

- “终端”显示 `curl: (7) Failed to connect to host port 443`。
- 文字中常常还有“Couldn't connect to server”或“Connection refused”。
- 脚本和安装程序以退出码 7 停止。

## 可能的原因

- **端口上没有任何程序在监听。**服务已停止，或者使用了其他端口。
- **防火墙或代理。**防火墙可能会拒绝连接。设置了代理但无法访问时，curl 也会失败。
- **地址不对。**URL 中的主机或端口有误。脚本中的变量也可能是空的。
- **IPv6 或 VPN 路由。**curl 可能尝试了网络无法到达的地址。

## 如何检查

1. 打印出确切的 URL，检查主机和端口。
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-hans/guides/recipes/why-cant-it-connect)。

## 常见问题

**退出码 7 表示主机已宕机吗？**

不一定。curl 无法连接到主机或代理。用 `curl -v` 查明是哪一个。

**它与 (6) 有什么区别？**

退出码 6 表示主机名没有解析。7 表示连接失败。参见[Mac 上的“curl: (6) Could not resolve host”](https://kilobat.app/zh-hans/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-hans/guides/curl-could-not-resolve-host): curl 退出码 6 表示 curl 无法获取主机名对应的地址。
- [Mac 上 Chrome 中的 ERR_CONNECTION_REFUSED](https://kilobat.app/zh-hans/guides/err-connection-refused): ERR_CONNECTION_REFUSED 是 Chrome 的网络错误。
- [Mac 上 Homebrew 失败并提示“curl: (28)”](https://kilobat.app/zh-hans/guides/homebrew-curl-28-timed-out): Homebrew 通过 curl 下载。
- [Mac 上代理设置导致 App 无法连接](https://kilobat.app/zh-hans/guides/proxy-settings-breaking-apps): 代理设置会让流量经由另一台服务器转发。
