127.0.0.1 / よくある質問

Clashのよくある質問

設定をインポートできない場合はサブスクリプションとYAMLを、プロキシを有効にしても効果がない場合はリクエストがコアに届いているかを確認しましょう。該当するカテゴリを選び、項目を開いてください。

127.0.0.1

基礎知識

ソフトウェア、設定、通信の入口を整理しましょう。

Clashクライアント、Mihomoコア、サブスクリプションの役割は?

クライアントは設定のインポート、ログの表示、各種オプションの切り替えを担当します。Mihomoを採用したクライアントでは、リスニング、名前解決、ルール照合をMihomoコアが処理します。サブスクリプションは設定を取得する方法の一つで、クライアントをインストールしても自動で利用可能になるわけではありません。画面は開くのに接続できない場合は、まずコアが起動しているか、次に現在の設定が有効かを確認し、最後にノードを検証してください。設定の読み込み時点でログにエラーが出ている場合は、まずそのエラーを解消しましょう。ノードを切り替えても起動時の問題は解決しません。

127.0.0.1、192.168.1.1、0.0.0.0の違いは?

127.0.0.1は自分の端末を指すIPv4ループバックアドレスです。スマートフォンに入力すると、接続先はパソコンではなくスマートフォン自身になります。192.168.1.1はプライベートアドレスで、ルーターのゲートウェイとしてよく使われますが、実際の用途は端末のネットワーク設定によります。0.0.0.0をリスニングアドレスに指定すると、端末上のすべてのIPv4インターフェースにバインドされます。他の端末に設定するプロキシサーバーのアドレスではありません。端末内だけでプロキシを使う場合はループバックアドレスを指定し、LAN共有が無効になっていることを確認してください。

mixed-portとコントローラーポートは同じ用途で使えますか?

mixed-portはHTTPとSOCKSの接続に対応する、混合プロキシのリスニングポートです。external-controllerはコアの管理APIが待ち受けるアドレスを指定します。対応するパネルで状態を確認したり、ポリシーを切り替えたりするためのもので、ブラウザーの通信を中継する用途には使えません。アプリにプロキシを設定するときは、クライアントに現在表示されているリスニングアドレスとポートを使い、解説記事の例をそのまま転記しないでください。端末内だけで使う管理APIはループバックアドレスにバインドし、接続のトラブル対処のためにLANへ公開しないでください。

ルール・グローバル・DIRECTモードは、それぞれどの通信を処理しますか?

どのモードも、コアに渡された接続だけを処理します。ルールモードではルールを上から順に照合し、最初に一致したルールの宛先へ接続します。グローバルモードでは、グローバルポリシーで選択された出口を使います。DIRECTモードではプロキシノードを経由せず、コアから直接接続します。DIRECTモードにしてもクライアントは終了せず、アプリに設定済みのプロキシも解除されません。一時的にモードを切り替えると、ルールと出口のどちらに問題があるか切り分けやすくなります。テスト後は普段使うモードに戻してください。

mixed-port

インストールと設定

ファイルのインポートからコアの起動まで、順番に確認しましょう。

初回インストール後、インポートした設定が有効か確認するには?

クライアントの設定またはサブスクリプション画面から、ローカルのYAMLファイルかサブスクリプションURLをインポートします。設定名が一覧に表示されたら選択して適用してください。インポートが成功しても、ファイルを受け取っただけで、現在の設定に反映されたとは限りません。接続画面に戻り、直前に有効化した設定が表示されていることを確認します。次にプロキシグループから利用可能な出口を選び、アクセスできることが分かっているサイトをブラウザーで開き、接続ログで宛先ドメインと実際の出口を確認してください。

Clashのサブスクリプションを更新できない:URLの無効化と取得エラーを見分けるには?

まず、引き続き有効化できる古い設定を残し、更新ログを確認します。401、403、404が表示された場合は、サブスクリプション提供元のページでアカウントの状態、URLが変更されていないか、リクエスト元に制限があるかを確認してください。ステータスコードだけで期限切れとは判断できません。タイムアウトやドメインの名前解決エラーが表示された場合は、現在のネットワークからサブスクリプションサービスにアクセスできるかを確認し、次にクライアントがどの方法で更新しているかを調べます。設定ファイルではなくログインページが返ってくる場合は、サブスクリプションURLを再取得してください。確認作業中は、URL全体を公開のスクリーンショットに載せないでください。

YAMLのインポート時に解析エラーが出たら、まずどこを確認する?

まずログに表示された行番号とフィールド名を確認し、エラー行の一つ前も見てください。直前の行でコロンや引用符、インデントが抜けていることが原因の場合があります。インデントにはタブではなくスペースを使い、同じ階層のリスト項目は位置をそろえます。未定義のフィールドや未対応のプロキシ種別と表示された場合は、使用中のコアでサポートされるフィールドを確認してください。互換性の問題をインデントの問題と混同しないようにしましょう。設定のコピー上でのみ編集し、保存後に再読み込みします。コアが正常に起動したことを確認してから、普段使う設定を置き換えてください。

TUNの有効化時に権限不足や仮想ネットワークアダプターの作成失敗が表示されたら?

まずログを見て、仮想ネットワークアダプターの作成時とルート変更時のどちらで失敗しているか確認します。デスクトップ版では、クライアントの案内に従ってサービスコンポーネントをインストールするか、許可されている場合に管理者権限で起動し、クライアントのサービスが実行中か確認してください。モバイル版でシステムのVPNインターフェースを使って通信を取り込む場合は、システムの許可が必要です。ほかのVPNや仮想ネットワークアダプターを使用している場合は、ルートの競合がないか確認しましょう。組織の管理下にある端末では、独断で権限を緩和せず、まずアプリが対応するプロキシ設定でテストしてください。

DIRECT

