使い方 / 完全ガイド

Clash完全ガイド

インストールからルール分岐まで、通信の流れに沿ってクライアントを設定します。まず接続できる状態にしたい方はクイックスタートをご覧ください。設定の仕組みやルールの検証、トラブルの特定方法を知りたい場合は、本ガイドの各章を参照してください。

01 基本の仕組み:入口・ポリシー・出口

まず画面とコアを切り分ける

Clashのエコシステムでは、クライアントは通常、画面とコアの2層に分かれています。画面は設定の管理や接続状況の表示、システム設定の変更を担い、コアはローカルの入口で待ち受け、設定を読み込み、ルールを適用して、選択された方法で接続を確立します。mihomoはこのエコシステムで広く使われるコアですが、クライアントの名称やアイコン、メニューの並び順から、特定のコア機能が有効だとは判断できません。設定が使えるかどうかは、現在のコア、設定形式、クライアントがその設定をどう扱うかをあわせて確認してください。たとえば、コアが対応する設定項目に画面上のスイッチがないこともあります。逆に、画面で変更したスイッチが設定を適用する際に、ファイル内の同名項目を上書きすることもあります。

通信はどこを経由するのか

デスクトップのブラウザーを例にすると、まずブラウザーがシステムプロキシを使うかどうかを決めます。システム設定を使う場合、リクエストはクライアントが待ち受けるローカルポートに入ります。コアは接続先を判別し、現在のモードに応じてルールを調べるか、グローバルグループを使うか、直接接続するかを決定します。ルールに一致した結果は、組み込みポリシーの場合もあれば、設定ファイル内のプロキシグループの場合もあります。プロキシグループが実際の出口を選択します。ログに表示される接続先、適用ルール、ポリシーグループ、出口は、それぞれ別の項目です。トラブル対処では、この流れに沿って確認しましょう。Webページが開かないからといってすぐにノードを切り替えたり、クライアントにスイッチがあるからといって、すべてのアプリが通信経路に入っていると決めつけたりしないでください。

もうひとつ、混同しやすい点があります。アプリがクライアントを経由せず直接ネットワークに接続する場合と、クライアントを経由したあと DIRECT と判定される場合は、どちらも最終的にローカルネットワークを使うことがあります。ただし、後者だけがClashのポリシー判定を受け、通常は接続ログにも記録されます。反対に、接続一覧に記録があるのはコアが通信を受け取ったことを示すだけです。実際にWebページを開けるかどうかは、名前解決の結果、出口との接続、接続先サービスの応答にも左右されます。一覧に記録があるだけでは通信可能とは判断できません。また、クライアントを終了してもWebページが開くからといって、終了前にプロキシを経由していなかったとは限りません。

設定・サブスクリプション・ノードの関係

設定とは、まとめて読み込める設定項目の集まりで、一般的にはYAML形式です。ノードはプロキシ出口への接続情報を表し、プロキシグループは複数の出口から選ぶ方法を決め、ルールはリクエストを適切なポリシーに振り分けます。サブスクリプションからは、完全な設定が返される場合もあれば、ノード一覧やクライアントが認識できる別形式のデータが返される場合もあります。追加後にノードが表示されても、ルールやDNS設定、カスタムプロキシグループまで取得できたとは限りません。まず設定画面で現在選択中の項目を確認し、次にプロキシグループとルールの画面に必要な項目があるかを確認してください。別の設定に切り替えたあと、グループ名が同じでも、同じ出口が含まれているとは限りません。

DNSはドメイン名をIPアドレスに変換します。名前解決の成功と、出口への接続成功は別の問題です。通信の入口や実際の設定によって、名前解決はアプリ、本機のシステム、コアのいずれかで行われます。ログにIPアドレスしか表示されていない場合、ドメインルールの適用に必要な情報が足りない可能性があります。ログにドメイン名があり、ルールも正しく適用されているなら、次はプロキシグループと接続確立の過程を調べましょう。使い始めの段階でDNS、ルール、入口を一度に変更する必要はありません。まず再現可能な接続をひとつ確立し、章ごとに設定を広げてください。各章を終えるたびに、動作確認済みの状態を残しておけば、変更後に問題が起きても同じ状態に戻して比較できます。

02 クライアントの選び方:対応OSと設定機能

OSに合わせて候補を絞る

Windows、macOS、Android、iOSでは、まずClash Plusを比較候補にできます。このガイドでは最初に確認するクライアントとして取り上げます。LinuxではClash Verge Revを確認してから、FlClashと比較してください。ここでの推奨は選択肢を絞るための出発点であり、速度や安定性のランキングではありません。OSによって通信の入口、権限の確認、バックグラウンドでの動作は異なります。同じクライアント名でも、各OSで設定のインポート形式、ログの場所、プロキシモードを個別に確認してください。デスクトップ版のメニュー位置を、そのままスマートフォンの操作手順として使うことはできません。インストール先はダウンロードページで確認してください。

