Mac 上的“curl: (7) Failed to connect”
curl 退出码 7 表示某个步骤失败。curl 文档的说法是:“Failed to connect() to host or proxy.”
我的 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 检查,并告诉我发现了什么。列出只有我才能完成的步骤。更改任何设置之前先问我。
症状
- “终端”显示
curl: (7) Failed to connect to host port 443。 - 文字中常常还有“Couldn't connect to server”或“Connection refused”。
- 脚本和安装程序以退出码 7 停止。
可能的原因
- 端口上没有任何程序在监听。服务已停止,或者使用了其他端口。
- 防火墙或代理。防火墙可能会拒绝连接。设置了代理但无法访问时,curl 也会失败。
- 地址不对。URL 中的主机或端口有误。脚本中的变量也可能是空的。
- IPv6 或 VPN 路由。curl 可能尝试了网络无法到达的地址。
如何检查
打印出确切的 URL,检查主机和端口。
用详细信息运行 curl。前几行会显示失败的地址。
curl -v https://example.com测试端口。
nc -vz example.com 443显示代理环境变量。
env | grep -i proxy
如何修复
如果服务是你自己的,请启动它,并使用它打印出的端口。
强制使用 IPv4,以排查 IPv6 故障。
curl -4 -v https://example.com取消设置错误的代理。
unset https_proxy http_proxy为了测试,暂时关闭 VPN,之后再打开。
使用 Kilobat
Kilobat 的连接诊断会逐层测试这个地址:网络、代理、DNS、规则、IPv4、IPv6、TLS 和服务器,并指出失败的那一层。
kilobat why https://example.comKilobat 的这些检查都是免费的。AI 智能体可以通过 MCP 用
diagnose_connection和diagnose_network运行它们。请参阅找出某个网站或 API 连不上的原因。
常见问题
退出码 7 表示主机已宕机吗?
不一定。curl 无法连接到主机或代理。用 curl -v 查明是哪一个。
它与 (6) 有什么区别?
退出码 6 表示主机名没有解析。7 表示连接失败。参见Mac 上的“curl: (6) Could not resolve host”。
参考资料
核查日期:2026 年 10 月 29 日。