事前準備：クライアントをインストールし、対応するサブスクリプションを用意

この記事では、再現可能な接続を一度確立することを目指します。YAML全体を理解しておく必要はありません。作業前に、OSとプロセッサのアーキテクチャに合ったクライアントと、サービス提供元が発行したClashまたはmihomo対応のサブスクリプションURLを用意してください。まだインストールしていない場合は、ダウンロードページでプラットフォームを選択します。インストール権限やシステム拡張などの詳細は、全プラットフォーム向けインストール・設定ガイドをご覧ください。サブスクリプションはクライアントに付属するアカウントではありません。ソフトをインストールしても、利用可能なノードが自動で作成されるわけではありません。

まずブラウザーで、普段から直接アクセスできるWebページを開き、Wi-Fi、有線LAN、モバイル通信が正常であることを確認します。続いて、ネットワークを制御しているほかのプロキシクライアントやVPNを終了し、システムプロキシ、ルーティング、DNSの設定が競合しないようにします。組織のポリシーで管理されている端末では、管理者が設定したネットワークを勝手に変更せず、利用可能な接続方法を確認してください。

サブスクリプションURLにはアカウントを特定できる情報が含まれる場合があります。パスワードと同様に慎重に管理してください。コピーするときはサービス提供元の「サブスクリプションをコピー」機能を使い、アカウント管理ページのURLを流用しないでください。また、URL全体を公開の掲示板に投稿しないようにしましょう。以下の4ステップでは、1つの設定と1つのノードだけを使います。問題の原因を特定しやすくするため、待受アドレス、LAN共有、カスタムルールはひとまず変更しません。

ステップ1：サブスクリプションを登録して設定を有効化

クライアントの「設定」または「サブスクリプション」画面を開き、「新規作成」「サブスクリプションを追加」「URLからインポート」などの項目を探します。先ほどコピーしたURLを入力欄に貼り付け、先頭や末尾に空白や改行が入っていないか確認してください。名前を設定できる場合は、「普段使い」など識別しやすい名前を入力します。名前はローカルでの管理用であり、サービス側から返されるノードには影響しません。「インポート」または「ダウンロード」を押し、取得と解析が完了するまで待ちます。

正常に完了すると、設定一覧にカードや項目が追加され、設定名や更新日時などが表示されます。その設定の「使用」「有効化」を押すか、選択状態にしてから「プロキシ」画面を開きます。インポート後に自動で有効になるクライアントもあれば、保存した設定を手動で選ぶ必要があるクライアントもあります。成功通知が出たかどうかではなく、現在の設定が選択状態になっていること、プロキシ画面に設定で定義されたノードとプロキシグループが表示されていることを確認してください。

サービス提供元からローカルの.yamlまたは.ymlファイルを受け取った場合は、「ファイルからインポート」を選んで読み込み、同様に有効化します。通常、完全な設定ファイルにはノード、プロキシグループ、ルールが含まれます。ノードの項目だけを含む断片ファイルは、そのまま完全な設定として使えるとは限りません。解析エラーを解消するために、インデントやルール部分をむやみに削除しないでください。ファイルが現在のクライアントとmihomoコアに対応しているか、先に確認しましょう。

一覧が空の場合は、「ダウンロード失敗」と「解析失敗」を切り分けます。前者はURLの期限切れや、サブスクリプションサーバーにアクセスできないことが原因として考えられます。後者はWebページが返された、設定形式が合わない、現在のコアが未対応の項目を使っているなどの可能性があります。同じURLを何度も貼り付けて設定を増やさないでください。エラーに表示された項目名と行番号を控え、サブスクリプションの登録に関するトラブル対処で原因を確認してください。エラーを共有する際は、サブスクリプションURL、ノードのパスワード、アカウント情報を必ず削除します。

ステップ2：ルールモードとプロキシノードを選択

「動作モード」または「モード」の項目を探し、「ルール」に設定します。英語表示では通常Ruleです。ルールモードでは、現在の設定に基づいて各リクエストを直接接続、プロキシ経由、拒否のいずれにするか判断します。初めて使う場合に適しており、接続ログで動作を確認しやすいモードです。動作モードとTUNは別の設定です。前者は通信の振り分け方法を決め、後者はどの通信をクライアントに取り込むかを決めます。一方を有効にしても、もう一方の代わりにはなりません。

切り替え後、「プロキシ」または「プロキシグループ」画面を開き、メインのプロキシグループを展開します。グループ名は「Proxy」や「ノード選択」のほか、サブスクリプションの作成者が付けた名前の場合もあります。グループ内の項目を確認し、まず実際のノードを手動で選択するか、利用可能なノードを含む自動選択グループを選んでください。現在の選択がDIRECTの場合、そのグループに一致するリクエストは直接接続されます。別のプロキシグループを選んだ場合は、実際の接続先が確認できるまで、さらに下の階層を確認します。