OSごとの候補とインストール前の確認事項
OSクライアント候補確認事項
WindowsClash Plus、Clash Verge Rev、FlClash、Clash Nyanpasu、Clash for Windows(アーカイブ)システムアーキテクチャ、システムプロキシ、サービスの権限
macOSClash Plus、Clash Verge Rev、FlClash、ClashX Meta(アーカイブ)チップの種類、ネットワーク拡張の許可
AndroidClash Plus、Clash Meta for Android、FlClash、Surfboardインストールパッケージのアーキテクチャ、VPNの権限、バックグラウンド動作の制限
iOSClash Plus(App Store)OSの互換性要件、VPN構成の許可
LinuxClash Verge Rev、FlClashディストリビューションのパッケージ形式、アーキテクチャ、デスクトッププロキシへの対応

日常の操作でクライアントを比較する

初回設定では、選択肢の数より、画面上で状態を確認しやすいかどうかが重要です。少なくとも次の4点を確認してください。設定画面に使用中のファイルが明確に表示されるか、プロキシ画面で各グループの現在の選択を確認できるか、接続画面で接続先からテストリクエストを識別できるか、終了時にシステムの元の設定へ戻せるか。主な用途がサブスクリプションの追加と出口の切り替えなら、これらの画面があれば基本的な比較ができます。ローカルルールによる上書きも必要な場合は、独立した上書き設定やマージ機能があるか、リモート更新後にどの設定が優先されるかを確認してください。該当する機能が見つからない場合は、まずローカルコピーで試しましょう。サブスクリプションの原本だけを唯一の作業ファイルにしないでください。

複数の端末を使う場合は、まずルールを管理するメイン端末を1台決め、ほかの端末には同じ基本設定を読み込ませます。デスクトップOSでは特定のアプリだけで先にテストできることが多い一方、モバイル端末ではシステムのVPN接続を使うのが一般的です。ステータスバーのアイコンとアプリ内のログをあわせて確認してください。すでに業務用VPNを利用している端末では、OSの制限の範囲内で併用できるかを先に確認します。併用方法がわからなくても、一時的なテストのために組織で必要なネットワーク設定を削除しないでください。元に戻す方法も含めてクライアントを選びましょう。たとえば、古いクライアントのローカルファイルは残しつつ、2つのクライアントが同じシステムプロキシを同時に変更しないようにします。

移行時は機能より先に形式を比べる

メンテナンスが終了したClash for WindowsやClashX Metaから移行する場合は、まず使える設定ファイルを書き出し、重要なプロキシグループの選択を記録してください。新しいクライアントにはコピーを読み込み、コアが読み込めることを確認してから、グループ名、ノードの種類、ルールの適用状況を比較します。旧画面のスタートアップ、ポート、システムプロキシ、サービスモードは、多くの場合アプリ固有の設定です。YAMLと一緒に移行されるとは考えないでください。同じ設定が旧クライアントでは動作し、新しいクライアントでエラーになる場合は、最初に互換性のない項目を確認し、コアの違い、クライアントによる上書き、サブスクリプション形式の違いを切り分けます。機能の詳しい場所はクライアント選びのガイドと照らし合わせてください。動作する基準状態を確保してから、残りの設定を移行するか決めましょう。

利用できるサブスクリプションがない場合は、第6章のローカルサンプルで設定、ルール、ログの3つの画面を確認できます。サービスを契約したり、日常の通信を出所不明の出口に流したりする必要はありません。このサンプルは直接接続と拒否の違いを確認するためのもので、プロキシプロトコルへの対応確認には使えません。明確な提供元からサブスクリプションを入手したら、コピーを使って必要なプロトコル、プロキシグループ、ルールプロバイダーをテストしてください。「インポート成功」と表示されただけでは、クライアント選びの確認は完了しません。

03 インストール:パッケージの選択と初期状態の確認

デバイスのアーキテクチャとOS環境を確認する

ダウンロードする前に、使用する端末のシステム情報を確認してください。別の端末向けパッケージを参考に選ぶのは避けましょう。Windowsでは「設定」の「バージョン情報」でシステムの種類を確認します。macOSでは「このMacについて」でAppleシリコンかIntelプロセッサかを確認してください。Linuxではターミナルで uname -m を実行し、現在の環境が報告するマシンアーキテクチャを確認できます。よくある結果は x86_64 と aarch64 です。ディストリビューションに合ったパッケージ形式も選ぶ必要があります。アーキテクチャとパッケージ形式は別の条件です。CPUが一致していても、あるディストリビューションのパッケージが別のディストリビューションで使えるとは限りません。該当OS向けのビルドがない場合は、同じOSに対応する別のクライアントを選び、名前が似たファイルを試しにインストールするのはやめましょう。

