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/ja/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
解決方法
自分のサービスなら起動します。表示されたポートを使います。
IPv6の不具合を調べるため、IPv4を強制します。
curl -4 -v https://example.com誤ったプロキシの設定を解除します。
unset https_proxy http_proxy短いテストのため、VPNをオフにします。終わったらオンに戻します。
Kilobatを使う場合
Kilobatの接続ドクターは、アドレスを層ごとにテストします。ネットワーク、プロキシ、DNS、ルール、IPv4、IPv6、TLS、サーバの順です。失敗した層を示します。
kilobat why https://example.comこれらのKilobatのチェックは無料です。AIエージェントはMCPを通じて
diagnose_connectionとdiagnose_networkで実行します。1つのサイトやAPIに接続できない原因を見つけるを参照してください。
よくある質問
終了コード7は、ホストが停止しているという意味ですか?
常にそうとは限りません。curlはホストまたはプロキシに接続できませんでした。どちらかをcurl -vで調べます。
(6)との違いは何ですか?
終了コード6は、ホスト名が名前解決されなかったという意味です。コード7は、接続に失敗したという意味です。Macの“curl: (6) Could not resolve host”をご覧ください。
出典
2026年10月29日に確認。