Clashのよくある質問
サブスクリプション・設定・接続のトラブル対処

Clashクライアントは、この種のGUIツールの総称です。mihomoはプロキシプロトコル、ルール判定、DNS処理を担うコアです。Clash Verge RevやFlClashなどは、設定の読み込みやOSとの連携を行うインターフェースを備えています。Clash for Windowsは、すでにメンテナンスが終了した特定の製品です。選ぶ際は、クライアントのメンテナンス状況とコアの互換性を確認し、名前が似ているだけで機能が同じだと判断しないでください。移行前に設定をエクスポートし、ローカルの上書き設定とシステムプロキシのポートを記録しておきましょう。

クライアントをインストールしただけでは、利用可能なプロキシは使えません。サブスクリプションは通常、利用中のサービスの管理画面から取得します。自分で構築したサービスに対応する設定を使うこともできます。読み込む前に、Clash YAML形式に対応しているか、または利用中のクライアントがサポートする読み込み方法かを確認してください。アカウントのログインページはサブスクリプションURLではありません。URLには認証情報が含まれる場合があるため、掲示板への貼り付けやスクリーンショットの公開、見知らぬ変換サイトへの入力は避けてください。漏えいした場合は、提供元でURLを再発行してください。

普段はルールモードを選び、rulesの順序に従って接続先を判定し、対応するポリシーに振り分けます。グローバルモードでは、コアに入った接続をグローバルポリシーで処理しますが、すべてのアプリの通信が自動的に取り込まれるわけではありません。アプリの通信がコアに入るかどうかは、システムプロキシまたはTUNの設定によります。DIRECTモードでは、コアに入った接続を直接通信させます。トラブルの切り分けでは、一時的にグローバルモードにして、動作確認済みのプロキシを選びます。確認後はルールモードに戻し、一時設定をそのまま使い続けないようにしてください。

通常、最初から両方を有効にする必要はありません。システムプロキシはOSのプロキシ設定を変更し、その設定に従うブラウザーやアプリで使えます。TUNは仮想ネットワークインターフェースとルートを使って通信を取り込み、システムプロキシに従わないアプリにも対応できますが、追加の権限が必要です。初回接続ではシステムプロキシでサブスクリプションとプロキシグループを確認し、必要に応じてTUNを有効にしてください。併用時に問題が起きたら、まずどちらか一方を無効にし、他のVPNも一時停止して原因を絞り込みます。

サブスクリプションURLはリモートの設定を取得するための入口、設定ファイルはコアが実際に読み込むYAML、プロキシグループは複数のプロキシや処理方法をまとめて選択できるようにするものです。完全な設定には、ノード一覧だけでなくDNS、ルール、待ち受けポートなども含まれます。プロキシグループ名はルール内の参照名と一致させてください。たとえば、ルールの末尾でPROXYを指定する場合、設定にも同名のプロキシまたはプロキシグループが必要です。プロトコルURLだけを受け取った場合は、クライアントが対応する方法で読み込み、完全なYAML設定として直接使わないでください。

まず、サブスクリプションURLを最後まで正しくコピーできているか確認し、提供元のアカウントページでサービスの状態とURLの再発行有無を確認してください。401や403は認証やアクセス制限、404はURLの変更が原因の場合がありますが、詳しくは提供元の案内を確認してください。何度も続けて読み込みを試さず、クライアントのログで応答ステータスを確認します。その後、まだ利用できないプロキシ経由でサブスクリプションを更新しようとしていないか確認してください。問い合わせる際は、URLを伏せ、ステータスコードと発生時刻だけを伝えましょう。

まず、ダウンロードした内容が本当にYAMLか確認してください。ログインページ、Web上のエラーメッセージ、Base64形式のノード一覧は、完全な設定ファイルとしてそのまま使えません。ログにyaml: unmarshal errorsが出た場合は、続く行番号を手がかりに、フィールドの型、インデント、リスト構造を確認します。YAMLのインデントにはスペースを使い、タブは使わないでください。編集していないサブスクリプション設定に戻して読み込めるか確認し、その後、上書き設定を一つずつ戻します。エラー箇所を共有する前に、サーバーの認証情報とサブスクリプションURLを削除してください。