Androidで複数の選択肢がある場合は、端末が対応するアプリのアーキテクチャを確認してから、適切なパッケージを選んでください。すべてのクライアントに汎用パッケージがあるわけではありません。iOSではダウンロードページのストアリンクから詳細を開き、対応OSバージョンはストアの表示で確認してください。Androidではインストール時に、現在の入手元からのアプリインストールを許可する必要がある場合があります。これはVPN接続時の許可とは別の操作です。デスクトップでセキュリティ警告が出た場合は、ファイルの入手元と該当するリリース情報を確認してください。組織の管理ポリシーでインストールが制限されている場合は、承認された方法を使い、OSや組織の保護機能を無効にしないでください。

初回起動時は通信の入口を変更しない

起動したら、設定、プロキシグループ、接続、ログの各画面を開けることを確認してください。デスクトップでは、クライアントが設定を読み込む前に端末全体の通信が変わらないよう、まずシステムプロキシとTUNをオフにしておきます。この時点で、元のシステムプロキシやVPNの状態を記録してください。特に会社の端末では、自動設定のURLも控えておきましょう。ほかのプロキシクライアントをインストールしたことがある端末では、古いプログラムがシステムトレイ、メニューバー、バックグラウンドに残っていないか確認します。ウィンドウを閉じることとプロセスを終了することは同じではありません。複数のプロセスがポートを取り合ったり、システムプロキシを交互に書き換えたりすると、接続が不安定になることがあります。

ログにポートの競合が表示された場合は、エラーに記載されているポート番号を確認してください。混合ポートはリクエストを受け付けるためのもの、コントローラーのポートは画面や制御プログラムから使うものです。混同しないようにしましょう。古いクライアントがポートを使用していると確認できたら、まず古いプロセスを終了し、現在のコアを再起動します。併用が必要な場合は、実際に有効になっている待ち受け設定を変更し、そのポートを使うアプリ側もあわせて変更してください。ブラウザーの接続先だけを変えてコアの待ち受け設定を変えない場合や、設定ファイルだけを変更して画面側の上書きを残す場合は、接続拒否が続きます。ローカルアプリを接続するために、ついでにLANからのアクセスを有効にしないでください。最初のローカルテストにはループバックアドレスだけで十分です。

インストールの問題と接続の問題を分ける

アプリが起動しない場合は、まずOSのエラーメッセージを記録し、アーキテクチャ、OS要件、インストールパッケージの種類を確認します。アプリは開くのにコアが起動しない場合は、コアの起動ログ、設定の解析、ポートのバインドを調べてください。コアが想定したアドレスで待ち受けていることを確認してから、サブスクリプションや接続の調査に進みます。モバイル端末でVPNをまだ許可していない場合、接続画面に通信が表示されないのは正常です。設定を読み込んでおき、テストリクエストを送る段階で許可できます。起動時に自動起動する設定を有効にした場合は、確認が終わったあとに一度再起動し、クライアントと入口のスイッチが意図した状態になっているか確認しましょう。

初回インストールの完了にベンチマークは必要ありません。安定して起動し、設定とログの場所がわかり、システム設定が変更されたか説明できれば次に進めます。システムプロキシを一度試した場合は、オフにしたあとOSのプロキシ設定画面が実際に元の状態に戻っているか確認してください。終了後にインターネットへ接続できない場合は、まずシステムが、すでに待ち受けを停止したローカルポートを参照していないか調べます。企業や大学のネットワークで元からプロキシが必要な場合は、すべてオフにするのではなく、事前に記録した設定に戻してください。インストール前の接続状態を復元できてこそ、安心してルールのテストを進められます。

04 サブスクリプションと設定:追加・有効化・バックアップ

インポートするデータと信頼範囲を確認する

クライアントには通常、URLからのリモートインポートとローカルファイルのインポートがあります。リモートURLは提供元の更新を反映しやすく、ローカルファイルは内容を固定したり、テスト用コピーを保存したりするのに適しています。完全な設定には、プロキシグループ、ルール、DNSが含まれることがあります。そのため、出所不明の設定は単なるノード一覧ではありません。インポート前にURLが想定した提供元のものであることを確認してください。サブスクリプションURLには利用者情報やアクセス認証情報が含まれることがあります。公開の設定変換サイト、スクリーンショット、問い合わせフォームなどに貼り付けないでください。形式の確認を依頼する場合は、認証情報、サーバーアドレス、プライベートドメインを削除した一部だけを共有し、フィールド名、インデント、実際のエラー箇所は残してください。

設定画面でリモート設定を追加し、サブスクリプションURLを入力して保存します。ダウンロード後、提供元の名前と設定の種類を確認し、その設定を選択してコアの読み込み結果を確認してください。インポート成功、一覧での選択、コアの読み込み成功は、それぞれ別の段階です。クライアントによっては、選択と読み込みの間に適用や再読み込みが必要です。通知の成功表示だけで設定が有効になったと判断しないでください。プロキシグループ画面に必要なグループがあるか、ルール画面に判別できるルールがあるかを確認し、新しい接続をひとつ送って検証します。選択後も前の設定のグループが表示される場合は、ログに戻って読み込み失敗や元の状態への復帰がないか確認してください。

