こんなとき読む記事:症状の整理
ホスト上で Clash(Clash Verge Rev や Clash for Windows 系、Mihomo コアを用いるデスクトップ系クライアントなど)を起動し、ブラウザでは期待どおりプロキシ経由で外に出ているのに、Docker もしくは Docker Compose で起動したサービス、あるいは docker run した一時的な コンテナ 内の curl や apt、npm だけがタイムアウトしたり、一見「国内回線のまま外に出ていない」ように見えたりする。そうした問い合わせは 2024〜2026 年にかけても開発者向け掲示板や Q&A で非常に多い部類に入ります。
本記事では、Docker Clash を「ブリッジネットワークのまま HTTP_PROXY 系の宛先をホスト直のリスナーに合わせる」手順を中心にまとめます。ポイントは、コンテナのネットワーク名前空間はホストと別であり、ドキュメントに多い 127.0.0.1:7890 を容器の中からそのまま使うと、ループバック先に Clash がいないことがあること。あわせて、Windows や macOS の「システムプロキシ」は Docker 内のシェルに暗黙継承されないことも押さえておくと、切り分けが早くなります。関連記事は ブログ一覧 から辿れます。
docker0 や br-…)越しに、各コンテナにプライベート IP を与える接続形態のイメージです。ホストの Clash とは、ホスト OS 上のプロセスとして待ち受けている HTTP/SOCKS の入口(多くの場合 mixed-port や専用の HTTP ポート)を指します。
なぜコンテナは「ホストの Clash」を勝手に使わないのか
第一に、ブリッジ 上のコンテナ内で 127.0.0.1 や localhost と書くと、それはそのコンテナ自身のループバックを指します。ホストで 7890 を開いていても、コンテナ内の 127.0.0.1:7890 には 何も聞いていない、という空振りが最頻出の罠のひとつです。第二に、ホストのブラウザが参照する システムプロキシ と、Linux シェル が参照する http_proxy 系の環境変数は、レベルが異なり、コンテナ起動コマンドか Compose で明示的に渡さなければ基本的に存在しません。第三に、DNS もホストの systemd-resolved や Windows の取得サーバそのものではなく、Docker 用の 内蔵リゾルバ(しばしば 127.0.0.11 など)を介す経路に偏ります。Clash 側の Fake-IP やルールの前提と、コンテナ内で見える名前解決の結果が食い違うと、HTTPS は張れるのに SNI や証明書周りで失敗、といった層の問題にも発展しがちです。DNS 一般の整理は Fake-IP / DNS 解説 も参照ください。
ステップ 1:コンテナから「ホストの IP」を決める
プロキシの宛先に書くのは、原則としてホストがブリッジ上でコンテナに見えるアドレスです。環境ごとに定番の取り方が決まっています。
- Docker Desktop(Windows / macOS):多くの場合、特殊ホスト名
host.docker.internalが用意され、これがホスト OS 側を指す想定の名前です。Compose ならextra_hostsの明示を要する古い版もあるため、docker runや実際の解決に一度getent/pingで当たりを付けてください。 - Linux 上の Docker Engine(本番向け)/仮想マシン内:ドキュメントで用いられるのは、通常ブリッジのデフォルトゲートウェイ(例:docker0 側
172.17.0.1)。ip route | grep defaultやdocker network inspect bridgeで実測し、自環境の値に置き換えてください。クラウドのマネージド Kubernetes 等では別文脈のため、本稿のdocker/ Compose 想定のまま用いるのが安全です。
重要なのは、コミュニティの例に出てくる 127.0.0.1 や、書籍に載る「ホスト=172.17.0.1」の文字列を鵜呑みにせず、いま起動中の 1 コンテナ内で到達性を ping して確かめることです。WSL2 と Windows ホストの橋渡しに特化した整理は、切り分けの対象が違いますが併せて読みやすい補完になります。→ WSL2 側の Clash 橋渡し手順
ステップ 2:Clash 側の待ち受けポートと「LAN 越し到達」
HTTP プロキシとして載せるのは、設定ファイルまたは GUI に示される mixed-port あるいは専用の HTTP ポート(例として 7890)で、あなたの手元の値に合わせてください。次に、コンテナ内から http://<ホスト到達用 IP>:<ポート> へ 実際に TCP 接続が開く必要があります。デフォルトだと 127.0.0.1 のみリッスンしていると外部(コンテナ)から届かないため、Clash クライアントの Allow LAN(同義の表示は製品で異なります)相当をオンにし、0.0.0.0 もしくはブリッジ越しに届くインターフェースにバインドする、という二段構えの確認が定番です。LAN 向けの全体像は LAN プロキシ共有の解説 で触れています。ホストの OS ファイアウォールが厳しければ、到達用ポートだけの許可ルールを足す必要もあります。
ステップ 3:HTTP_PROXY 系をコンテナに渡す(docker run)
到達用ホスト名を HOST、Clash の HTTP 用ポートを 7890(実測値に置き換え)と仮定して、HTTP/HTTPS クライアント が読む表記の例を示します。多くのツールは大文字小文字の両方を参照するため、大文字小文字を揃えておくとトラブルが減ります。
export HTTP_PROXY="http://HOST:7890"
export HTTPS_PROXY="http://HOST:7890"
export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
export NO_PROXY="localhost,127.0.0.1,::1,*.local"
docker run では、-e で同一の四対(場合によっては ALL_PROXY)を渡し、HOST 部分を host.docker.internal か実測のゲートウェイに置き換えます。npm や pip など、独自にプロキシ変数を読まないケースは、ツール側の --proxy か設定ファイル、あるいは tsocks 系のソックスラッパを検討する必要があります。
ステップ 4:Docker Compose で全サービスに同じ出口を揃える
複数サービスに同じ値を一括で載せるには、docker-compose.yml または compose.yaml の environment ブロック、もしくはルートの .env から HTTP_PROXY を参照する形が扱いやすいです。ビルド時の apt や apk まで通したい場合は、build.args 経由で HTTP_PROXY を ARG に渡し、Dockerfile 内の ENV まで流す、という流れにします。CI とローカルでパッケージ取得の有無が変わる典型なので、本番用イメージではビルド時プロキシを焼かず、ラン時のみ環境変数、という分離を選ぶチームも多いです。Compose の network_mode: bridge 明示はしばしば省略可能ですが、host モード(次節)と混在させないかだけは意識してください。
NO_PROXY・社内リポ・ローカル API
NO_PROXY(no_proxy も併せて)に、プロキシを踏ませたくないホスト名や IP を列挙します。企業内の git サーバ、10.x / 192.168.x 帯、Kubernetes のクラスタ内名 *.svc.cluster.local など、ジョブ内から直接届けたい宛先を誤って Clash へ回すと、遅延や認証失敗の原因になります。逆に、外部 SaaS だけ意図的に出口固定したい場合は、ルールの話になるため、併せて ルール分流 の考え方も押さえておくと、ホスト上の Clash 側の出口ノードの揃い方と、コンテナ内のプロキシ宛先、の二層の設計を整理しやすくなります。
ステップ 5:コンテナ内で到達性を「実測」する
雛形の確認として、HTTP 接続 のスモークに curl -I https://例のドメイン、プロキシが効いている痕跡としてホスト上の Clash の接続ログにドメインが出るか、を見ます。wget 系は環境変数解釈の差があるため、まず curl で揃えがちです。DNS 解決の切り分けでは getent や nslookup をコンテナ内で叩き、期待する IP か Fake-IP かを目視するのが有効です。挙動がホスト上の curl と違いすぎる場合は、まず同じ HTTP_PROXY 値を、ホストのシェルとコンテナのシェルに載せ、差分を潰すと早いです。
代替:network_mode: host や TUN との使い分け
Linux ホスト限定で、network_mode: host を使うと、コンテナはホストのネットワーク名前空間を共有するため、127.0.0.1:7890 をそのまま指せる例が多くなります。ただしポート衝突やセキュリティ境界の希薄化、可搬性(Windows や macOS の Docker Desktop では扱いが異なる)の問題があるため、開発用ワンショット向きの逃げ道、と捉えるのが安全です。ホスト上で TUN モードを有効化し、OS 全体の出口を揃えた上で、コンテナのルーティングまで吸い込みたい、という二段階の話になる場合は TUN モード の注意点(権限、DNS、他 VPN との排他)を先に整理してください。
まとめ:ブリッジのまま「出口の座標」だけ揃える
Docker や Compose のまま、ホスト上の Clash へ HTTP_PROXY 系の矢印を合わせる要点は、127.0.0.1 の取り違えをしないことと、Allow LAN やファイアウォールで「コンテナからホストのポート」が生きた生の TCPとして届くことの二点です。あとは環境変数の大小文字、NO_PROXY、ビルド時と実行時のどちらに効かせるか、をチーム方針に沿って固定すると、挙動のブレが抑えやすくなります。クライアントのポート表示とログの読み方に慣れるには、初回導入を ダウンロードページ から自環境用パッケージに揃え、mixed-port や システムプロキシ 表示を実測のたびに合わせるのがおすすめです。安定した挙動は、他の多機能プロキシと比べたときも、Clash 系(Mihomo コア)の可視性とルールのしやすさで差が出ます。