まず、利用中のクライアントの説明に従ってサービスモードをインストールまたは有効化し、サービスが実行中か確認してください。製品によって「サービスモード」「Service Mode」「補助サービス」など名称が異なります。Windowsではサービスのインストールに管理者権限が必要な場合があります。macOSでは補助プログラムの許可が必要なことがあり、Linuxではディストリビューションとクライアントの説明に沿って権限を設定します。すべての実行ファイルの権限をむやみに拡大しないでください。インストール後も失敗する場合は、仮想ネットワークアダプターの作成やルート追加時のエラーを確認し、セキュリティソフトや他のVPNとの競合を調べます。

まず、システムプロキシのアドレスが127.0.0.1を指しているか、ポートが現在の設定のmixed-portまたはHTTP待ち受けポートと一致しているか確認してください。次に、ブラウザー独自のプロキシ設定、プロキシ拡張機能、組織のポリシーを確認します。これらがシステムプロキシの設定を上書きしている場合があります。クライアントの接続画面を開いた状態で新しいページにアクセスし、該当する接続が表示されるか確認してください。記録がない場合は通信の取り込み経路を、記録があるのに直接接続される場合はルールとプロキシグループを確認します。システムプロキシのオン・オフを繰り返すだけでは解決しません。

パソコン側でLANからの接続を許可するallow-lanを有効にし、bind-addressがループバックアドレスだけに限定されていないことを確認します。スマートフォンとパソコンを同じ信頼できるネットワークに接続し、スマートフォンのWi-Fi設定で手動プロキシを選び、パソコンのLAN内IPアドレスとHTTPまたはmixed-portのポート番号を入力してください。ファイアウォールでは必要なプライベートネットワークからの接続だけを許可し、可能であれば認証も設定します。スマートフォンのWi-Fiプロキシ設定ですべてのアプリの通信を取り込めるとは限りません。使い終わったら設定を戻し、待ち受けポートをインターネット上に公開しないでください。

速度テストで確認できるのは、その時点で設定されたテスト用アドレスにアクセスできたことだけです。すべてのサイト、プロトコル、アプリが使えるとは限りません。まず、実際に適用されているプロキシグループで対象のノードが選ばれているか確認し、接続画面で接続先ドメイン、適用ルール、接続エラーを調べてください。ブラウザーは使えるのにゲームや通話が失敗する場合は、UDPへの対応状況と通信の取り込み方法も確認します。速度テストの結果だけでノードの問題を除外せず、同じ接続先とポリシーで一つずつ比較すると、ルール、プロトコル、接続先サービスのどこに違いがあるか判断できます。

サブスクリプションから生成された設定を直接編集すると、次回の更新でリモートの内容に置き換えられることがあります。長期間保持したいルールは、クライアントがサポートする上書き設定、拡張設定、スクリプトに追加してください。設定場所は製品のドキュメントで確認します。復元する前に現在のファイルをバックアップし、最終的に適用される設定のrulesの順序を確認してください。個別のルールはMATCHより前に置きます。上書き設定内のプロキシグループ名も、サブスクリプションに含まれる実際の名称と一致させてください。一致しないと、対象のポリシーが見つからず読み込みエラーになることがあります。

クライアントの設定で自動起動を有効にした後、OSのスタートアップ設定でブロックされていないか確認してください。クライアントの自動起動、起動時のシステムプロキシ設定、OSと連動したサービスの起動は別々の設定です。初回は再起動後に設定が正常に読み込まれたか確認し、サービスとネットワークの準備が整っているかを確認してください。ネットワーク接続前にサブスクリプションの更新が失敗する場合は、接続後に手動で更新して確かめます。クライアントをアンインストールまたは変更する前にシステムプロキシを無効にし、待ち受けプロセスのないポートが設定に残らないようにしてください。