ダウンロード・解析・読み込みの3段階で調べる

ダウンロードに失敗した場合は、まず現在のネットワークからサブスクリプションサービスにアクセスできるか確認し、URLの有効期限、認証制限、端末の時刻も調べます。サービスがログイン画面やエラーページを返すことがあります。この場合、通信自体は完了していても、本文は設定ファイルではなく、次の段階で解析エラーになります。更新用URLの接続にプロキシが必要な場合は、クライアントのインストール直後や設定破損時に、起動順序の問題が起きることもあります。以前動作していたローカルコピーで接続を復旧してから更新し、出所不明のサブスクリプションURLに次々と置き換えるのは避けてください。ほかのエラー例はサブスクリプションのインポート失敗チェックリストを参照してください。

解析に失敗した場合は、最初のエラーとその前後の行を確認してください。YAMLのインデントにはスペースを使い、同じ階層で揃えます。ルール一覧では、各項目のリスト記号を残してください。フィールド名の誤り、存在しないプロキシグループへの参照、ドキュメント構造自体の解析失敗は、それぞれ異なる種類の問題です。解析は成功しても読み込みに失敗する場合は、コアが対応するフィールド、プロトコル、外部ルールリソースを確認します。プロキシグループに利用可能なメンバーがないとログに表示されたら、そのグループが設定内に実在する名前やプロバイダーを参照しているか確認してください。すぐにグループを削除すると、別のルールから参照されている場合、エラーが次の箇所に移るだけかもしれません。

リモートの原本・ローカル上書き・バックアップを分ける

リモートの内容を長期的な手編集用ファイルとして使わないでください。サブスクリプションの更新でファイル全体が置き換わり、独自のルールやコメントが消えることがあります。クライアントが個別の上書きに対応している場合は、ローカル変更をそちらに保存し、元のルールより前に挿入されるのか、末尾に追加されるのか、項目全体を置き換えるのかを先に確認してください。上書きに対応していない場合は、ローカル作業用のコピーを別に保管し、更新のたびに必要な変更を手動で統合します。バックアップは、最後に動作確認した原本、ローカルの上書き、未検証の試作を区別してください。認証情報を含む原本は、アクセスを制限した場所に保管します。複数の設定の使い分けはProfileと複数設定の管理をご覧ください。

05 プロキシモード:ルール・グローバル・直接接続

モードは出口の判定を変える。入口は変わらない

ルールモードは設定順にルールを確認し、接続先に応じて出口を振り分けます。日常利用に適したモードです。グローバルモードは、コアに入った接続をグローバルポリシーの選択先に送るため、ルールによる違いを一時的に比較するのに使えます。直接接続モードでは、コアに入った接続が接続先に直接アクセスするため、プロキシ経由の通信と比較できます。モードを切り替えてもシステムプロキシは自動で有効にならず、システムプロキシを使わないアプリがコアに入るわけでもありません。グローバルモードは端末全体の通信を制御することと同じではなく、直接接続モードもクライアントの終了を意味しません。あるアプリの動作が3つのモードすべてで同じなら、まずそのアプリの接続がクライアントに表示されるか確認してください。モードの切り替えを続けるのはそのあとです。

コアに入った接続の出口の選び方
モード判定方法確認ポイント
ルール最初に一致したルールのポリシーを使用一致したルール、ポリシーグループ、グループ内のメンバー
グローバルグローバルグループで現在選択されている項目を使用グローバルグループの選択先がノード、サブグループ、直接接続のどれか
直接接続コアが接続先に直接接続直接接続時の名前解決と到達性

同じ接続先で比較する

デスクトップでは、まずシステムプロキシに従うブラウザーを使うか、テストツール単体でローカルプロキシを明示的に使います。アクセス権のある、状態が比較的安定した接続先をひとつ選んでください。接続画面を開き、接続先、時刻、プロキシモード、適用ポリシー、実際の出口を記録します。ルールモードでテストする場合は、接続先が専用ルールに一致したのか、末尾のフォールバックに一致したのかを確認します。入口と設定を変えずにグローバルモードへ切り替え、グローバルグループで実際に選ばれている出口を確認してから、新しいリクエストを送ります。既存のWebページの持続接続、キャッシュ、バックグラウンドでの再試行が比較を妨げることがあります。必要に応じて該当するページやアプリを閉じて再試行してください。システム全体のネットワーク設定を消去する必要はありません。

