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 连不上的原因。

常见问题

退出码 7 表示主机已宕机吗?

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

它与 (6) 有什么区别?

退出码 6 表示主机名没有解析。7 表示连接失败。参见Mac 上的“curl: (6) Could not resolve host”。

参考资料

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