Clash / mihomo

Clashのよくある質問

設定の読み込み、通信の取り込み、ルールの照合を切り分けましょう。症状に合った項目を選び、更新ログや接続一覧で問題が起きている段階を確認してください。

基礎知識

クライアント、コア、設定、通信の入口を区別しましょう。画面上でモードを選んでも、通信がコアに取り込まれたとは限りません。

Clashクライアントとmihomoコアの違いは?

クライアントは設定のインポート、プロキシグループの切り替え、接続状況の表示を担当します。mihomoコアは通信の受け入れ、ルールの照合、DNS処理を担当します。それぞれのバージョンは独立しています。メニューが見つからない場合は、まずクライアントのドキュメントを確認してください。設定項目が認識されない場合は、起動ログを確認し、実際に読み込まれているコアのバージョンを調べます。クライアントによってはコアを個別に更新するため、切り分け時は両方のバージョンを記録してください。クライアントを変更する場合は、サブスクリプション形式と使用プロトコルへの対応を確認してから設定を移行します。

サブスクリプションURL、config.yaml、ノードの違いは?

サブスクリプションURLは、設定やノード一覧を取得するためのアドレスです。完全なconfig.yamlには、ポート、DNS、ルール、プロキシグループなども含まれます。ノードは任意の接続先であり、設定ファイル全体の代わりにはなりません。インポート後にノードだけが表示され、想定したルールがない場合は、URLから完全なClash設定が返されているのか、ノード一覧だけなのかを確認します。そのうえで、サービス提供元の設定を使うか、ノードを既存の設定に追加するか判断してください。サブスクリプションURLにはアカウント情報が含まれることが多いため、スクリーンショットや公開ログに載せないでください。

ルール・グローバル・DIRECTモードの選び方は?

普段はルールモードを選びます。コアは設定内のルールを上から順に評価し、接続先を決定します。グローバルモードでは、コアに入った通信をGLOBALプロキシグループに渡すため、短時間の比較テストに適しています。切り替えた後は、そのグループでどの接続先が選択されているかも確認してください。DIRECTモードでは、コアに入った通信をプロキシ経由にしませんが、通信の取り込み自体は続きます。クライアントの有効時と無効時を比較するには、該当するシステムプロキシまたはTUNをオフにしてから、接続をやり直してください。

システムプロキシとTUNの違いは?両方有効にする必要はある?

システムプロキシは、OSのプロキシ設定を通じてリクエストをクライアントに渡します。対象となるのは、その設定に従うアプリだけです。TUNは仮想ネットワークインターフェースとルーティングを使って通信を取り込み、システムプロキシを使わないアプリにも対応しますが、OSの権限やルート設定が必要です。初めて設定するときはどちらか一方だけを有効にし、接続一覧で対象のリクエストがコアに届いているか確認してください。両方を有効にして問題が起きた場合は、どちらか一方をオフにして比較します。DNS、接続先、ルールを同時に変更しないでください。

インストールと設定

インポートに失敗したらサブスクリプションの更新ログを、起動に失敗したらコアのログを確認します。エラーの内容によって問題の箇所が異なります。

サブスクリプションのインポート手順
サブスクリプションの更新で401・403・404が表示される場合、無効かどうかの見分け方は?

まず更新ログでリクエスト結果を確認します。401は認証が必要、または認証情報が受け付けられていないことを示す場合が多く、403はリクエストが拒否されたことを示します。接続元がサービス側で制限されている可能性もあります。404はURLが変更された可能性があります。サービス提供元のアカウントページでサブスクリプションの状態と対応形式を確認し、新しいClashまたはmihomoのサブスクリプションURLをコピーしてください。新しい設定の動作を確認するまでは、古い設定を残しておきます。ログにHTTPステータスコードがなく、タイムアウトだけが記録されている場合は、サブスクリプションをリセットするのではなく、まずネットワーク接続を確認してください。