使い方のヒント

新しい接続でルール、出口、名前解決の結果を確認しましょう。

ポリシーグループを変更しても、接続ログに以前のノードが表示されるのはなぜ?

接続の詳細に表示される、適用されたルールとポリシーグループ名を確認してください。ルールが別のグループを参照していたり、DIRECTを直接指定していたりすると、現在選択しているグループを切り替えても、その通信には反映されない場合があります。自動選択やフェイルオーバーのグループは、独自の速度測定結果や優先順位に基づいて出口を決めます。また、すでに確立した長時間接続は、以前の出口を使い続けることがあります。テスト用のページを閉じるか対象アプリを再起動して、新しいリクエストを送ってください。過去の記録だけでなく、新しく生成されたログで確認しましょう。

特定のドメインだけ開けない場合、DNSの問題かどうかを見分けるには?

まず、ログに出ているドメインの名前解決エラーと、名前解決後の接続タイムアウトを区別します。後者は必ずしもDNSの問題ではありません。ブラウザーだけで発生する場合は、ブラウザー独自のセキュアDNSが使われていないか確認してください。社内ネットワークのドメインでは、組織指定のDNSが必要かを先に確認し、公共DNSで安易に上書きしないようにしましょう。変更前の値を控え、一度に変更するDNS設定は一つだけにします。同じアプリで同じドメインに再接続すれば、どの変更が有効だったか判断しやすくなります。

同じLAN上のスマートフォンから、パソコンのプロキシポートを使うには?

LANアクセスは信頼できるネットワークでのみ有効にしてください。スマートフォンのプロキシアドレスには、パソコンがそのLANで使用しているプライベートIPv4アドレスを、ポートには実際に待ち受けているHTTPまたは混合プロキシのポートを入力します。パソコンのリスニング対象に該当インターフェースが含まれていることと、ファイアウォールがスマートフォンからの接続を許可していることを確認してください。アドレスとポートが正しいのに接続できない場合は、Wi-Fiでゲストネットワークの端末隔離が有効になっていないか確認します。スマートフォンのWi-Fiプロキシ設定は、すべてのアプリで使われるとは限りません。使い終わったら共有を無効にし、リスニングポートをインターネットに公開しないでください。

サブスクリプション全体を変更せず、特定のドメインのルールだけ変更するには?

クライアントがオーバーライドやマージに対応している場合は、独立したオーバーライド設定にカスタムルールを記述し、マージ後の順序を確認します。ルールモードでは最初に一致したルールが適用されるため、特定ドメインのルールは、先に一致する可能性がある広範なルールより前に配置してください。MATCHは最後のフォールバックとして残します。変更後は、指定したポリシーグループが実際に存在することを確認し、新しい接続を発生させてログを確認してください。クライアントにオーバーライド機能がない場合は、サブスクリプション設定のローカルコピーでテストできます。ただし、コピーには以後の更新が自動で反映されません。

127.0.0.1 / リスニング

トラブル対処

リクエストがコアに届いているか確認してから、次の原因を調べましょう。

ノードの速度テストがタイムアウトしたら、ノードが故障している?

速度テストのタイムアウトは、そのノードが設定されたテスト先へのリクエストを時間内に完了できなかったことを示すだけです。同じテスト先を使って別のノードと比較してください。一つのノードだけ失敗する場合は、そのノードの接続ログを確認します。複数のノードが同時に失敗する場合は、現在のネットワーク、テスト先にアクセスできるか、サブスクリプションの更新が必要かを確認してください。速度テストは成功するのに実際のアクセスに失敗する場合は、実際の接続が同じ出口を通っているか確認します。速度テストとアプリでのアクセスは宛先が異なることがあるため、結果を相互に代用することはできません。

システムプロキシを有効にしても、ブラウザーやターミナルがプロキシを使わないのはなぜ?

まず新しいリクエストを送り、クライアントのログを確認します。記録がまったくない場合は、システムプロキシのアドレスとポートがコアのリスニング設定と一致しているか調べてください。ブラウザーでは、拡張機能、個別のプロキシ設定、プロキシ除外リストも確認します。ターミナルのツールはシステムプロキシを読み込まない場合があるため、ツールのドキュメントに従ってプロキシ引数や環境変数が有効か確認してください。ログに該当する接続があれば、リクエストはすでにコアに届いています。システムプロキシを何度も切り替えるのではなく、適用されたルールと出口を調べましょう。

WindowsでUWPアプリだけローカルプロキシに接続できない場合は?

まず通常のデスクトップブラウザーで、同じローカルプロキシのアドレスとポートに接続できることを確認します。次に、問題のアプリがループバック制限の対象となるアプリコンテナーで実行されているか確認してください。ストアからインストールしたアプリが必ずこの制限を受けるとは限りません。コンテナーからループバックアドレスに接続できないことが確認できた場合は、端末の管理ポリシーで許可されているときに、クライアントが提供するループバック設定を使い、該当アプリだけを例外に追加します。その後、アプリを完全に終了してから再確認してください。この例外で変わるのはループバックへのアクセス権限だけです。もともとプロキシを読み込まないアプリが、自動的にプロキシを使うようにはなりません。

起動ログにポート使用中と表示された場合、どのポートを変更すればよい?

まずログでバインドに失敗したアドレスとポートを確認し、それを使用しているのが古いクライアントプロセス、別のプロキシ、その他のサービスのどれかを調べます。見覚えのないプロセスをむやみに終了しないでください。競合しているのが混合プロキシのポートなら、クライアントで未使用のポートに変更し、コアの再起動後にシステムプロキシやアプリの設定も更新します。管理APIのポートが競合している場合は、管理APIアドレスのポートを変更し、パネルの接続設定も合わせて更新してください。最後にログで該当のリスナーが起動したことを確認します。