配置 2026年10月9日

開発者向けClash TUN設定|Gitやターミナル通信をまとめてプロキシ

GitやSSHがターミナルからつながらないときに役立つ、開発者向けのClash TUN設定ガイドです。Homebrewなどの通信を自動で振り分け、DNSや社内LANのトラブルも確認できます。

Dockerプロキシ GitHub加速 高度な設定 YAML

1. ターミナルだけ通信できない理由を切り分ける

ブラウザでは Web サイトを開けるのに、ターミナルからの git clone、brew update、curl がタイムアウトする。開発環境では珍しくない症状です。多くの場合、Clash のシステムプロキシ設定がブラウザには反映されても、シェルや各 CLI ツールには引き継がれていません。アプリによっては HTTP_PROXY や HTTPS_PROXY を参照しますが、環境変数を読まないプログラムや、独自の通信ライブラリを使うツールもあります。

まず、失敗する操作を「ブラウザ」「ターミナルの HTTP 通信」「SSH 接続」に分けます。たとえば GitHub の Web ページは開くが git clone https://... が失敗するなら、シェルのプロキシ環境変数か、Clash のルール・ログを確認します。一方、HTTPS 形式の Git は成功し、[email protected] を使う SSH 形式だけ失敗する場合は、ポート 22 の通信が別経路になっている可能性があります。エラー文だけで原因を決めつけず、失敗した時刻、宛先、プロセス、Clash の接続ログを一緒に確認するのが近道です。

TUN モードは、OS に仮想ネットワークインターフェースを作り、アプリが明示的なプロキシ設定を持っていなくても、対応する通信を Clash へ取り込む方式です。システムプロキシや環境変数の設定が届かない CLI、パッケージマネージャー、バックグラウンドプロセスをまとめて扱いやすくなります。ただし、TUN をオンにすればすべての通信が必ずプロキシ経由になるわけではありません。ルール、DNS、OS のルート、権限、使用しているプロトコルが揃って初めて意図した経路になります。

2. 環境変数と TUN を使い分ける

最初から TUN を常時有効にする必要はありません。まずは Mixed Port と環境変数で対象を絞って試し、設定できないプロセスが残る場合に TUN を追加する段階的な進め方が安全です。環境変数は影響範囲がシェル単位で明確で、切り戻しも容易です。TUN は設定漏れのあるアプリにも届きやすい反面、端末上の通信全体や社内ネットワークまで影響することがあります。

方式向いている状況確認する点
環境変数curl、Git over HTTPS、対応する SDK を限定して通したいIDE の統合ターミナルや子プロセスにも変数が渡っているか
Git の個別設定Git の HTTPS 通信だけをプロキシに通したい設定スコープと、対象 URL が HTTPS か SSH か
TUN モードプロキシ設定に対応しない CLI や複数アプリをまとめて扱いたい権限、ルート、DNS、既存 VPN との競合

Clash の Mixed Port が 7890 の場合、まず現在のシェルで次のように設定し、短いリクエストを試します。ポート番号は実際の設定に合わせてください。

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=socks5://127.0.0.1:7891
curl -I https://github.com

このテストが通ったら同じターミナルから Git や Homebrew を実行します。シェルを閉じると環境変数が消えるため、常用する場合はシェル設定ファイルへ追加する方法もありますが、共有端末や社内端末では、適用範囲を確認してから保存してください。不要になった設定は unset HTTPS_PROXY のように解除できます。また、プロキシを使う接続と直接接続を同じ作業で混在させる場合は、社内ホストやローカルアドレスを例外にする必要がないかも確認します。

3. Clash の TUN を有効にして動作を確かめる

Clash Verge、Clash Verge Rev などの画面構成はバージョンや OS によって異なります。設定名の位置を探すより、TUN の有効化、必要な権限の承認、接続ログの確認という順番で進めましょう。OS からネットワーク拡張や管理者権限を求められた場合は、発行元と要求内容を確認し、必要な許可だけを与えます。すでに別の VPN、仮想マシン、コンテナ用ネットワークを使っている場合は、競合が疑われたときに元へ戻せるよう、変更前の状態を控えておくと安心です。

TUN の設定項目に auto-route や strict-route がある場合、それぞれの役割を理解して有効化します。自動ルート設定は対象トラフィックを仮想インターフェースへ流すために使われ、厳格なルート設定は意図しない経路への漏れを抑える助けになります。ただし、すべての環境で同じ値が適切とは限りません。管理端末、社内 VPN、仮想マシンを使う環境では、社内ネットワークへの到達性を確かめながら調整してください。

Mihomo 系コアの設定例として、次のような項目があります。これは説明用の断片であり、手元のプロファイルへそのまま置き換えるものではありません。既存の tun や dns 設定、クライアントが管理する項目と重複しないか確認し、画面から編集できる場合は画面側の設定を優先してください。

tun:
  enable: true
  auto-route: true
  strict-route: true
  stack: mixed
  dns-hijack:
    - any:53