グローバルモードではアクセスでき、ルールモードではできない場合でも、ルールの構文が誤っているとは限りません。ルールは正しく適用されているものの、別のグループに振り分けられた、またはそのグループで利用できない出口が選択されている可能性もあります。まず2つのリクエストで最終的に選ばれた出口を比べ、それからルールの選択か出口自体を調べます。どちらのモードでも同じノードを選んでいて結果が異なる場合は、別の接続先や古い接続が比較に混ざっていないか確認してください。Webページはメインドメインだけでなく、複数のサブリソース用ドメインにもリクエストを送ることがよくあります。メインページが開いても、API、画像、ログイン用リソースがすべて同じルールで転送されるとは限りません。実際に失敗した接続を基準に確認してください。

ノードのテストとサービスの動作確認の違い

クライアントの遅延テストは通常、特定のテスト先を対象とするもので、すべてのサイトやプロトコルで問題なく使える証明にはなりません。テスト先への応答が速いノードでも、実際のアプリのアップロード、長時間接続、特定の接続先で同じように動作するとは限りません。テスト失敗の原因がテスト先にアクセスできないことであり、ノードがすべての接続先で使えないわけではない場合もあります。グループ内の出口を切り替える場合は、まず同じテスト先での結果を記録し、実際に使う接続先でも再確認してください。自動選択グループでは、テスト先、間隔、現在の選択先を確認します。2回の手動確認の間に出口が切り替わっている可能性があるため、グループ名だけで経路が一定だと判断しないでください。

初回接続の具体的な操作はノードの選び方・遅延テスト・接続確認を参照してください。比較が終わったら普段使うモードに戻し、テスト中に変更したグローバルグループも確認します。出口は外部のIP確認サービスでしか判断できない場合、そのサービスが確認するのは現在の1つのリクエストだけで、端末のすべての通信を表すわけではありません。クライアントの同じ接続記録とあわせて出口を確認するほうが有効です。接続記録の内容を安定して説明できるようになってから、自分のルールを作成しましょう。

06 ルール分岐:構文・順序・ローカルテスト

具体的な条件を先に、フォールバックを最後に

多くのルールは、種類、マッチ条件、適用するポリシーをカンマで区切って記述します。たとえば、DOMAIN,example.org,DIRECT は完全一致するドメインを対象にします。DOMAIN-SUFFIX,example.org,DIRECT はサブドメインも対象にできます。キーワードマッチは対象範囲が広く、同じ文字列を含む別のドメインにも一致することがあります。使用する前に対象の範囲を明確にしてください。ポリシーには DIRECT、REJECT、設定内に実在するプロキシグループなどを指定できます。Web上の例にある Proxy は単なるグループ名の場合が多く、どのサブスクリプションにも存在するとは限りません。グループ名の大文字・小文字、空白、参照関係を現在の設定に合わせてください。

コアはルールを上から順に確認し、一致するとその項目を使います。より具体的な条件を求めて下へ進むことはありません。例外となる完全一致のドメインを先に置き、そのあとにサフィックスや地域分類など広い条件、最後に MATCH のフォールバックを置きます。同じドメインのサフィックスルールより後ろに例外ルールを置くと、どちらの条件も設定されていても、例外は適用されません。トラブル対処では、対象ドメインがファイルに書かれているかだけでなく、それより上に広い条件があり、先にリクエストを捕捉していないかも確認してください。クライアントの上書き機能がルールを末尾に追加するだけの場合は、既存の MATCH より前に配置できるかも確認しましょう。

独立した設定で優先順位を検証する

以下はmihomo互換クライアントで読み込める最小構成の例です。待ち受けはローカルのみで、サブスクリプションやプロキシノードは必要ありません。元の設定を保存してから、この例をローカルのYAMLファイルとして別名で保存してください。読み込み後、モードがルール、ポートが 7890 であることを確認します。ポートが使用中の場合は空いているポートを選び、下の2つのコマンドもあわせて変更してください。クライアントにポートやモードの上書き設定がある場合は、画面と起動ログに表示される実際の値を優先します。テスト中はシステムプロキシやTUNを有効にする必要はありません。コマンドはHTTPプロキシに対応するcurlを使用します。PowerShellで curl が別名として認識される場合は、curl.exe を使ってください。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - DOMAIN,example.org,REJECT
  - DOMAIN-SUFFIX,example.org,DIRECT
  - MATCH,DIRECT
curl -I --max-time 10 --proxy http://127.0.0.1:7890 https://example.org/
curl -I --max-time 10 --proxy http://127.0.0.1:7890 https://example.com/

最初のコマンドは完全一致するドメインの拒否ルールに一致し、プロキシトンネルの確立失敗が表示されることがあります。2つ目は末尾のフォールバックを通り、応答があるかどうかは現在のネットワークから接続先にアクセスできるかによります。最初の2つのルールを入れ替えて再読み込みし、1つ目のコマンドをもう一度実行してください。今度はログに拒否ではなく、サフィックスルールによる直接接続が表示されるはずです。期待する応答コードではなく、2回のログでポリシーがどう変わったかを基準に判断します。どちらもローカルポートに接続できない場合はインストールの章に戻って待ち受けを確認してください。ポートには接続できるのにポリシーの違いが表示されない場合は、現在の設定、モード、クライアントが上書きを保存しているかを確認します。

