この記事のゴールと読者像

すでに 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= など)を一貫させることが重要です。

サーバー常駐では管理 API をローカルに拘束し、不要なポートを公開しない、設定と購読 URL を権限付きで保護する、といった基礎的なハードニングを前提にしてください。ログの保存期間とローテーションも運用ポリシーに合わせて決めます。

まとめ

Debian 12 へ Clash Meta を持ち込むときの要点は、apt で揃える周辺と nft/ルートの現実、systemd で待つネットワーク到達性、TUN と capabilities のセット、そして「繋がるが漏れる」を DNS とルール順で解体する観測の型に集約されます。一度パスとユニットを固定すれば、Ubuntu や Fedora で作ったルールセットもディレクトリとポートさえ揃えれば同じ考え方で移植しやすく、VPS 群の再現性も上がります。

同種ツールのなかでも Mihomo 系はルール表現とプロバイダ周りの拡張が豊富で、ログから挙動を追いやすい点が実務では助かります。構成が固まったらクライアントを最新に保ち、購読とルールの更新ポリシーを決めておくと長期運用が楽になります。

→ Clash を無料ダウンロードし、Debian を含む各環境で安定したクライアント体験を整える