入門ガイド / 初回接続

Clashのサブスクリプション追加と接続確認

クライアントをインストールし、ClashのサブスクリプションURLまたはローカルのYAML設定を用意します。初期設定ではアプリと接続先サイトを1つずつに絞ると、設定・通信の取り込み・接続先のどこに問題があるか判断しやすくなります。

サブスクリプションを追加して設定を有効化

設定提供元のページで、Clashまたはmihomo向けと明記されたサブスクリプションURLをコピーします。サブスクリプションURLはクライアントが設定を取得するためのもので、ログインページのURLや個別ノードの詳細ページではありません。ローカルのYAMLファイルだけを入手した場合は、ファイルから読み込みます。別の場所へアップロードする必要はありません。サブスクリプションURLには認証情報が含まれる場合があります。画面を共有したり相談したりするときはエラーメッセージだけを残し、URLや設定内容全体は公開しないでください。

URLから取得するか、ファイルから読み込む

クライアントの「設定」または「サブスクリプション」ページを開き、新規追加からURLで読み込む項目を選びます。URL全体を貼り付けて「インポート」または「保存」を押し、設定名が一覧に表示されるまで待ちます。追加と更新が別操作になっている場合は、追加後にその項目の「更新」も押し、ダウンロードまたは解析が成功したか確認します。ローカルファイルを使う場合は、同じ画面から「ファイルから読み込む」を選び、ファイル選択画面で設定提供元から入手したYAMLファイルを指定します。

取得に失敗したら、まずクライアントのエラー表示を確認します。タイムアウトの場合は端末がインターネットに接続できるか確かめ、現在のネットワークからサブスクリプションURLにアクセスできるか提供元に確認してください。認証エラーやURLの期限切れが表示された場合は、入手元で有効なURLを再取得します。取得した内容を解析できない場合は、WebページのURLではなく、使用中のクライアントに対応した設定URLをコピーしたか確認してください。ローカルファイルの読み込みに失敗した場合は、エラーの行番号とフィールド名を手がかりに元ファイルを確認します。エラーを消すためにルール全体を安易に削除しないでください。フィールドの意味を確認したい場合は、設定フィールドリファレンスをご覧ください。

一覧から使用する設定に切り替える

設定一覧に項目があるだけでは、クライアントがその設定を保存したことしか分かりません。追加した項目を選び、「使用」「有効化」または現在の設定にする操作を実行して、選択マークがその項目に付いていることを確認します。続いて「プロキシ」または「ポリシー」ページを開きます。設定にプロキシグループが含まれていれば、グループ名と利用可能な接続先が表示されます。以前の設定のグループ名が表示されたままなら、再インポートする前に設定ページで切り替えが成功したか確認してください。

サブスクリプションの更新と設定の有効化は別の操作です。更新するとファイルが再取得され、有効化すると現在のコアが読み込む設定が決まります。利用できる設定がすでにある場合は、新しい設定が手順4で確認できるまで古い項目を残しておけます。使用中の設定が正しいと確認できたら、次はプロキシページでモードを選びます。

ルールモードと接続先を選ぶ

「プロキシ」ページ、ホーム画面、またはトレイメニューからモードを選び、初回は「ルール」を選択します。ルールモードでは、コアに届いたリクエストを設定内のルールに上から順に照合します。一致したルールによって、直接接続する、リクエストを拒否する、またはプロキシグループに渡す、といった処理が行われます。モードを切り替えてもシステムプロキシは有効になりません。この設定は、コアが受け取ったリクエストの処理方法を決めるものです。

プロキシグループを確認して接続先を選ぶ