ドメインルール・アドレスルール・外部データを区別する

ドメインルールはコアがドメイン名を取得できることを前提とし、アドレスルールは接続先のIPアドレスを参照します。接続先がIPアドレスとしてしか認識されない場合、ドメインサフィックスを正確に書いても役立たないことがあります。反対に、ドメイン名を含むリクエストでも、一部のIPルールは追加の名前解決を行う場合があります。no-resolve に対応するルールタイプでは、このパラメーターを使って、そのルールの判定だけを目的とする名前解決を避けられますが、DNS自体を無効にするものではありません。GeoSiteとGeoIPは、それぞれドメイン分類データとアドレス分類データに依存します。分類が存在するか、どの項目が含まれるかは、実際に読み込まれたデータによって異なります。ルールをまとめて更新したあとに誤った振り分けが起きた場合は、適用された項目とデータの出所を確認し、広すぎるルールで差異を覆い隠さないでください。GeoIP・GeoSiteデータの更新もご覧ください。

07 TUN:通信の対象範囲・権限・元に戻す方法

入口を切り替える必要があるのはどんなときか

デスクトップのシステムプロキシは、システムプロキシ設定に従うアプリを主な対象とします。独自のネットワークスタックやプロキシ設定を持つプログラム、通常のHTTPプロキシでは転送できない通信が必要なプログラムもあります。そのような場合、TUNは仮想ネットワークインターフェースとルーティングを通じてより多くの通信を受け取り、設定に従ってコアに処理させることができます。実際に取り込まれる範囲は、本機のルート、除外設定、OSの制限、ほかの仮想ネットワークインターフェースの影響を受けます。スイッチの状態だけで端末のすべての通信が対象になったとは判断できません。モバイル端末では通常、システムのVPNインターフェースが通信を受け持ちます。システムアイコンはインターフェースの確立を示すだけで、すべての接続が特定のプロキシノードを経由する証明にはなりません。

プロキシが必要なのがブラウザー1つだけで、現在のシステムプロキシで要件を満たせるなら、簡単な入口のままにしておけます。どのアプリがコアに入っていないか明確な場合や、特定の種類の通信を検証する必要がある場合に限り、TUNに切り替えて比較してください。操作前に、システムプロキシの元の状態、現在の設定、安定して再現できる接続先を記録し、重要な通信が実行中でないことを確認します。組織が業務用VPNを導入している場合は、併用可能な方法やテスト環境を先に確認してください。2つの仮想インターフェースがルートを取り合う状態で、スイッチを何度も切り替えると、比較できるテスト結果が得られなくなります。

ひとつずつ有効にしてルーティングを確認する

デスクトップでは、追加の権限、補助サービス、システムのネットワーク許可が必要になることがあります。具体的な方法は、クライアントの案内とOSの要件に従ってください。比較用のシステムプロキシをオフにし、動作確認済みの設定を残した状態でTUNを有効にします。コアのログでインターフェース作成とルート設定が成功したか確認してください。クライアントによっては自動ルーティングとネットワークアダプターの自動検出があります。前者は仮想インターフェースへ通信を誘導し、後者は実際の出口を識別するためのものです。複数のネットワークアダプター、テザリングへの切り替え、別のVPNがある場合、自動選択が期待どおりとは限りません。まず現在選択されているインターフェースと実際の接続状態を確認し、同じ調査中にプロトコルスタックやDNSの設定まで変更しないでください。

検証では、システムプロキシ経由で接続できていた通信をひとつ、以前はシステムプロキシに従わなかった通信をひとつ、それぞれ実行します。次に、維持する必要があるローカルリソースへの接続もテストしてください。最初の2つは、入口を変更したことで期待する違いが現れたかを接続画面で確認できます。ローカルリソースは必要な直接接続やルート除外が引き続き有効かを確かめるためのものです。ルールに DIRECT を指定するのは、コアが受け取った通信を直接転送するという意味です。ルート除外では、通信がコアに入らないことがあります。ログ、確認できる接続先、トラブル対処の箇所はそれぞれ異なります。ローカルリソースを復旧させるために広範囲のアドレスを除外したり、もともと対象にする必要のない本機のサービスをテスト通信に加えたりしないでください。

DNSと正常終了をそれぞれ確認する

TUNを有効にしたあと、ドメイン名での接続だけ失敗する場合は、まず名前解決のログとルーティングを確認し、次にクライアントのDNS設定とOSの名前解決経路を調べてください。同じサービスのIPアドレスへ直接接続しても、比較として適切とは限りません。HTTPSでは証明書の検証や仮想ホストの選択に正しいドメイン名が必要になることがあります。ローカル機器名、イントラネットの名前解決、ログインポータルを使うネットワークでは、TUNの有効化前後でそれぞれテストするのが特に有効です。カスタムDNS転送やDNSの取り込み方を変更する前に、初期設定の動作するコピーを保存しておきます。異常を再現したら、初期設定に戻してから変更はひとつだけにしてください。仕組みの詳しい比較はTUNモードとシステムプロキシの比較を参照してください。

