RULE CORE
DESKTOP / 01
Windows
トレイ操作、システムプロキシの切り替え、GUIによるサブスクリプション管理が必要なデスクトップユーザーに適しています。ダウンロード前に「設定 → システム → システム情報」でx64デバイスか確認してください。インストールがシステムにブロックされた場合は、ファイルの入手元とセキュリティ警告の内容を確認し、セキュリティ保護全体を無効にしないでください。
CONFIG TRIAGE
まず問題の層を切り分ける
Clashの画面、コア、サブスクリプション、ルール、システムのネットワーク設定はそれぞれ別の層です。異常が起きたら、まず範囲を絞ってから設定を変更しましょう。一度に変更する変数を1つにすれば、どの手順が効果を発揮したのか確認できます。
DOMAIN-SUFFIX
ルールは上から順に評価され、最初にマッチした時点で停止します
ルール分岐は、あるリクエストをどのプロキシグループに渡すかを決める仕組みです。切り分けでは、まず接続ログから対象ドメインを見つけ、マッチしたルールの種類と宛先プロキシを確認します。リクエストが広範なルールに先にマッチすると、後続の詳細なルールは実行されません。調整時は、より具体的なドメインルールを広範なGEOIPやMATCHより前に置き、指定したプロキシグループ名が実際に存在することを確認します。ルールが正しいのに出口が期待どおりでない場合、問題は通常プロキシグループの層にあり、ドメインルールを繰り返し変更すべきではありません。
DOMAIN-SUFFIX,youtube.com,PROXY
PROXY-GROUP
出口を切り替えても、ルール自体は書き換わりません
プロキシグループはルールから割り当てられたトラフィックを受け取り、ダイレクト接続、固定ノード、自動選択、フォールバックのいずれを使うか決定します。ウェブページにアクセスできない場合は、まず接続ログが想定したプロキシグループに入っていることを確認し、そのグループの出口を手動で切り替えて比較します。1つのノードだけ失敗するなら、主にノードまたは回線の問題です。同じグループがすべて失敗する場合は、サブスクリプションの状態、プロトコルパラメータ、ローカルネットワークを確認します。プロキシグループ名を変更した場合はルールの参照先も確認し、リクエストが末尾のフォールバックに落ちていないか調べます。
- name: PROXY · type: select · proxies: [AUTO, DIRECT]
PROFILE
まずサブスクリプションのURLを検証し、次にクライアントの更新経路を確認する
サブスクリプション管理は、リモート設定を取得してローカル設定ファイルとして保存します。更新に失敗したら、まず有効期限とURLが完全か確認し、ダイレクト接続でURLにアクセスできるかテストします。ブラウザではアクセスできるのにクライアントで失敗する場合は、現在無効なプロキシ経由で更新しようとしていないか、システム時刻が正しいか、設定ディレクトリに書き込み権限があるかを確認します。更新後は新しい設定が有効になっていることも確認してください。ダウンロードに成功しただけで設定を切り替えていなければ、ノードとルールは古い状態のままです。
profiles → update → activate → reload
CLIENT / CORE
GUIクライアントが操作を担い、コアがトラフィックを処理します
Windows、macOS、Android、iOS、Linuxではクライアントの画面が異なりますが、基本的な流れは共通しています。設定を追加し、コアを起動し、モードを選び、システムプロキシまたはVPNによる接続を有効にします。プラットフォームを移行する際は画面上のボタン位置をそのまま当てはめず、まずクライアントが対応するコアと設定項目を確認してから、新しいプラットフォームでネットワーク権限を設定し直します。デスクトップではシステムプロキシとファイアウォール、モバイルではVPNの許可、省電力設定、バックグラウンド動作を重点的に確認します。
client UI → mihomo core → system proxy / VPN
PLATFORM ROUTES
現在のデバイスに合うクライアントを選ぶ
まずOSとプロセッサのアーキテクチャを確認し、対応するプラットフォームのクライアントを開きます。デスクトップ用インストーラー、モバイルアプリ、コマンドライン用コアは用途が異なるため、ファイル名が似ているだけで混用しないでください。
DESKTOP / 02
macOS
まず「このMacについて」でAppleシリコンかIntelプロセッサかを確認し、対応するインストーラーを選びます。初回起動時はシステム設定でアプリの権限を許可する必要がある場合があります。システムプロキシが有効なのにブラウザが直接接続する場合は、クライアントのコアが実際に動作しているか確認してください。
ダウンロードへMOBILE / 03
Android
AndroidクライアントはシステムVPNインターフェースを通じてトラフィックを処理します。初回接続時はVPNの許可を確認し、クライアントをバッテリー最適化の対象外にしてください。画面ロック後に切断される場合は、通常バックグラウンドプロセスがシステムによって終了されています。先にサブスクリプションやルールを変更する必要はありません。
ダウンロードへMOBILE / 04
iOS
iOSクライアントは初回接続時にVPN構成の追加を求めます。これはシステムがネットワークトンネルを構築するために必要な許可です。サブスクリプションを追加してもノードが表示されない場合は、まず内容が現在のクライアントに対応しているか確認し、次にモバイルデータ通信の許可とVPNの状態を確認します。
ダウンロードへDESKTOP / SERVER / 05
Linux
デスクトップ環境ではGUIクライアントを選べますが、サーバー、ルーター、コンテナ環境では通常Mihomoコアを直接使用します。インストール前にディストリビューション、CPUアーキテクチャ、パッケージ形式を確認してください。サービス起動後はまずログと待ち受けポートを確認してから、システムサービスと自動起動を設定し、「プロセスが動いていない」状態をルールの問題と誤認しないようにします。
FIRST CONNECTION
3ステップで初回接続を完了
初回設定では基本経路、つまり設定の入手元、出口の方針、システムによる接続の引き受けだけを扱います。高度なDNS、TUN、ルールの上書きは、基本接続を確認してから調整してください。
-
サブスクリプションまたはローカル設定を追加
クライアントの設定またはサブスクリプション画面を開き、完全なサブスクリプションURLを貼り付けて更新します。設定名、プロキシグループ、ノード一覧が表示されたら、その設定を現在の有効項目に切り替えます。更新に失敗した場合は、サブスクリプションが期限切れでないことを確認し、システムプロキシを無効にした状態でURLにアクセスできるかテストしてください。同じURLを何度も追加して重複設定を作ると、どの設定を使っているのか確認しにくくなります。
PROFILE → IMPORT → ACTIVATE -
ルールモードと出口の方針を選ぶ
新しい設定には通常、ルールモードと複数のプロキシグループが用意されています。まずルールモードは変更せず、メインのプロキシグループで利用可能な出口を1つ選びます。ノードの状態が不明な場合は、1つずつ切り替えて短時間の接続テストを行います。グローバルモードはルールが原因か一時的に判断する用途には向きますが、長期的な切り分け結果として使うものではありません。グローバルモードでは使えるのにルールモードで使えない場合は、接続ログに戻ってリクエストがどのルールにマッチしたか確認します。
MODE: RULE · GROUP: PROXY -
システムによる接続を有効にしてリクエストを検証
デスクトップではシステムプロキシを有効にし、モバイルではVPNの許可を確認します。システムプロキシに従わないアプリも処理する必要がある場合は、その後でTUNモードを検討します。接続後は、ダイレクト接続のサイトとプロキシが必要なサイトを1つずつ開き、クライアントの接続ログで両方のリクエストの方針を確認します。テスト後、特定のアプリだけ動作しない場合は、そのアプリが独自のプロキシやDNSを使っていないか確認し、すぐにクライアントを再インストールしないでください。
SYSTEM PROXY / VPN → CONNECTIONS
OPEN SOURCE CONTEXT
クライアント、コア、設定の関係を理解する
Clashは単一のインストールパッケージ名ではありません。実際の利用環境は、GUIクライアント、プロキシコア、サブスクリプション設定、システムのネットワークインターフェースで構成されます。それぞれの層の役割を理解すれば、誤った場所で同じ操作を繰り返さずに済みます。
Mihomoのソースコードリポジトリをクローン
git clone https://github.com/MetaCubeX/mihomo.git
プロジェクトの歩み：名称は受け継がれ、コンポーネントは分化
初期のClashは、ルールマッチング、プロキシグループ、プロキシプロトコル、制御インターフェースなどの基盤機能を提供していました。元プロジェクトの状況が変化する中、コミュニティでは保守が続くコアの派生版や複数のGUIクライアントが登場しました。現在、ユーザーが「Clash」と呼ぶものは、単一のプログラムではなく、設定とクライアントを含むエコシステム全体を指すことが少なくありません。ソフトウェアを選ぶ際は、Clashという名称だけでなく、クライアントの保守状況、使用するコア、対象プラットフォームを確認してください。
オープンソースエコシステム：画面は異なっても設定の基盤は共通
クライアントごとに、サブスクリプション、プロキシグループ、ログ、システムプロキシなどの操作入口は再構成されていますが、基盤はYAML設定、ルールマッチング、制御インターフェースです。この分業により、デスクトップ、モバイル、サーバーで異なる外装を選べます。一方で、ある画面の手順をすべてのクライアントにボタン単位で当てはめることはできません。プラットフォームを移行する際は、まず項目とトラフィック経路を理解し、その後で対応する画面上の場所を探してください。
コアの関係：Mihomoが実際のネットワークトラフィックを処理
Mihomoは、現在のClashエコシステムで広く使われている継続保守型のコアです。GUIクライアントは設定のダウンロード、プロキシグループの表示、制御インターフェースの呼び出し、システム権限の管理を担います。実際に接続を確立し、ルールを実行し、DNSと転送トラフィックを処理するのはコアです。クライアントが開けてもコアが正常に起動したとは限らず、ノード一覧があってもプロキシ経路が使えるとは限りません。異常時は、画面上の漠然とした通知よりコアのログのほうが障害箇所に近い情報を示します。
更新の仕組み：クライアント、コア、サブスクリプションを分けて確認
クライアントの更新は画面機能とプラットフォーム互換性を改善し、コアの更新はプロトコル、ルール、ネットワーク処理能力に関わります。サブスクリプションの更新はノードとサービス提供者の方針を置き換えます。3つは同じ更新経路ではありません。「更新後に使えない」場合は、どの層を更新したのか記録し、比較用に以前使えた設定を残してください。設定項目に互換性の変更がある場合は、まずクライアントの説明を読み、ローカルの上書きを項目ごとに移行します。
FAULT ORDER
再インストールを繰り返すより、決まった順序で切り分ける
1つ目はサブスクリプションの確認です。有効期限、更新結果、現在有効な設定を確認します。2つ目はコアの確認です。正常に起動したか、ポートが使用中でないか、設定の解析エラーがログにないかを調べます。3つ目はプロキシグループの確認です。接続ログから対象リクエストがどのルールとプロキシグループにマッチしたか判断します。4つ目はシステムによる接続の確認です。デスクトップではシステムプロキシ、モバイルではVPNの許可、TUNでは仮想NICと権限を確認します。DNSを調べるのは5つ目です。ドメイン解決の失敗、解決結果の不一致、接続段階の失敗を区別してください。
各手順を終えるたびに同じテストを行い、結果を記録します。ダイレクト接続のネットワーク自体が使えない場合は、まず基本ネットワークを復旧します。特定のノードだけタイムアウトするなら、優先してノードを変更します。すべてのノードが失敗するのにサブスクリプションは更新できる場合は、システム時刻、プロトコルパラメータ、ネットワーク制限を確認します。ブラウザは使えるのに特定のアプリだけ使えない場合は、そのアプリがシステムプロキシを迂回していないか調べます。この順序なら、同じ現象を検証可能な問題へ分解できます。
QUICK ANSWERS
よくある問題のポイント
Clashのサブスクリプション更新に失敗したら、最初にどこを確認する？
まずサブスクリプションの有効期限とURLが完全か確認し、現在のシステムプロキシを無効にして、ダイレクト接続でURLをテストします。ブラウザではアクセスできるのにクライアントで失敗する場合は、システム時刻、設定ディレクトリの書き込み権限、無効なプロキシ経由で更新していないかを確認してください。関連する項目の意味は用語集でも確認できます。
システムプロキシを有効にしているのに、一部のアプリが直接接続するのはなぜ？
一部のアプリはシステムプロキシを読み取らず、独自のネットワークスタックやDNSを使用します。まず接続ログでクライアントがそのアプリのリクエストを認識しているか確認してください。ログがまったくない場合は、問題はシステム接続の引き受け層にあるため、TUNモードを検討できます。ログはあるのに方針が正しくない場合は、ルールとプロセスのマッチングを確認します。
すべてのノードがタイムアウトする場合と、一部だけタイムアウトする場合の違いは？
一部のノードだけがタイムアウトする場合は、通常そのノードの状態や特定の回線が原因です。すべてのノードが同時にタイムアウトする場合は、サブスクリプションの失効、ローカルネットワーク、システム時刻、コアの未起動、プロトコルパラメータなどが考えられます。まずダイレクト接続で通常のウェブページを開けるか確認し、その後コアのログを確認してください。最初からDNSやルールを一括変更するのは避けます。
ルールモードは使えないのにグローバルモードではアクセスできる場合、次にどこを見る？
この場合、基本的なプロキシ経路はすでに確立している可能性が高いため、次にルールモードで対象ドメインにマッチしたルールとプロキシグループを確認します。広範なルールが先にリクエストを捕捉していないか、ルールが参照するプロキシグループが存在するか、そのグループで選択中の出口が利用可能かを重点的に確認してください。
FIELD NOTES
最近の使い方・トラブル対処記事
記事では具体的な症状ごとに、判断材料と操作手順をまとめています。ノードのタイムアウト、初回インストール、モバイルでの設定追加など、該当する場面から直接確認できます。
Clashのノードがタイムアウトして接続できないときの対処法：最短で確認する順番
まず全ノードのタイムアウトか一部ノードのタイムアウトかを分け、サブスクリプション、ダイレクト接続、システム時刻、コアの状態、プロトコルパラメータを順に確認します。各手順に明確な終了条件を設け、複数の設定を同時に変更しないようにします。
記事を読む →iOSでClashを使う：App Storeからの入手と設定追加の手順
クライアントの入手、初回VPN許可、サブスクリプション追加までの手順を説明し、サブスクリプションURLとローカル設定ファイルという2つの入口を区別します。追加後にノードが表示されない場合は、互換性とネットワーク権限から引き続き切り分けます。
記事を読む →Clashの初回インストール設定ガイド：全プラットフォーム共通の要点と注意点
インストーラーの選択、サブスクリプションの追加、システムプロキシの有効化まで、5大プラットフォームに共通する設定の流れを整理します。インストールのブロック、サブスクリプション追加の失敗、プロキシが反映されない問題を、それぞれの層で対処します。
記事を読む →