この記事のゴールと読者像
すでに Ubuntu や Fedora、あるいは Arch 向けの手順記事を読み、同じ Clash Meta(多くのビルドでは実行ファイル名が mihomo)を Debian 12(bookworm)の VPS・自宅サーバー・デスクトップへ持ち込みたい方を主な読者に想定しています。差分の中心は「安定版 apt の前提」「nftables が絡みやすいこと」「network-online.target をどう待つか」「TUN を一般ユーザーで回すときの capabilities」あたりです。
当サイトでは同テーマを Ubuntu 版、Fedora 版、Arch/AUR 版で既に補完しています。本稿はその Debian 系専用の欠けていた実務チェーンを埋める位置づけで、AUR 固有の話や Ubuntu のパッケージ名に依存しない切り口にしています。
技術的なセットアップの共有であり、接続先の契約・法令・組織ポリシーは必ずご自身で確認してください。共有マシンでは管理者の許可とログポリシーに従ってください。
Debian 12 で最初に押さえる OS 側の前提
bookworm はパッケージが保守的で、Ubuntu LTS に比べると「新しめのユーザー空間ツールをソースから入れたい」場面はやや増えますが、Clash Meta 本体は公式の静的バイナリや配布アーカイブを置く運用が一般的です。まず apt update のあと、HTTPS 取得と証明書検証、ルーティング確認に効く最小セットを揃えます。
# Example: minimal tooling for TLS fetch and routing diagnostics
sudo apt install -y ca-certificates curl iproute2 dnsutils
iptables-nft と nftables のどちらを主に使うかは環境次第ですが、TUN を有効にするとルールとテーブルの競合が表面化しやすいので、他製品の VPN クライアントや Docker のブリッジと同時にルートをいじっていないかを先に確認しておくと後工程が速いです。uname -r と ls -l /dev/net/tun、modprobe tun(必要な場合のみ)で TUN デバイスが見えることも合わせて確認します。
バイナリ配置とディレクトリ方針
アーキテクチャ(例:linux-amd64)に合った実行ファイルを選び、更新しやすい絶対パスへ配置します。以降の例では /usr/local/bin/mihomo と設定ディレクトリ /etc/mihomo(root 運用)を想定しますが、ホーム直下の ~/.config/mihomo に寄せる場合は systemd の User= と所有者を必ず揃えてください。
入手導線は当サイトのダウンロードページを第一にし、実行ファイル名とユニットの ExecStart を一致させます。仕様確認や Issue 追跡はMihomo の GitHubを別枠で使い分けると、「パッケージをどこから入れるか」の誤解を減らせます。
設定の骨格と「TUN の前」の疎通
config.yaml では、少なくとも 待受ポート(mixed-port など)、DNS、プロキシ定義、プロキシグループ、ルール末尾の MATCHまでが矛盾なく繋がっている必要があります。最初から TUN を有効にせず、HTTP/mixed ポートだけでブラウザや curl が期待どおり動く状態を作ると、障害の層が分かれます。
DNS と Fake-IP、ルール順の相互作用は「ログ上は繋がっているのにページが開かない」原因になりやすいので、切り分けの型は接続ログと DNS の記事を併読してください。TUN の概念整理はTUN モード解説に譲り、本稿では Debian 固有の nft/権限/起動順に厚めに触れます。
手動起動で一次確認
systemd に載せる前にフォアグラウンドでログを見ます。
# Example: foreground run; replace -d with your directory
sudo /usr/local/bin/mihomo -d /etc/mihomo
別シェルで ss -lntp により待受を確認し、curl -x http://127.0.0.1:PORT https://example.com -I のように検証します。ここで失敗する場合は YAML のインデント、購読 URL の到達性、プロバイダの認証、ルールの誤マッチを先に直してください。
systemd ユニット:ブート直後の到達性と capabilities
Debian でも基本形は Ubuntu と同じですが、After=network-online.target と Wants=network-online.targetを付けておくと、DHCP や PPPoE 直後にプロバイダ取得へ走って失敗するケースを減らせます。TUN を一般ユーザーで操作する場合は CAP_NET_ADMIN などの付与が定番です(組織ポリシーで禁止されている場合は root 実行や別の分離を検討)。
# /etc/systemd/system/mihomo.service — adjust User and paths
[Unit]
Description=Mihomo (Clash Meta) on Debian
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=mihomo
Group=mihomo
WorkingDirectory=/etc/mihomo
ExecStart=/usr/local/bin/mihomo -d /etc/mihomo
Restart=on-failure
RestartSec=3
AmbientCapabilities=CAP_NET_ADMIN CAP_NET_BIND_SERVICE
CapabilityBoundingSet=CAP_NET_ADMIN CAP_NET_BIND_SERVICE
NoNewPrivileges=yes
[Install]
WantedBy=multi-user.target
反映は sudo systemctl daemon-reload、sudo systemctl enable --now mihomo.service、状態確認は systemctl status mihomo、ログ追従は journalctl -u mihomo -f です。設定更新後は systemctl restart mihomo を運用に組み込みます。
TUN を Debian 12 で有効化するときの注意点
TUN は「プロキシを見ないアプリ」や「DNS の取りこぼし」を減らしますが、ルーティングテーブルとポリシールールに触れるため、次の順が安全です。(1)mixed だけで日常運用に慣れる。(2)検証環境で tun.enable: true にし、スタック(system/gvisor など)を切り替えて挙動差を見る。(3)問題なければ本番へ。Linux では他 VPN やコンテナブリッジとルート競合すると「一部だけ遅い」「特定サブネットだけ直結になる」といった半端な症状になりやすく、ip rule とログの両方を見る必要が出ます。
Debian のサーバーで nftables を手作業管理している場合、TUN 作成時にルールが期待どおり注入されているかを nft list ruleset で確認すると、「設定は有効なのに実パケットが別テーブルへ流れる」系の切り分けが速くなります。
典型エラーと症状の対照(インストール〜運用)
次の表は出発点です。実際のログ行はビルドや設定によって微妙に異なりますが、観測箇所は共通です。
- 実行直後に終了/
permission denied系:設定パスと所有者、秘密情報ファイルの権限、TUN を触る権限(capabilities または root)を疑う。journalctl -u mihomo -bの先頭数十行にヒントが出ることが多いです。 /dev/net/tunが無い・開けない:カーネルモジュールとデバイスノード、コンテナ内なら特権モードやデバイスマウントの不足を確認します。- ブラウザは速いが apt/curl は遅い・失敗:デスクトップの「システムプロキシ」とシェルの
http_proxyの二重管理、NO_PROXYの漏れ、TUN オフ時の取りこぼしを疑います。 - 接続ログは出るのに実トラフィックが直結(漏れ):TUN が無効、ルール順で早期に
DIRECTへ落ちている、プロセスが TUN を見ていない、Split DNS が期待と逆、などを順に潰します。TUN 解説の「除外ルート」と「DNS の閉ループ」節を先に当てはめてください。 - しばらくすると切断/再起動で復旧:購読更新、DNS キャッシュ、サーバー側アイドル切断、
Restart=ポリシーと相関するなら、プロバイダ側のタイムアウトとルールの再評価タイミングをログで追います。
ドキュメント全体の見通しはチュートリアル索引も参照してください。
HTTP プロキシと環境変数の整合
TUN でほぼ全体を覆う構成でも、コンテナ内や一部デーモンでは http_proxy が依然として必要になることがあります。mixed-port が 7890 なら、シェルでは大文字・小文字を揃えるとトラブルが減ります(ポートは手元の値に合わせてください)。
export http_proxy="http://127.0.0.1:7890"
export https_proxy="http://127.0.0.1:7890"
export HTTP_PROXY="$http_proxy"
export HTTPS_PROXY="$https_proxy"
ヘッドレスサーバーでは「ブラウザは無いが apt や CI ランナーだけプロキシ必須」といったパターンもあるため、どのユーザー単位で変数を読み込むか(ログインシェル/systemd の Environment= など)を一貫させることが重要です。
まとめ
Debian 12 へ Clash Meta を持ち込むときの要点は、apt で揃える周辺と nft/ルートの現実、systemd で待つネットワーク到達性、TUN と capabilities のセット、そして「繋がるが漏れる」を DNS とルール順で解体する観測の型に集約されます。一度パスとユニットを固定すれば、Ubuntu や Fedora で作ったルールセットもディレクトリとポートさえ揃えれば同じ考え方で移植しやすく、VPS 群の再現性も上がります。
同種ツールのなかでも Mihomo 系はルール表現とプロバイダ周りの拡張が豊富で、ログから挙動を追いやすい点が実務では助かります。構成が固まったらクライアントを最新に保ち、購読とルールの更新ポリシーを決めておくと長期運用が楽になります。