設定をインポートできたのに、ノード一覧が空なのはなぜ?

まず、インポートした設定が現在の設定として選択されているか確認します。次に起動ログを確認し、YAMLの解析エラー、未対応の項目、存在しないプロキシグループの参照がないか調べてください。proxy-providersを使用している場合、インポートの成功はメイン設定が読み込まれたことを示すだけで、リモートノードは別途取得する必要があります。クライアントのプロバイダーページで更新結果を確認し、ログインページやエラーページが返されていないか確認してください。ノードは取得できているのにプロキシグループが空の場合は、グループのuse参照とフィルター条件を確認します。

TUNを有効にすると権限不足と表示される場合、何を確認すればよい?

Windowsでは、クライアントのドキュメントでサービスモードのインストールと有効化が必要か確認し、サービスが実行中か調べてください。管理者権限が必要な場合は、明確に必要とされるインストールまたは起動の操作に限って許可します。Androidでは、システムのVPN設定でクライアントに許可を与え、ほかのVPNが接続を使用していないか確認してください。有効にしても失敗する場合は、ログに記録されたデバイスまたはルートのエラーを控え、クライアントが対応する範囲で関連設定を確認します。まずシステムのセキュリティ機能を無効にすることは避けてください。

起動時にmixed-portが使用中と表示される場合、ポートを変更してもよい?

変更できますが、まず別のインスタンスがそのポートを使用していないか確認してください。よくある原因は、古いクライアントがタスクトレイに残っていることや、GUIクライアントと独立したコアを同時に起動していることです。重複したインスタンスがある場合は終了し、通常の手順で再起動してください。複数のインスタンスを同時に使う必要がある場合は、それぞれに異なるローカルポートを割り当て、プロキシアドレスを手動設定しているアプリも合わせて変更します。最後にシステムプロキシが現在のインスタンスを指しているか確認してください。画面上は正常に動作していても、リクエストが古いポートに送られていることがあります。

使い方のヒント

現在の接続先と一致したルールを記録します。設定は一度に1つだけ変更し、接続をやり直して比較してください。

ローカルオーバーライドとマージ設定
Clashのノード速度テストがタイムアウトしたら、使えないと判断すべき?

必ずしもそうではありません。速度テストの結果は、そのノード経由で指定されたテスト先にアクセスした結果であり、すべての接続先での動作を示すものではありません。同じグループのほかのノードと比較し、実際にアクセスしたいサイトでもテストして、接続一覧で使用中の接続先を確認してください。テスト先が1つだけ失敗する場合は、そのアドレスに到達できるか確認します。1つのノードで複数の接続先へのアクセスが続けて失敗する場合は、ノードの状態やサービス提供元のお知らせを確認してください。一度の速度テストだけで設定を削除せず、同じネットワーク環境で再テストすると原因を特定しやすくなります。

ルールモードで、プロキシ経由にしたいサイトがDIRECTになるのはなぜ?

ルールは上から順に照合され、最初に一致した時点で適用するポリシーが決まります。接続一覧で該当リクエストを開き、一致したルールと最終的な接続先を記録してください。範囲の広いDIRECTルールに一致している場合は、より具体的なルールをその前に移動します。想定したルールに一致しているのにDIRECTになる場合は、該当するプロキシグループでDIRECTが選択されていないか確認してください。ログにドメイン名がなくIPアドレスだけが記録されている場合は、まずコアがドメイン情報を取得できているか調べ、安易にルールの範囲を広げないでください。変更後は既存の接続を閉じ、リクエストを再実行します。

サブスクリプションを更新すると、ローカルで変更したルールが消えるのはなぜ?