元に戻すときは、まずクライアントでTUNを無効にし、OSのルートが復旧するまで待ってから、以前直接接続できていた接続先をテストします。最後に必要に応じて、元のシステムプロキシに戻してください。クライアントが異常終了した場合は、仮想インターフェースやアプリの管理サービスがまだ動作していないか、OSが終了済みのローカルプロキシポートを参照していないか確認します。業務用ネットワークでルートテーブルを消去したり、別のVPN設定を削除したりしないでください。正常終了と異常終了の違いを記録しておくと、問題がコア、サービスの後処理、OSのネットワーク状態のどこにあるかを判断しやすくなります。

08 日常のメンテナンス:更新・再テスト・復旧

更新対象を4種類に分ける

クライアントの更新では画面や権限処理が変わることがあり、コアの更新では解析や機能の動作に影響する場合があります。サブスクリプションの更新ではノードやルールが変わり、ルールデータベースの更新では分類結果が変わることがあります。これらを一度に更新する必要はありません。互換性のために同時更新が必須でなければ、現在の動作状態を記録し、1つ更新するごとに再テストしてから次に進みましょう。特に「更新後、一部のサイトにしかアクセスできない」場合、最後に変更したのがサブスクリプションか地域データベースかを把握しているほうが、設定項目の名前をすべて暗記するより役立ちます。自動更新に対応する画面では、更新される範囲と現在の設定が再読み込みされるタイミングを確認してください。

バックアップには、現在の設定ファイル、ローカルの上書き設定、忘れやすい設定を含めます。たとえば、プロキシグループの選択、入口のポート、自動更新の動作などです。サブスクリプションの認証情報や復元可能なノード情報は、アクセスを制限した場所に保管し、一般的なスクリーンショットと一緒に同期したり公開したりしないでください。入口を有効にする前のシステム設定も記録して、終了後に戻せるようにします。読み込み方がわからなければバックアップは役に立ちません。通信に影響しないタイミングでバックアップのコピーを読み込み、画面が認識するか、参照先のリソースが使えるかを確認してから元の設定に戻せます。外部ルールリソースの内容は変わるため、YAMLのバックアップだけで依存関係をすべて保存できるわけではありません。

影響範囲から問題を絞り込む

特定のWebサイトだけ失敗する場合は、その接続先と失敗したサブリソースのログを確認し、ポリシーと出口を調べます。特定のアプリだけ失敗する場合は、システムプロキシに従うか、独自のプロキシ設定があるか、新しい接続が記録されているかを比較します。クライアントを有効にしたとき端末全体が接続できなくなる場合は、システムプロキシのポート、TUNインターフェース、ルートを確認してください。同じネットワークのほかの端末でも接続できず、同じ設定を使っていない場合は、上位のネットワークを先に確認します。設定切り替え、ネットワーク変更、TUN有効化、DNS変更を同時に行わないでください。たまたま復旧しても、何が効いたのかわからなくなります。

失敗を記録するときは、試した時刻、現在の設定、入口、モード、接続先、適用ポリシー、最終的な出口を記載します。新しいリクエストを1つずつ送ると識別しやすく、ブラウザーのバックグラウンド接続に埋もれにくくなります。クライアントが対応していれば、手がかりを得るためにログレベルを一時的に上げ、原因を特定したら通常のレベルに戻してください。ドメイン名、端末情報、内部アドレス、サブスクリプションIDを含むログをそのまま公開してはいけません。外部に共有するときは、正確なエラーの種類と必要な項目を残し、実際の環境を特定できる値を削除してください。同じエラーが続く場合は、代表的なログを1、2件示すほうが、長い重複ログより伝わりやすくなります。

動作状態に戻してから原因を調べる

トラブルが日常業務に影響する場合は、不確かな状態で試行を重ねず、最後に動作を確認した設定、モード、入口に戻します。システムプロキシが待ち受けを停止したポートを参照しているとわかったら、まず元の設定に戻してください。TUNの問題なら、前章の順序に従って終了し、通常の接続が復旧したことを確認します。復旧後、同じ接続先で再テストしてから実験用の設定を複製して調査を続けます。リモートルールを使う設定では、起動時に外部からのダウンロードが必要なことがあります。完全な再起動後のテストと、設定だけをすぐに切り替えたテストは分けて記録してください。結果が異なる場合は、キャッシュ、バックグラウンドサービス、起動順序が影響している可能性があります。