ノードの横にあるテストボタンを押すか、「すべてテスト」を使って、現在のネットワークから指定されたテストリクエストを完了できるか確認します。テストが成功しても、その時点でテスト先にアクセスできたことしか分かりません。すべてのWebサイトやアプリが使えるとは限らず、タイムアウトもテスト先に起因する場合があります。初期設定では最小の数値を求めて何度も切り替える必要はありません。テストに成功するノードを1つ選び、ステップ4で実際にアクセスできるか確認してください。地域やサービス上の制限がある場合は、用途に合わせて接続先を変更しましょう。

「グローバル」モードでは通常、クライアントに入ったリクエストがグローバルプロキシグループで処理されます。ルールの確認のために一時的に比較できますが、すべてのアプリの通信が自動的に取り込まれるわけではありません。PCのアプリがシステムプロキシを迂回する場合もあります。「ダイレクト」モードでは通常、クライアントに入ったリクエストが直接接続されるため、プロキシノードの動作確認には適していません。グローバルモードを試した後は、ルールモードに戻し、メインのプロキシグループの選択が維持されているか確認してください。

この段階では、出所が不明なルールを追加したり、ほかの人のプロキシグループ名をそのまま設定に書き写したりしないでください。ルールの参照先は現在の設定に存在する必要があります。存在しない場合、読み込みに失敗したり、想定どおりに振り分けられなかったりする可能性があります。ルールの順序、ドメインの照合、フォールバックの詳細はルール設定ガイドをご覧ください。初回の利用ではサブスクリプションのルールをそのまま使い、プロキシグループの接続先を確認すれば十分です。

ステップ3：システムプロキシまたはスマホのVPNを有効化

PCではまずクライアントが起動していることを確認し、「システムプロキシ」または「システムプロキシとして設定」を有効にします。ClashXではメニューバーのアイコンから該当するメニューを開けます。ほかのクライアントでは、ホーム画面や設定画面にスイッチがあることが一般的です。有効にすると、システムプロキシ設定に従うブラウザーやアプリのリクエストが、PC上の待受ポートに送られます。ウィンドウを閉じてもプロセスが終了するとは限りませんが、クライアントを完全に終了すると待受が停止します。初回の動作確認中はクライアントを起動したままにしてください。

通常、GUIクライアントを使う場合はシステムプロキシのアドレスが自動で設定されるため、手動で重複設定する必要はありません。ブラウザーにプロキシ切り替え拡張機能をインストールしている場合は、システム設定に従うように変更するか、通信を制御する機能を一時的に無効にします。別のポートを参照してしまうのを防げます。また、古いクライアントがバックグラウンドで動作していないか確認してください。2つのプログラムが同じ待受ポートを使おうとすると、画面上では有効でもポートのバインドに失敗することがあります。

初回接続ではTUNを無効にし、システムプロキシだけで動作を確認します。TUNはシステムプロキシに従わないアプリの通信も取り込めますが、管理者権限や仮想ネットワークアダプター、ルーティングの変更が必要になる場合があります。ブラウザーではプロキシを使えるのにゲームやコマンドラインツールでは使えない場合、通信の入口が異なる可能性があります。すぐにクライアントを再インストールする必要はありません。まずブラウザーで確認し、対象アプリにはプラットフォーム別ガイドを参考に、明示的なプロキシ設定またはTUNを選択してください。

AndroidとiOSでは操作が異なります。クライアントのホーム画面で「接続」「開始」または電源ボタンをタップすると、初回はシステムのVPN許可が表示されます。現在インストールしているクライアントからの確認であることを確かめて許可し、アプリに戻って接続状態を確認してください。ステータスバーのVPNアイコンは通信の取り込みが開始したことを示すだけで、選択したリモートノードが利用可能であることを示すものではありません。次のステップで実際にアクセスできるか確認します。別のVPNに接続中の場合は、用途を確認し、何度も接続を切り替えないでください。

ポートを確認するには、クライアントのポート設定または現在有効な設定を開き、混合ポートを確認します。一般的な値はmixed-port: 7890ですが、実際の値は現在のクライアントに従ってください。ガイドにある数字を見て、無理に上書きしてはいけません。混合ポートではHTTPとSOCKSのプロキシリクエストを受け付けられます。ほかのアプリに手動で設定する場合は、アドレス、ポート、プロキシの種類を確認します。PC上で使う場合、通常は127.0.0.1を指定します。「LAN内接続を許可」を有効にする必要はありません。詳しくは混合ポートの設定をご覧ください。

ステップ4：アクセス結果とルールの適用を確認