クライアントがサブスクリプションを更新すると、リモート設定のローカルコピーが新しい内容で置き換えられることがあります。コピーを直接編集すると、変更が失われます。カスタムルールは独立したオーバーライドまたはマージ設定として保存し、クライアントのドキュメントに従って対象のサブスクリプションに適用してください。優先して照合したいルールは、ルール一覧の先頭に追加します。MATCHの後ろに記述してはいけません。保存後は実行中の設定を確認し、新しいルールが存在すること、位置が正しいこと、参照先のプロキシグループが有効であることを確かめてから、サブスクリプションを手動更新して変更が保持されるか確認します。

TUNを有効にするとプリンターやNASにアクセスできない場合、どうすればよい?

まずTUNをオフにして、ローカルネットワークにアクセスできるか確認し、機器の実際のIPアドレスとサブネットを記録します。TUNを再び有効にしたら、IPアドレスを直接指定してアクセスしてください。IPアドレスでは接続できるのに機器名では接続できない場合は、ローカルネットワークのDNSまたは機器検出を確認します。IPアドレスでも接続できない場合は、ルートの重複がないか調べ、クライアントが対応する方法で実際に使用しているローカルネットワークのサブネットを除外してください。変更後はローカル機器と外部サイトを別々にテストし、プライベートアドレスの範囲を一括で除外しないでください。

トラブル対処

接続一覧に記録がない場合は、アプリの接続方法を確認します。記録がある場合は、ルール、接続先、DNSを調べてください。

DNS設定の参考情報
システムプロキシを有効にしてもアプリがClashを経由しない場合、どう切り分ける?

ブラウザーで新しいページを開き、クライアントの接続一覧を確認してください。ブラウザーの接続は記録されるのに対象アプリの記録がない場合、そのアプリがシステムプロキシを使っていないか、独自の設定を使用している可能性があります。アプリのプロキシ設定を確認するか、TUNを使って比較テストしてください。どちらの接続も記録されない場合は、システムプロキシのアドレス、待ち受けポート、コアの動作状況を確認し、古い自動プロキシ設定が残っていないか調べます。接続が記録されているのにDIRECTになる場合は、一致したルールとプロキシグループを確認してください。

ブラウザーは使えるのに、Windows UWPアプリからローカルプロキシに接続できない場合は?

アプリが127.0.0.1を指すシステムプロキシを使っている場合は、まず一般的なデスクトップアプリが同じポートを利用できるか確認します。一部のUWPアプリだけが失敗する場合は、AppContainerのローカルループバック制限が原因の可能性があります。クライアントにUWPループバック設定がある場合は、説明に従い、問題のあるアプリだけに例外を有効にしてから、そのアプリを完全に終了して再起動してください。設定を変更すべきか判断できない場合は、システムで許可されている範囲でTUNをテストします。組織の管理下にある端末では、管理者のポリシーに従ってください。

ClashのDNS漏れや、想定と異なるDNSの名前解決経路を調べるには?

まず、使用する想定の上流DNSリゾルバーと、ローカルDNSで解決するドメインを明確にします。通信を取り込む方式を一時的に1つだけにし、問題のドメインとテスト時刻を記録したうえで、クライアントのログとシステムのDNS設定を照合してください。ブラウザーのセキュアDNSは別の経路を使うことがあるため、同じネットワークで有効時と無効時を比較します。テストページに表示されたリゾルバーの所在地だけでは、DNS漏れの証拠にはなりません。実際のリクエスト経路と設定上の想定に基づいて判断してください。

Clashを終了した後もインターネットに接続できない場合、どうすれば復旧できる?

まずクライアントを再度開き、画面上でシステムプロキシとTUNをオフにしてから、通常の手順で終了します。クライアントを起動できない場合は、システムのネットワーク設定を開き、プロキシが待ち受けを停止したローカルポートを指したままになっていないか確認してください。今回有効にした設定だけを元に戻し、勤務先や学校で元から設定されていたプロキシは残します。DNSを手動で変更した場合も元の値に戻し、ネットワークに再接続して確認してください。ネットワーク設定をすべてリセットすると、既存の固定IPアドレスや内部ネットワークの設定が失われる可能性があるため避けてください。

Clashをダウンロード