よくある問題はダウンロードページのFAQと使い方ガイドで、インストールや初回接続の手順を確認してください。日常のメンテナンスで多くの速度テストを行う必要はありません。次の3種類のサンプルを残しておけば十分です。直接接続されるべき通信、指定したグループを通るべき通信、必ず使える必要があるローカルリソースです。更新後は新しい接続でこの3点を確認し、前回からの変化を記録してから設定を調整するか判断しましょう。

09 応用編:ルールセット・DNS・管理された導入

単独のルールから管理しやすいルールセットへ

手書きのルールで要件を満たせるうちは、順序と例外を整理することを優先してください。ルールが増えてきたら、mihomo互換のルールプロバイダーを使い、ドメインやネットワーク範囲をまとめて管理する方法を検討します。導入前に、内容の種類、リソース形式、更新タイミングを確認し、プロバイダーの動作設定がリストの内容に合っていることを確かめてください。外部ルールをメインのルール一覧に追加する場合も、参照位置によって優先順位が決まります。リモートのリストが長くても、その前に一致したルールより優先されるわけではありません。ルールセットの前に明確なローカル例外を少数置き、末尾には既定のポリシーを明記します。取り込んだルールセットごとに、出所と用途を記録してください。

リモート依存が増えるほど、キャッシュのない状態で起動したときの動作確認が重要になります。キャッシュがある状態で読み込めても、新しい端末で初回からダウンロードできるとは限りません。導入前に、独立したテスト用設定や新しい環境を使い、リソースを取得できるか、読み込み失敗がログにどう表示されるか、基本的な接続を復旧できるローカル設定が手元にあるかを確認してください。キャッシュ切れを試すために、使用中のクライアントのデータをすべて削除しないでください。別のテスト環境を使えば、サブスクリプション、グループの選択、システム復旧情報まで一緒に消すことを防げます。利用中のクライアントがリモートリソースをどう更新するかも確認してください。コアが対応しているからといって、画面側も同じ方法で設定を保存できるとは限りません。

具体的な問題をもとにDNSを調整する

DNSの調整は、イントラネット専用ドメインの名前解決に失敗する、接続先が想定外の名前解決経路を使っているなど、再現可能な問題から始めてください。アプリが独自の暗号化DNSを有効にしているか、OSがどのリゾルバーを使っているか、コアが接続を処理しているかを記録してから、どの層を変更するか決めます。一部のクライアントでは特定のドメインに対して名前解決サービスを指定できます。イントラネットと外部ネットワークの境界が明確な場合に便利ですが、ルールの適用順と初期の名前解決経路もあわせて確認してください。リモートの名前解決サービスへの接続にドメイン名の解決が必要なのに、利用可能な初期経路がない場合、クライアント起動時のすべての問い合わせが失敗することがあります。

応用設定でよく使われるFake IPは、コアが後続の接続で元のドメインを識別できるよう、アプリに関連付け用の合成アドレスを返します。これらは接続先サービスの実際のアドレスではありません。表示されても、名前解決サービスが誤った結果を返したとは限りません。アプリが実際のアドレスやイントラネット名の解決を必要とする場合は、まず個別のドメインとアプリで互換性を比較してから、フィルター項目を変更してください。外部DNSの確認サイトでわかるのは、そのページが発生させた問い合わせ経路だけで、ほかのアプリや別の通信入口まで説明できるわけではありません。ClashのDNSリークを確認するには、誰が名前解決する想定なのか、実際には誰が行っているのか、同じアプリと同じ入口を比較しているのかを明確にしてください。

GUIクライアントからコア単体の運用に切り替えるタイミング

自分で管理するLinuxホストやルーター機器で固定設定を使い、サービスログを確認したり、起動順を制御したりする必要がある場合に限り、mihomo単体の導入を検討してください。まず本機のループバックアドレスで待ち受けて設定とルールを検証し、プロキシ入口とコントローラーの用途をそれぞれ確認してから、信頼できるネットワークに公開する必要があるか判断します。待ち受け範囲は小さく保ち、コントローラーやプロキシポートをインターネットに直接公開しないでください。設定ファイルにサブスクリプションやノードの認証情報が含まれる場合は、読み取り権限を制限します。ほかの端末の通信を取り込む前に、終了や再起動後にルートが復旧することを確認し、機器を直接管理する手段を残してください。個人のデスクトップやスマートフォンで使うだけなら、GUIクライアントでこのガイドの主要な操作をカバーできます。

応用設定を日常利用する価値があるか、小さな回帰テストで確認できます。再起動後に動作が復旧すること、直接接続とプロキシ経由の接続先がそれぞれ指定のポリシーに一致すること、サブスクリプション更新でローカル例外が上書きされないこと、入口を無効にしたあとシステムを元の状態に戻せることを確認してください。再現できない項目があれば、該当する章に戻って確認点を補い、原因をひとつの変数に絞り込みます。応用設定の基準は、設定ファイルの長さではありません。通信がその経路を通る理由を説明でき、想定外の動作が起きたときに安全に戻せることです。