ブラウザーに戻り、まず直接接続する想定のサイトを開いて、通常のネットワークが使えることを確認します。次に、現在の設定でプロキシ経由になる想定のサイトにアクセスします。一度にテストするページは1つにし、必要であれば新しいシークレットウィンドウを使って、ブラウザーのキャッシュや拡張機能の影響を減らしてください。クライアントのアイコンの色だけで判断したり、ページが一度開いたことだけで検証を終えたりしないでください。アクセス結果とクライアントのログを両方確認して、プロキシ経由の成功、直接接続の成功、キャッシュによる表示を区別します。

クライアントの「接続」画面を開き、Webページを更新したときの該当ドメインや接続先アドレスを探します。ルール、プロキシチェーン、接続先などの項目が表示される場合は、リクエストがクライアントに届いているか、どのルールが適用されたか、どのプロキシグループを使ったか、最終的にどのノードが選ばれたかを順に確認します。プロキシ経由の想定なのにDIRECTと表示される場合は、ルールとプロキシグループの選択を見直してください。プロキシグループと選択中のノードが表示されているのに接続できない場合は、ノードと接続先サービスを確認します。

接続一覧がない場合は、「ログ」画面で通常レベルのメッセージを確認し、直前に発生したリクエストを時間やドメインで探します。クライアントによっては、標準のログレベルですべての接続情報が表示されるとは限りません。特定の行が見つからないだけで、リクエストがコアに届いていないと判断しないでください。必要に応じてログレベルを一時的に変更し、確認後に元に戻します。ログを共有する前に、サブスクリプションURL、認証情報、機密性の高いアクセス履歴を削除してください。設定ファイルをそのままアップロードしないでください。

ブラウザーでアクセスできない場合は、前の3ステップを順に見直します。まず設定が有効なままか確認し、次にノードを変えて同じテストを行います。その後、システムプロキシが別のプログラムに上書きされていないか、最後に該当ドメインに適用されたルールを確認してください。すべてのテスト先で失敗する場合は、通信の取り込みとノードを優先して確認します。特定のサイトだけ失敗する場合は、サイトの状態、接続先の地域、具体的なエラーを確認してください。1回の確認で変更する項目は1つにし、結果を記録して、複数の変更が互いに影響しないようにしましょう。

コマンドラインでの確認は補助的な方法であり、初回利用時に必須ではありません。混合ポートが7890であることを確認したPCでは、次のコマンドを実行すると、このリクエストをローカルのHTTPプロキシ経由で送信できます。Windowsでは、ターミナルによるコマンドのエイリアスの違いを避けるため、curl.exeを使うことをおすすめします。このコマンドで確認できるのは、リクエストがプロキシに届いたかどうかとアクセス結果です。OS全体やすべてのアプリでプロキシが使われていることを示すものではありません。

curl --proxy http://127.0.0.1:7890 --head https://example.com

コマンドでローカルポートに接続できない場合は、待受ポートとクライアントの起動状態を確認します。ローカルポートには接続できるものの、リモートへのリクエストが失敗する場合は、ノードとログを確認してください。HTTPレスポンスが返れば、該当するリクエストが処理されたことを意味します。特定のステータスコードが返る必要はありません。証明書の警告が表示された場合は、検証をそのまま無視せず、システム時刻、接続先の証明書、ネットワーク環境を確認してください。詳しくはヘルプセンターのトラブル対処もご覧ください。

終了と日常の使い方：利用可能な設定を維持

動作確認が終わったら、現在の設定名、動作モード、メインのプロキシグループの選択を覚えておきましょう。普段ノードを切り替えるときは、該当するプロキシグループを変更するだけで十分です。同じサブスクリプションを登録し直す必要はありません。サブスクリプションを更新した後は、現在の選択先が残っているか確認してください。サービス提供元がノードを削除したり名前を変更したりすると、以前の選択が無効になる場合があります。リモートのサブスクリプションから生成されたファイルに長期利用するルールを直接書き込まないでください。次回の更新時に変更が上書きされる可能性があります。

PCでプロキシを一時的に無効にする場合は、まずシステムプロキシをオフにしてからクライアントを終了します。停止したローカルポートをシステムが参照し続けるのを防げます。スマホではクライアントの切断ボタンを使ってVPN接続を終了してください。終了後にWebページの表示がおかしい場合は、設定を削除する前に、システムプロキシやブラウザー拡張機能の設定が残っていないか確認します。設定を削除すると、問題を再現するための情報も失われます。

次に、OS起動時の自動起動を設定する場合は自動起動の設定方法をご覧ください。Windowsの権限やネットワーク制御については、Windowsのインストール・設定ガイドをご確認ください。LAN共有、カスタムルール、TUNの詳細設定は使い方ガイドにまとめています。初回接続が安定してから、これらの機能を1つずつ有効にし、追加するたびにステップ4の確認を繰り返してください。

Clashの使い方ガイド：サブスクリプション登録と接続確認