ルールモードを使い、ローカルの上書き設定にドメイン完全一致ルールまたはDOMAIN-SUFFIXルールを追加し、転送先にDIRECTを指定します。ルールは上から順に判定されるため、より広い範囲のルールやMATCHより前に配置してください。変更後、最終的に適用される設定にルールが含まれていることを確認し、新しい接続で適用結果を確かめます。既存の長時間接続には、変更前のポリシーが引き続き適用される場合があります。一つのサイトのためにクライアント全体を長期間DIRECTモードにしたり、必要以上に広いドメインサフィックスを指定したりしないでください。

まずexternal-controllerが有効か確認し、パネルに入力したアドレス、ポート、secretがコアの設定と一致しているか確認してください。ローカルでのみ使う場合、コントロールインターフェースのバインド先は127.0.0.1で十分です。接続しやすくするためにインターネット上へ公開しないでください。パネルをHTTPSで開き、コントロールインターフェースがHTTPの場合、ブラウザーの混在コンテンツ制限でリクエストがブロックされることがあります。パネルの導入手順に従って設定してください。スクリーンショットを共有する前にコントロール用の秘密鍵を隠し、リモート接続には信頼できるネットワークとアクセス制御を別途設定します。

まずプロキシを無効にして、通常のネットワーク接続を確認します。次に、サブスクリプションが有効で、ノード設定が正常に読み込まれているか確認してください。ノードを一つ選び、実際の接続先にアクセスしてログを確認します。timeoutはリクエストが制限時間内に完了しなかったことを示しますが、この表示だけでサーバー障害とは判断できません。システム時刻、サーバーのドメイン名解決、ファイアウォール、他のVPNによる影響を確認してください。複数のノードで失敗する場合は、共通するローカル環境から確認します。一部のノードだけ失敗する場合は、エラー内容の機密情報を伏せ、発生時刻とともに提供元へ連絡してください。

一部のWindowsアプリは、ループバック通信の制限によりローカルのプロキシポートに直接接続できません。クライアントにUWPループバック設定ツールがある場合は、対象アプリだけに必要に応じてループバックの例外を許可し、設定後にアプリを再起動してください。すべてのアプリを一度に許可するのは避けましょう。対応環境ではTUNによる通信の取り込みも試せますが、アプリとOSのプロキシ設定も確認してください。ループバックの例外設定ですべてのストア関連の問題が解決するわけではありません。アカウント、システムサービス、DNSのエラーもログを確認し、それぞれ切り分けてください。

まず、名前解決に失敗したドメインとエラーの全文を記録し、設定したDNS上流に接続できるか、上流のドメイン解決が循環依存していないか確認してください。DNSのタイムアウトがFake-IP自体の問題とは限りません。特定のアプリが仮想アドレスに対応していないと確認できた場合のみ、必要に応じてfake-ip-filterを追加するか、redir-hostモードと比較して検証します。変更後は関連するDNSキャッシュを消去し、接続をやり直してください。すべてのDNS設定を一度に置き換えると、アクセスが復旧しても、どの変更が有効だったか特定しにくくなります。

古いデータベースが残っていてコアから読み込める場合、更新に失敗しても既存のGEOIP判定にすぐ影響するとは限りません。データベースがない、または破損している場合は、それを参照するルールの読み込みや判定に失敗することがあります。まずログでデータベースのパスとダウンロードエラーを確認し、書き込み権限、ディスク容量、ダウンロード接続を調べてから、クライアントの更新機能で再試行してください。Country.mmdbはよく使われるGeoIPデータファイルですが、必要な形式は設定によって異なります。GeoIPとgeositeは用途が異なるため、相互に置き換えることはできません。

address already in useは通常、待ち受けポートがすでに使用中であることを示します。複数のクライアントを同時に起動していないか、コアのプロセスが残っていないか確認してください。重複したプロセスを終了するか、mixed-portを変更し、システムプロキシのポートも合わせて変更します。片方だけ変更しないでください。クライアントを終了した後にネットへ接続できない場合は、OSに手動プロキシ設定が残っていないか確認して無効にします。TUNを使っていた場合は、クライアントの説明に従ってサービスを停止し、ルートが復元されているか確認してください。通常のネットワーク接続が戻ったら、クライアントを一つだけ起動して動作を確かめます。