1. 開発者の通信は「ブラウザだけ」では完結しない
ブラウザでは問題なく閲覧できるのに、git clone はタイムアウトする、SSH の接続だけ失敗する、Homebrew のインストールが途中で止まる――開発環境では、こうした入口ごとの通信差がよく起こります。原因は、Clash のプロキシ設定が無効というより、ターミナルのプログラムがシステムプロキシを参照していない、HTTPS と SSH で接続方式が異なる、あるいは同じコマンドでも子プロセスが別の環境変数を受け取っている、といった点にあります。
特に Git は HTTPS と SSH のどちらでもリポジトリへ接続でき、Homebrew は操作によって Git、curl、独自のダウンロード処理を使い分けます。そのため「ブラウザが開くから CLI も通るはず」とは限りません。まず Clash Verge や Clash Verge Rev で実効モードとログを確認し、ターミナル側では必要なプロキシを明示するのが切り分けの基本です。常にすべての通信を TUN に流すのではなく、どのプロセスがどの経路を使うべきかを分けて考えると、社内 Git やローカル開発環境への影響も抑えられます。
この記事では、Rule モードを中心に、Mixed Port を使ったターミナルの設定、Git の HTTPS/SSH、Homebrew の確認方法を順に説明します。設定例のポート番号や策略グループ名は環境によって異なるため、ご自身の Clash プロファイルにある値へ読み替えてください。コマンドを一度に複数変更せず、各段階で接続を確認することが、原因を見失わないためのポイントです。
2. Clash のモードとターミナルからの疎通を確認する
最初に、Clash が実際に稼働しているか、そしてターミナルから使える待ち受けポートが何番かを確認します。多くの構成では HTTP と HTTPS 向けの Mixed Port が 7890、SOCKS5 ポートが 7891 などに設定されていますが、これは例にすぎません。Clash の一般設定やプロファイルを開き、現在有効なポート番号と、選択中のプロキシグループを記録してください。
日常利用では、まず Rule モード+システムプロキシを基本にして、ターミナルには環境変数で Mixed Port を渡す方法が扱いやすいでしょう。システムプロキシは多くの GUI アプリに便利ですが、CLI が自動で参照するとは限りません。逆に TUN は、環境変数を受け取らないアプリや独自通信を行うプロセスも捕捉しやすい一方、別の VPN、仮想ネットワーク、社内のルート設定と競合する場合があります。まず明示的なプロキシを試し、どうしても対象プロセスを捕捉できない場合に限って TUN を短時間の診断に使うと、影響範囲を把握しやすくなります。
macOS や Linux のシェルでは、現在のターミナルセッションだけに設定するなら次のようにします。NO_PROXY には、ローカルホストや社内ネットワークなど、プロキシを通さない宛先を必要に応じて追加します。プロキシの資格情報を含める場合は、共有端末やシェル履歴に秘密情報が残らないよう注意してください。
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=socks5h://127.0.0.1:7891
export NO_PROXY=localhost,127.0.0.1,::1
設定後は、まず軽い HTTPS リクエストで経路を確かめます。curl の結果だけでは Git や Homebrew 全体の成功を保証しませんが、少なくともシェルの環境変数、ローカルの待ち受けポート、Clash の上流経路を確認する手がかりになります。続けて Clash の接続ログを開き、接続先ドメイン、選択されたルール、利用された策略グループが想定どおりかを見ます。ターミナルで設定したのにログに通信が出ない場合は、変数の綴り、別ターミナルでの実行、プロキシポートの相違を先に確認してください。
curl -I https://github.com
env | grep -i proxy
Windows では、PowerShell のセッション変数を使えます。設定を永続化する前に、まず現在のウィンドウで接続を試すと、不要な環境変更を避けられます。WSL を使う場合は、WSL 内の 127.0.0.1 が Windows 側の Clash を指すとは限りません。WSL のネットワーク構成やバージョンによって接続先アドレスが異なるため、Windows 側のポートをそのまま転記せず、WSL から到達できるホストアドレスとポートを確認してください。
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
curl.exe -I https://github.com
3. Git の HTTPS と SSH をそれぞれ設定する
HTTPS 形式のリモートを使う Git は、シェルの HTTPS_PROXY を利用する構成が一般的です。まず git remote -v で接続先が https:// か git@ 形式かを確認し、HTTPS の場合は、先ほどの curl と Git の両方を試してください。curl は成功して Git だけ失敗するなら、Git 固有の設定や認証、証明書検証の問題が候補になります。逆にログに接続が現れない場合は、Git を起動したシェルに環境変数が引き継がれていない可能性があります。
特定の Git ホストだけをプロキシ経由にしたい場合、全シェルへ一律に変数を設定する代わりに Git の設定を使う方法もあります。ただし、既存設定と重複したり、社内サーバーまで外部プロキシへ送ったりしないよう、登録前に git config --show-origin --get-regexp 'http.*proxy' で現在の値を確認してください。リポジトリ単位の設定なら適用範囲を限定できます。設定を解除するときは、設定したスコープに対応する git config --unset を使います。
# Example: set a proxy for a specific HTTPS host
git config --global http.https://github.com.proxy http://127.0.0.1:7890
# Inspect existing proxy settings
git config --show-origin --get-regexp 'http.*proxy'
SSH は HTTPS の環境変数を通常そのまま使いません。Git のリモートが [email protected]:owner/repo.git のような形式なら、SSH クライアント側に経路を設定する必要があります。SOCKS5 ポートを利用する例では、OpenSSH の設定ファイル ~/.ssh/config に ProxyCommand を指定できます。以下の例は、利用中の nc が -X と -x オプションに対応している場合の書き方です。OS によって付属する nc の実装が違うため、オプションが使えない場合は対応する netcat を用意するか、別のプロキシコマンドを選んでください。
Host github.com
HostName github.com
User git
ProxyCommand nc -X 5 -x 127.0.0.1:7891 %h %p
設定後は、いきなり大きなリポジトリを取得するのではなく、SSH の認証と接続確認から始めます。成功した後に git clone を試し、Clash のログに接続先が現れるかを確認してください。SSH の鍵認証エラーはプロキシの疎通とは別問題です。接続そのものがタイムアウトする場合と、接続はできるが公開鍵が拒否される場合を分け、エラーメッセージとログを照合すると、認証設定を不必要に変更せずに済みます。
ssh -T [email protected]
git remote -v
SSH で標準ポートの接続が制限されるネットワークでは、接続先の提供元が案内する代替ポートや接続方法を確認してください。特定サービスのホスト名やポートを根拠なく追加するのではなく、公式ドキュメントと Clash の実際のログを基準にします。また、社内 Git のホストを外部の策略グループへ送るのは避け、必要なら社内ドメインを DIRECT にするルールを、広いプロキシルールより前に置いてください。
4. Homebrew のダウンロードと失敗箇所を切り分ける
Homebrew のコマンドが失敗したときは、「Homebrew 全体がプロキシを無視している」と決めつけず、失敗している処理を特定します。Formula や cask の取得では、Git によるメタデータ更新、curl を使うファイル取得、パッケージ固有のダウンロード先など、複数の経路が関与することがあります。ターミナルから実行した curl が成功しても、Homebrew が起動した別プロセスやダウンロード先のホストまで同じ結果になるとは限りません。
まず brew --version と対象コマンドの出力を記録し、どの段階で止まるかを確認します。続いて Clash のログで失敗時刻付近の接続先を探し、ルール、策略グループ、接続結果を照合します。ログに該当ホストがある場合は、そのホストが意図した経路に入っているか、同じ接続を再試行したときも同じ結果になるかを見ます。ログに出ていない場合は、環境変数が起動元のシェルに設定されているか、Homebrew の実行環境がその変数を引き継いでいるかを調べます。
Homebrew は内部処理や Formula の定義が更新されるため、「すべてのダウンロードが必ず同じ環境変数を使う」とは限りません。HOMEBREW_ で始まる独自の変数を推測で設定したり、証明書検証を無効にしたりするのは避けてください。TLS 証明書エラーが出た場合は、まず端末の日時、OS の証明書ストア、企業ネットワークの TLS 検査の有無を確認します。プロキシ経由で接続できることと、証明書を安全に検証できることは別の条件です。
ネットワークが不安定な場合は、同じ操作を短時間に何度も繰り返すより、エラーの種類を分けて記録するほうが有効です。DNS 解決エラーなら名前解決の経路、接続タイムアウトならポートや上流ノード、HTTP エラーならサーバー応答やアクセス条件を確認します。ダウンロード URL がログに見える場合は、別途 curl -I で同じホストへ接続し、Homebrew 固有の問題かネットワーク全体の問題かを比べます。ダウンロード先がリダイレクトで変わる場合は、最初のホストだけでなく、リダイレクト後の接続もログで追ってください。
複数のツールを同じ出口へ揃えたい場合でも、まずは必要なホストだけを対象にします。Homebrew の全通信を曖昧なキーワードルールでまとめると、無関係な接続や社内ネットワークまで巻き込む可能性があります。ログから実際の接続先を確認し、必要なドメインを個別に追加するほうが、あとから変更理由を説明しやすくなります。
5. ルールの優先順位と再現可能なトラブル対応
次の YAML は、Git やパッケージ取得で使うホストをプロキシグループへ送る考え方を示す概念例です。PROXY はご自身のプロファイルにある実際の策略グループ名に置き換えてください。プロバイダー、Git ホスティング先、Homebrew の利用形態によって必要なドメインは異なります。例にあるドメインをそのまま全環境へ適用するのではなく、接続ログで確認したものだけを追加してください。
rules:
# Add only hosts confirmed in your connection logs
- DOMAIN-SUFFIX,github.com,PROXY
- DOMAIN-SUFFIX,githubusercontent.com,PROXY
- DOMAIN-SUFFIX,brew.sh,PROXY
- DOMAIN,api.github.com,PROXY
# Keep company services and local networks on the intended route
- DOMAIN-SUFFIX,corp.example,DIRECT
- GEOIP,JP,DIRECT
- MATCH,DIRECT
ルールは上から評価されるため、広いルールを先に置くと、下にある例外が適用されないことがあります。社内ドメインやローカル宛てのルールを、広いドメイン条件や最終ルールより前に置き、Clash のルールログで実際に選択された行を確認してください。DOMAIN-KEYWORD,git のような条件は、名称に文字列が含まれる無関係なサービスまで対象にする可能性があります。まず完全一致やドメインサフィックスを使い、必要な対象だけを狭く指定するのが安全です。
調査では、ひとつの変更を加えたら同じコマンドを再実行し、結果を記録します。たとえば「Rule モードで失敗」「Mixed Port の環境変数を設定後に成功」「特定ホストを PROXY にした後に再現しなくなった」といった順序が残っていれば、原因をチーム内で共有しやすくなります。ログに個人のリポジトリ名、内部ホスト名、認証情報が含まれることもあるため、共有前に機密情報をマスクしてください。調査のために認証トークンをコマンドラインへ直接書くのも避けましょう。
別のターミナルでは成功するのに IDE の統合ターミナルだけ失敗する場合は、IDE を起動したときの環境変数が引き継がれているかを確認します。シェル設定を変更した後も IDE を起動し直さないと古い環境が残ることがあります。macOS では GUI から起動したアプリとターミナルから起動したアプリで環境が異なる場合があり、Windows や WSL でも実行ユーザーやネットワーク境界によって接続先が変わります。設定値だけで判断せず、失敗したプロセスの起動元と Clash のログを合わせて確認してください。
一般的なシステム VPN は設定が簡単でも、Git の HTTPS と SSH、Homebrew のダウンロード先を個別に観測しにくい場合があります。一方、Clash はルールと接続ログを使って通信先ごとに経路を調整でき、ターミナルの環境変数と組み合わせれば、GUI アプリと開発ツールの差も段階的に切り分けられます。設定が複雑な独自プロキシを増やす前に、まずは Mixed Port、明示的な環境変数、ログに基づく狭いルールで再現性を整えたい方は、利用環境に合うクライアントを確認してみてください。
開発環境の通信を整えましょう
Git、SSH、Homebrew の接続先をログで確認しながら、環境に合った Clash クライアントと設定方法を選べます。