設定には、汎用グループ、用途別のグループ、自動選択グループなどが含まれる場合があります。グループ名は設定の作成者が決めるため、チュートリアルの画面と同じである必要はありません。ルール一覧や設定の説明でテストサイトの振り分け先が分かる場合は、そのグループを開きます。手動選択グループでは、利用可能な接続先を選び、選択マークが付いたことを確認してください。グループ内に別のプロキシグループがある場合は、選択中の項目をたどり、最終的な接続先まで確認します。テストサイトがもともとDIRECTルールに一致する場合、プロキシグループを変更してもそのサイトには影響しません。

自動選択グループは、あらかじめ設定された方法で接続先を検出・切り替えることがあり、メンバーを直接固定できるとは限りません。初回のトラブルシューティングでは、接続先を明示的に選べる手動グループを使うと分かりやすくなります。設定に自動グループしかない場合は、既定の選択を維持し、接続確認時に実際の接続先を記録してください。速度測定の結果が一覧にあっても、その接続先が測定時の通信を完了できたことを示すだけです。現在のブラウザー通信がクライアントに届いた証拠にはならず、対象サイトへのアクセス確認の代わりにもなりません。

全般モードとDIRECTは比較用に使う

全般モードでは通常のルールによる振り分けを行わず、全般用のポリシーで利用可能な接続先を選ぶ必要がある場合もあります。通信がコアに届いていると確認できた後、ルールモードとの短時間の比較に使えます。同じサイトが全般モードでは開き、ルールモードに戻すと失敗する場合は、一致したルールと選択中のプロキシグループを確認してください。DIRECTモードでは、コアに届いたリクエストを直接接続します。クライアントのシステムプロキシやVPNを無効にすることとは異なります。全般モードをルールの恒久的な修正方法として使わないでください。本来DIRECTにすべき通信まで別の経路に変わる可能性があります。

ルールモードと選択した接続先はそのままにし、ルールや設定を切り替えずに進めます。「接続先」「プロキシグループ」「ルール」の関係は、いつでも用語集で確認できます。初回の接続確認では、ルールが経路を選び、プロキシグループが利用する接続先を決めると覚えておけば十分です。

アプリの通信をクライアントに通す

まず、クライアントのコアが動作中であること、または起動エラーが表示されていないことを確認します。デスクトップで手早く試すなら、システムプロキシを有効にし、システムプロキシ設定を使うブラウザーからリクエストを送ります。スマートフォンではクライアントのホーム画面にある接続スイッチを使います。初回の確認では、テストに必要な接続方法だけを有効にしてください。システムプロキシとTUNを同時に有効にすると、サイトにアクセスできても、どちらが通信を取り込んだのか判断しにくくなります。

デスクトップ:システムプロキシを有効にするか、アプリに個別設定

クライアントのホーム画面またはトレイメニューから「システムプロキシ」を有効にし、スイッチがオンのままになっていることを確認します。画面にローカルの待受アドレスやポートが表示される場合があります。これはアプリからコアへリクエストを渡すためのもので、リモートノードのアドレスではありません。有効にした直後にスイッチがオフになる場合は、システム設定の変更失敗、コアの起動失敗、ポートの競合が表示されていないか確認してください。ポートが使用中の場合は、別のプロキシクライアントが起動していないかを先に確認し、手当たり次第にポートを変更しないでください。

Linuxのデスクトップ環境では、システムプロキシのスイッチに対応しているかどうかが異なります。クライアントにスイッチがない場合や、テストするアプリがシステム設定を使わない場合は、アプリ側のプロキシ設定にクライアントが表示するローカルアドレス、ポート、プロトコルを入力してください。たとえば画面にHTTP、またはHTTP対応の混合インバウンドが明記されている場合は、アプリでHTTPプロキシを選びます。サブスクリプションURLをここに貼り付けないでください。手動設定を使い終えたら、同じ画面で元の設定に戻してください。

スマートフォン:接続を開始してシステムの許可を確認