TUN をオンにしたら、まず Clash の接続ログにテスト通信が表示されるかを確認します。次に、ログ上のルール名と接続先の策略グループが想定どおりかを見ます。リクエストがログに出ない場合は、TUN の権限・有効状態・OS のルートが候補です。ログには出るが接続に失敗する場合は、ルールの選択先、上流ノード、DNS のいずれかを分けて調べます。症状が変わったかを一度に一項目だけ変更して比べると、原因を追いやすくなります。

4. Git・SSH・Homebrew のルールを整える

ルールは「開発者向けの通信を全部まとめてプロキシへ送る」より、実際の接続先をログで確認して必要な範囲から追加します。Git のホスティングサービス、パッケージ配布元、コンテナレジストリなどは通信先が異なり、ダウンロード時に CDN へ接続することもあります。最初に試したサービスのホストだけでは、一部の画面や転送が失敗する場合があります。接続ログに現れたドメインを記録し、公式ドキュメントと照らしてからルールへ反映してください。

次の例では PROXY と DIRECT を、利用中のプロファイルにある策略グループ名へ置き換えます。社内ドメインやローカル宛てのルールを先に評価したい場合は、対象を特定したルールをこれらの行より前に置きます。ルールは上から評価されるため、最後の MATCH を含めた順番が重要です。

rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - DOMAIN-SUFFIX,githubusercontent.com,PROXY
  - DOMAIN-SUFFIX,githubassets.com,PROXY
  - DOMAIN-SUFFIX,brew.sh,PROXY
  - DOMAIN-SUFFIX,社内ドメイン.example,DIRECT
  - GEOIP,JP,DIRECT
  - MATCH,DIRECT

この例は出発点であり、すべての Homebrew ミラーや Git サーバーを網羅するものではありません。利用しているリポジトリや配布元によって必要なホストは変わります。広い DOMAIN-KEYWORD,git のような指定を安易に追加すると、関係のないサービスまで巻き込むことがあります。Clash の接続ログを見ながら一つずつルールを追加し、各行がどの用途の通信に必要なのかをコメントやチームの設定管理で説明できる状態にしましょう。

Git の SSH 接続は HTTPS プロキシ設定とは別に考えます。TUN が有効なら TCP 接続を捕捉できる可能性がありますが、最終的に接続できるかはルールと上流のプロキシ方式にも左右されます。SSH が失敗したときは、まず ssh -T [email protected] のような接続テストと Clash のログを照合し、宛先がルールに一致しているかを確認します。HTTPS 形式の Git に切り替える方法もありますが、認証情報の保存方法や組織の運用規則に従って選択してください。

5. DNS・社内 LAN・二重 VPN のトラブルを調べる

TUN を有効にしたあとにホスト名だけ解決できない、または接続先が想定と違う場合は DNS を調べます。アプリが OS の DNS キャッシュを使う一方で、Clash が別の DNS サーバーへ問い合わせる構成では、名前解決結果やルール判定が期待とずれることがあります。DNS を変更する前に、まず同じホストへ再試行したときの接続ログ、名前解決の結果、エラーが発生する時間帯を記録します。fake-ip を利用している環境では、除外設定や DNS の問い合わせ経路をプロファイルの設計に合わせて確認してください。

社内 LAN の名前解決やイントラネットへの接続が TUN 有効化後に失敗した場合、社内ドメイン、プライベート IP 範囲、社内 DNS サーバーへの経路がプロキシ側へ誤って流れていないかを確認します。組織から提供されている VPN や DNS 設定を無断で変更せず、必要な接続先をネットワーク管理者に確認してください。社内システムを利用する人は「外部通信はプロキシ、社内通信は直接または社内 VPN」という要件を先に整理してからルールを調整するのが安全です。

別の VPN と TUN を同時に動かしていると、デフォルトルートや DNS の受け渡しが競合し、通信が断続的になったり、特定ネットワークだけ到達不能になったりします。切り分ける際は、作業内容を保存したうえで片方ずつ一時停止し、同じコマンドを再実行します。仮想マシンや WSL からホスト側の Clash ポートへ接続する場合は、127.0.0.1 がどちらの環境を指しているかにも注意してください。ネットワーク名前空間が異なれば、ホスト側で開いたポートへ同じアドレスで到達できるとは限りません。

原因が分かったら、TUN を常時使う必要があるのかも見直します。環境変数で十分な CLI は明示的な設定に戻し、プロキシ設定を持たないアプリや必要な通信だけを TUN に任せれば、影響範囲を狭められます。単一の常時 VPN ではアプリごとの経路や社内 LAN の例外が見えにくいことがありますが、Clash はログ、ルール、策略グループを使って通信を段階的に切り分けられます。開発端末でターミナル通信を扱う方法を探しているなら、利用中の OS と必要な機能に合うクライアントを選び、まずは小さなテストから始めてください。

ダウンロードする

開発環境に合わせて始めましょう

対応する Clash クライアントを選び、ターミナルや TUN の設定を確認できます。