この記事でできることと前提
家庭や小規模オフィスの LAN において、メインルータはインターネット出口と DHCP を担ったまま、別マシン(多くは NAS や省電力ミニ PC)上で Docker 上の Clash(Mihomo コア)を常駐させます。そこにテレビ・ゲーム機・テスト用 PC などからデフォルトゲートウェイとして旁路機の LAN IP を指定し、HTTP/SOCKS プロキシ経由でルール下にトラフィックを載せる——という「コンテナ化した旁路ゲートウェイ」の立ち上げ方を、ポートマッピングとLAN 側の数値設定に焦点を当ててまとめます。
ホスト OS に直接バイナリを入れて systemd で動かす手順は、Ubuntu 向けの常駐ガイドで別枠として触れています。本稿はDocker レイヤが追加されることで変わる論点(ブリッジとホストの違い、特権と /dev/net/tun、公開ポートの見え方)を中心にします。TUN スタックや漏れ対策の一般論はTUN モード解説と併読すると整理しやすいです。
本稿は技術的な構成例の共有であり、利用する契約・ポリシー・法令はご自身の環境で必ず確認してください。職場ネットワークやプロバイダ規約で禁止されている用途では利用できません。
ステップ0:ネットワークトポロジを紙に書く
旁路構成で事故が少ないのは、次の 4 点を先に固定したときです。(1) メインルータの LAN セグメント(例:192.168.1.0/24)と、旁路機に割り当てる固定 IP(例:192.168.1.10)。(2) 旁路機のデフォルトゲートウェイはメインルータ(例:192.168.1.1)のまま。(3) 旁路機自身の DNS は、ループを避けるために「ルータ経由」か「Clash の仮想 DNS」かを運用方針として決める。(4) クライアント側は「ゲートウェイ=旁路機」か「プロキシ手入力」のどちらで載せるかを端末ごとに決める。
ここでいう透明プロキシ(端末がプロキシ設定なしで旁路を通る状態)は、OS レベルのパケット取り込みが絡むため、Docker のデフォルトブリッジだけでは再現が難しいことがあります。まずは 明示的プロキシ(ゲートウェイ+HTTP/SOCKS、または PAC)で安定させ、必要になった段階で TUN とホストネットワーク/特権を検討する順が安全です。
ステップ1:Docker のネットワークモードを選ぶ
bridge(既定)の場合、コンテナは Docker ブリッジ上の別サブネットに置かれ、ホストの LAN インタフェースとは別物として扱われます。Clash の bind-address や allow-lan を有効にしても、「ホストの 192.168.1.10 で待ち受ける」イメージにはならず、ホスト側でポートをマップして初めて LAN から到達しやすい、という理解が重要です。
host モードでは、コンテナがホストのネットワークスタックを共有するため、ポートマッピングの階層が減り、旁路機としての挙動を素直に追いかけられます。一方でポートの衝突やセキュリティ境界が薄くなるため、NAS の管理 UI や他コンテナと待受ポートの重複を必ず確認してください。
どちらを選んでも、まずホスト上で ip -br a と ip route を見て、LAN 側インタフェース名とゲートウェイが期待どおりかを確認してからコンテナを起動します。
ステップ2:compose の骨格(ボリュームと権限)
典型的には、設定ディレクトリをホストにマウントし、コンテナ内の作業ディレクトリを -d に合わせます。TUN を試す場合は /dev/net/tun の渡し方と、cap_add もしくは privileged: true の要否が論点になります(製品ポリシーと相談のうえ最小権限を選んでください)。次はあくまで説明用の雛形であり、イメージ名・パス・ポートは環境に合わせて置き換えてください。
# docker-compose.yml — illustrative only; adjust image, paths, and caps
services:
clash:
image: your-mihomo-or-clash-image:tag
restart: unless-stopped
network_mode: bridge
ports:
- "7890:7890/tcp" # mixed / http proxy (match your config)
- "9090:9090/tcp" # external-controller (bind to LAN carefully)
volumes:
- /path/on/host/clash-config:/root/.config/mihomo
# For TUN experiments (often required:)
# cap_add:
# - NET_ADMIN
# devices:
# - /dev/net/tun
9090 のような管理ポートを 0.0.0.0 に晒すのは危険です。ルータ側でアクセス制限する、リバースプロキシで TLS 終端する、またはLAN 内の管理端末からだけ到達できるようファイアウォールで絞る、のいずれかを必ず組み合わせてください。
ステップ3:config.yaml 側の最低限
旁路利用では次を押さえると詰まりにくいです。(1) mixed-port または port を、compose の ports と一致させる。(2) LAN から接続を受けるなら allow-lan: true と、必要に応じて bind-address を検討する(ホストモード時は特に衝突に注意)。(3) DNS と Fake-IP の組み合わせで、旁路機自身とクライアントで名前解決の挙動が食い違わないよう、nameserver とルール順をログベースの切り分け記事の型に沿って確認する。
TUN をオンにして「透明プロキシに近い」取り込みを狙う場合は、コンテナとホストのルーティングが絡み、トラブル時の切り分けが難しくなります。まず mixed ポートだけで curl -x http://旁路IP:7890 などの明示プロキシ疎通を通してからにしてください。
ステップ4:ポートマッピングを「表」にする
運用が続くチームほど、次のような一行表を README に残します:外部から見えるホスト側ポート、コンテナ内待受、プロトコル、用途(HTTP/SOCKS/API)、公開範囲(LAN のみ/管理 VLAN のみ)。QNAP や Synology の GUI でも同じ対応を「カスタム」や「ポート転送」として打つことになるため、数字の二重管理がミスの元です。変更したら Clash 側と NAS 側の両方を同じタイミングで更新する癖をつけると安全です。
複数コンテナと共存させる場合、7890 が既に別サービスに使われていれば、ホスト側を 17890:7890 のようにずらし、クライアントの PAC やプロキシ設定も合わせて変えます。ここで「コンテナ内は 7890 のまま、LAN からは 17890」と頭の中で変数が二つあると混乱しやすいので、表に書いたら実際の設定ファイルにもコメントで残すのがおすすめです。
ステップ5:クライアントにゲートウェイ/DNS を渡す
テレビやゲーム機は静的 IP を与え、デフォルトゲートウェイ=旁路機の IP、DNS はルータか公共 DNS か、運用に合わせて固定します。DHCP で一括配布したい場合は、メインルータの DHCP で「特定 MAC だけゲートウェイを旁路に」できるか、もしくは別 SSID/別 VLANに旁路専用のスコープを切る方法があります。メーカーごとに UI 名称は違いますが、設定の本質は「その端末のパケットが、まず旁路に届くか」です。
ゲートウェイを旁路にしただけでは、アプリがプロキシを知らず期待どおりに出口が切り替わらない場合があります。そのときは(A)端末側で HTTP/SOCKS を指定できるなら直接入れる、(B)PAC URL を配る、(C)本当に全トラフィックをカーネルで取り込むなら TUN とルート調整、の順で検討します。(C)は単純そうに見えて、Docker ではホスト側の iptables/nft と競合しやすい点に注意してください。
ステップ6:疎通とログの見どころ
別端末から、まず ping 旁路IP で L2/L3 の基本が通るか確認します。次に curl -x http://旁路IP:7890 https://www.example.com -I のように、プロキシ経由で TLS が張れるかを見ます。ここで失敗する場合は、ポートマップの取り違え、ファイアウォール、allow-lan、あるいはクラッシュ直後のバインド失敗を疑い、コンテナログとコアログを同時に追います。
ルール誤マッチで特定ドメインだけ直結しているケースは、画面では「つながっているのに遅い/一部だけ出ない」になりがちです。プロキシグループと GEOIP/DOMAIN の順序は、当サイトのドキュメント索引から参照できる公式の考え方に合わせ、変更点は小さく刻むと切り分けが楽です。
透明プロキシと明示プロキシの現実的な線引き
用語としての透明プロキシは、クライアント設定なしでトラフィックをプロキシへ誘導する仕組み全般を指しますが、Clash 文脈では TUN やシステムルートを伴うケースが多く、Docker ではホストのネットワーク名前空間と権限がセットになります。家庭用 NAS で「とにかく今すぐ安定」を優先するなら、テレビにプロキシを入れられない事情がない限り、明示プロキシまたはルータ配下の PACで目的のホストだけ出口を変える方が再現性が高いです。
どうしても TUN に寄せる場合は、ホスト直インストールや、network_mode: host と特権の組み合わせを検討し、失敗時に SSH でホストに入ってルートを戻せるコンソール導線を確保してからにしてください。クラウド上の共有 NAS では管理者権限やカーネルモジュールに制限があることもあり、その場合はそもそも TUN が成立しないので、最初にプラットフォーム制約を読んでおく価値があります。
よくあるつまずき
LAN から 7890 に繋がらない:ホストのファイアウォール、NAS のセキュリティスイート、Docker の publish 忘れ、別プロセスのポート占有を順に疑います。ゲートウェイを旁路にしたら全クライアントが不通:旁路機のフォワーディングや NAT、あるいはループバック経路が不足している構成です。まずゲートウェイをルータに戻して復旧し、旁路機単体のルートテーブルから直します。
DNS だけおかしい:Fake-IP とローカル DNS の境界は、旁路構成ほど端末ごとに差が出ます。クライアントに公共 DNS を直指定していると、ルール上はプロキシでも名前解決だけ別経路、という状態になりえます。期待どおりの挙動を定義し、ダイジェスト表示のログで確認するのが近道です。
まとめ
Docker で Clash を旁路ゲートウェイとして使うときの要点は、ポートマッピングで「LAN からどのポートが見えるか」を表にし、config の待受と一致させること、そしてクライアント側にはゲートウェイとプロキシのどちらで載せるかを先に決めることです。透明プロキシへ寄せるほどホスト OS と権限の話に踏み込むため、最初は明示プロキシで安定運用し、必要になった段階で TUN とネットワークモードを見直すのが安全です。
クライアントの入手と更新は、配布物の整合性の観点から当サイトのダウンロードページを第一の導線にし、コアの挙動や Issue の参照は GitHub を情報源として切り分けると、読者が「どこから何を入れるか」を取り違えにくくなります。Linux ホストへ直接入れる構成が向く場合は、コンテナではなくsystemd 常駐の流れの方がシンプルになることもあります。
同種のツールのなかでも、Mihomo 系はルール表現とプロバイダ周りの拡張が豊富で、ログから挙動を追いやすい点が実務では助かります。旁路構成が一度安定すると、端末を増やしても IP とポートの表を少し足すだけで済むので、最初に設計のメモを残しておくと長く運びやすいです。