クライアントのホーム画面に戻り、最初の手順で有効にした設定が選択されていることを確認してから「接続」をタップします。初めてシステムのVPN許可画面が表示されたら、設定中のクライアントからの要求であることを確認し、案内に従って許可します。クライアントに戻り、接続済みの状態になってからテストするアプリに切り替えます。端末によってはステータスバーにVPNアイコンが表示されますが、これはシステムのトンネルが確立したことを示すだけです。特定のルールに一致したことや、リモートの接続先が利用可能であることまでは分かりません。

接続がすぐに切れる場合は、別のVPNがすでに動作していないか、端末の管理ポリシーで接続の作成が制限されていないか確認してください。業務用端末で必要な接続やセキュリティ設定を、テストのために無効化しないでください。デスクトップアプリがシステムプロキシを使わず、独自のプロキシ設定もない場合は、クライアントが対応するTUNの利用を検討します。必要な権限、通信の取り込み範囲、DNSの処理方法は用語集で確認できます。初回のブラウザー確認前に有効にする必要はありません。

接続ログで通信経路を確認

まずクライアントの「接続」または「ログ」ページを開き、テストするアプリから想定する経路が分かっているサイトにアクセスします。ブラウザーをいったん終了して再起動するなど、新しい接続を開始するのがおすすめです。すでに開いているタブではキャッシュが使われたり、既存の接続が再利用されたりする場合があります。ページが更新されたかどうかだけでは、今回のリクエストの経路を判断できません。複数のドメインを読み込むサイトでは、画像やフォントではなく、アドレスバーに表示されているメインサイトの通信を確認してください。

対象・ルール・実際の接続先を照合する

アクセスした時刻と対象ドメインを手がかりに、直前のリクエストをログから探します。ルール、プロキシチェーン、接続先が表示される場合は、どのルールに一致したか、どのグループに渡されたか、最終的にDIRECTか選択した接続先かを順番に確認します。DIRECTが表示されても、必ずしも問題ではありません。対象が本来直接接続するサイトで、ページも正常に開くなら、ルールが機能しています。プロキシ経由を確認するには、プロキシグループに振り分けられることが明確な別のサイトを選び、同じ確認を行ってください。

クライアントによっては、接続一覧に通信中のリクエストしか表示されず、短時間の接続は消えていることがあります。まずログページで同じ時刻の記録を探すか、接続ページを開いたまま再度リクエストを送ってください。それでも記録がなく、リクエストは成功する場合は、テストアプリがシステムプロキシを使っているか、プロキシ用プラグインが設定を上書きしていないか、アプリが古い接続を使い続けていないか確認します。ターミナルツールとブラウザーでは設定の参照元が異なる場合があります。ブラウザーで確認できても、ターミナルが同じ経路を自動的に使うとは限りません。

状況に応じて1か所だけ変更して再確認

記録はあるものの経路が想定と違う場合は、まず対象ドメインと一致したルールを確認し、次に該当するプロキシグループで別の接続先が選ばれていないか調べます。ルールは上から順に評価されるため、前方の広い条件が今回のリクエストに一致している可能性があります。経路は正しいのにリクエストが失敗する場合は、現在のルールを維持したまま、名前解決、リモート接続、ノードとのハンドシェイクのどの段階でエラーになったかログで確認してください。選択中の接続先が原因だと確認できた場合に限り、同じ手動選択グループ内で別の接続先に切り替えて比較します。一度に変更するのは1項目だけにし、同じサイトで再確認すると、どの変更が効果をもたらしたか分かります。

対象サイトに正常にアクセスでき、記録にも想定した経路が表示されたら初期設定は完了です。比較のために全般モードやDIRECTモードへ切り替えていた場合は、ルールモードに戻してください。デスクトップでプロキシを一時停止する場合は、先にシステムプロキシをオフにしてからクライアントを終了します。テストアプリにローカルプロキシを個別設定した場合も、元の設定に戻してください。モバイルではクライアントのホーム画面から切断します。カスタムルールの追加、DNSの調整、設定の上書き管理については、続けてmihomo 設定フィールドリファレンスをご覧ください。