トラブル診断 · 症状から探す

Clash トラブルシューティングガイド

初回のインストール、設定の読み込み、接続は、使い方ガイドの手順に沿って進めてください。このガイドは、すでに問題が発生している場合に使用します。目次から近い症状を選び、比較テストを行ってから、該当する手順をガイドで確認しましょう。変更は一度に一項目だけにし、変更前の値、テスト時刻、結果を記録してください。原因が確認できていない変更は元に戻します。

ネットに繋がらない:まず直接接続を復旧し、通信の経路を確認

クライアントを介さない基準状態を確認する

端末全体がオフラインなのか、特定のWebサイトやアプリだけに接続できないのかを切り分けます。作業中の内容を保存し、クライアントのシステムプロキシとTUNを順に無効にしてから、アプリを終了してください。ウィンドウを閉じるだけでは不十分です。多くのデスクトップクライアントはタスクトレイで動作を続けるため、画面が消えても待受ポートが閉じたとは限りません。終了後、OSのネットワーク設定を開き、プロキシの状態と、ローカルアドレスを指す設定が残っていないかを確認します。組織から配布されたプロキシ設定は不具合の残りではありません。元の設定を記録し、勝手に削除しないでください。

普段アクセスできる無関係なWebサイトを2つ開き、同じネットワークに接続した別の端末でも試します。両方の端末で開けない場合は、クライアントを再インストールするのではなく、Wi-Fi認証、ゲートウェイ、上位ネットワークを確認してください。ゲストネットワークではログインページで利用規約への同意が必要な場合があります。通信の接管を無効にしてログインを済ませ、再度テストします。この端末だけ直接接続できない場合は、有効なIPアドレスとデフォルトゲートウェイを取得しているか、別のVPNやネットワークフィルターが通信を処理していないかを確認します。pingに一度失敗しただけでネットワーク障害と判断しないでください。ICMPに応答しないサーバーもあります。

アプリのリクエストから実際の出先まで追跡する

直接接続が復旧したらクライアントを起動し、通信の接管方式を一つだけ有効にします。デスクトップのブラウザーは、まずシステムプロキシで試し、TUNは同時に有効にしません。TUNが必要なアプリだけで問題が起きる場合は、システムプロキシを無効にしたままTUNの状況を再現します。同じ接続先に毎回一度ずつリクエストを送り、その直後に接続一覧で同時刻の記録を探します。接続一覧は履歴ではないため、短時間のリクエストはすぐに消えることがあります。再現前にログを開き、記録が見つからないことだけでリクエストがカーネルに届いていないと決めつけないようにしてください。

確認できた状況次に確認すること
アプリがリクエストを送信しているが、カーネルに該当ログがないアプリがシステムプロキシを参照しているか、接続先を迂回していないか、ローカルの待受が起動しているかを確認します。
ルールに一致し、DIRECTで接続同じ接続先への直接接続と比較し、このルールが想定どおりか確認します。
REJECTに一致一致した拒否ルールを特定し、誤判定だと確認できた場合に限り、その接続先に対応するルールを調整します。
プロキシグループに入り、その後接続に失敗するポリシーの経路を開き、グループ名だけでなく最終的に選択されているノードを確認します。

クライアントに設定が読み込まれたと表示されても、管理リストにファイルが追加されたことしか分かりません。その設定が現在の設定として選択され、カーネルに正常に読み込まれていることを確認してください。オーバーライドスクリプトやマージ設定を変更している場合、画面に表示された元のサブスクリプションが実際の動作結果とは限りません。有効な設定と今回の接続ログで一致したルールを確認しましょう。通常、ルールは上から順に評価されます。上位の広範なルールが先に接続先を処理し、後続の一見正しいルールが実行されないことがあります。

モードを切り替えて比較する

ルールモードでは失敗し、同じ利用可能なノードを使った短時間のグローバルモードでは接続できる場合、ルールモードに戻して一致した項目を確認します。グローバルモードとルールモードでは、ポリシーグループの選択状態が別々に保存されることがあります。切り替える前に実際のノードが同じか確認してください。そうしないと、ルールとノードの両方が結果に影響します。どちらのモードでも失敗し、通信の接管を無効にするとすぐに正常になる場合は、接続先を一つに絞り、ローカルの待受と外部への接続を個別に確認します。ブラウザーだけで失敗し、他のアプリが正常なら、まずブラウザー独自のプロキシ設定や拡張機能を確認し、その後クライアントを調べます。

修正後は、クライアントのアイコン表示が変わったことだけでなく、最初に失敗した操作をもう一度試してください。よく使うサイトに直接接続できることと、プロキシが必要な接続先で想定したポリシーが適用されることを確認します。再起動後にだけ再発する場合は、ログイン時にクライアントが起動していたか、後からカーネルが準備できたか、OSが以前のプロキシ設定を先に復元したかを記録してください。再現する順序から、起動タイミングの問題か、常に存在する設定ミスかを切り分けられます。

ノードがタイムアウトする:疎通テスト・ハンドシェイク・接続先を切り分ける

一括速度測定を、比較可能な一回のテストに絞る

クライアントに表示されるミリ秒数は、通常、テスト用URLへのリクエストにかかった時間であり、ノードと端末間の往復時間とは限りません。テストには名前解決、接続の確立、プロトコルのネゴシエーション、接続先の応答などが含まれます。計測範囲はカーネルの実装によって異なります。タイムアウトは、制限時間内にリクエストが完了しなかったことを示すだけです。すべてのノードが同時にタイムアウトする場合は、クライアントが実際にネットワークへ接続できているか、テスト用URLが利用可能か、設定を更新した直後ではないかを確認します。一部のノードだけで起きる場合は、テスト用URLとローカルネットワークを固定し、正常なノードと失敗するノードを一つずつ試します。

ポリシー画面でノードを一つ手動選択し、遅延テストとは別の普段使う接続先にアクセスして、接続詳細で実際にそのノードを通っているか確認します。手動で調べている間は、自動グループにノードを切り替えさせないでください。同じページで複数のリクエストが発生する場合があり、ノードの切り替え後は前後のログを直接比較できません。テスト用URLだけが失敗し、実際のサービスが使える場合は、提供元が推奨する、安定した小さな応答が期待できるURLに変更して再テストします。実際のサービスも使えない場合は、最初のエラーを記録し、エラーが発生した段階に応じて調べます。

エラーがどの段階で起きたかを確認する

ログのno such hostは名前解決の失敗を示すことが多いですが、解決しようとしたのがノードのサーバーか、アクセス先かを確認してください。前者で失敗するとプロキシサーバーにも接続できないため、ブラウザーを変えても解決しないことがあります。後者はプロトコル、ルーティングポリシー、名前解決の場所と併せて判断します。connection refusedはどこかで接続が明示的に拒否されたことを示します。接続先のポートで待受がない場合も、中間機器が拒否応答を返す場合もあります。接続タイムアウトが続く場合は、明確な応答がありません。このログ一行だけでは、サービス停止、ルーティング上のパケットロス、経路制限を区別できません。

ログに証明書の期限切れ、名前の不一致、信頼されない証明書が表示された場合は、まずシステムの日付、タイムゾーン、時刻を合わせます。その後、ノード設定のサーバーアドレス、サーバー名、転送設定が提供元の元の設定と一致しているか確認してください。アドレス欄の値と証明書検証に使われる名前は異なる場合があります。違うからといって同じ値に変更しないでください。検証を無効にして証明書やハンドシェイクのエラーを隠すのも避けます。認証に失敗する場合は、古い設定のコピーではなく、更新済みの設定が有効かを確認してください。認証情報の更新が必要なら提供元から取得し、ログからコピーしたり公開したりしないでください。

単一ノード・ネットワーク・疎通テスト設定を切り分ける

同じノードを別の利用可能なネットワークで再テストします。元のネットワークで失敗した場合は、利用許可のあるスマートフォンのテザリングなどを試してください。どちらのネットワークでも失敗し、同じグループの他のノードは正常なら、ノード名とエラー発生時刻を記録し、提供元にノードの状態を確認します。特定のネットワークだけで失敗する場合は、同じ端末、ノード、接続先で繰り返しテストします。結果が一貫している場合に、そのネットワークの外向き経路を調べる根拠になります。テザリングのテスト結果は、通信量の上限、電波状況、スマートフォンの設定にも左右されるため、一度の成功や失敗だけでは判断できません。

自動グループの疎通チェックとサブスクリプション更新は別の仕組みです。url-testはグループ内の候補へテストを行い、ポリシーに沿って選択します。一方、プロキシプロバイダーのhealth-checkはプロバイダー内のノードを対象とします。両方でテストを設定している場合は、表示されている結果がどちらの設定によるものか確認してください。タイムアウトを直すために間隔を極端に短くしないでください。短い間隔でリクエストを繰り返すと、一時的な混雑を増幅したり、ログとの対応を難しくしたりします。まず一度接続できることを確認し、その後、定期的なテストを有効にして数回の結果が安定するか確認します。

切り替え時だけ接続が切れる場合は、新しいリクエストと、すでに確立している接続を分けて観察します。新しいリクエストは新ノードを使っていても、長時間接続は終了していないか、アプリ側で再接続が必要な場合があります。テストページを閉じて開き直すか、単独のテスト通信を終了してから再試行してください。すべての接続を消去する必要はありません。結果の見方はノードの遅延テストの仕組みも参考にしてください。

サブスクリプションの更新に失敗する:取得・解析・適用を切り分ける

まずダウンロードが成功したか確認する

設定管理画面で対象のサブスクリプションを手動更新し、その操作の通知、時刻、ログを確認します。ダウンロード段階で失敗する場合は、ドメインの名前解決、接続タイムアウト、証明書エラーを確認してください。HTTP応答を受信した場合はステータスコードを見ます。401は通常、認証に関係します。403は権限、アクセス方針、サービス側の制限が原因の可能性があります。404は古いリンクが無効になった場合だけでなく、サービスがそのリソースを公開していない場合にも返されます。ステータスコードは調査の分岐材料であり、アカウントの未払いまたは停止を証明するものではありません。

提供元の管理ページに戻り、サブスクリプションが有効か確認して、現在のクライアントまたはClash形式に対応すると記載されたURLをコピーします。記憶を頼りにパスやクエリパラメーターを変更しないでください。コピー時に空白や改行が入っていないか、Webページの共有URLを誤ってコピーしていないか注意します。提供元がリンクを再発行した場合、古いリンクは使えなくなることがあります。ブラウザーで管理ページを開けても、クライアントがサブスクリプションを取得できるとは限りません。経由するプロキシ、リクエストヘッダー、ログイン状態が異なる場合があります。サブスクリプションを公開変換サイトやオンライン診断ツールに送信しないでください。

更新リクエストが現在のプロキシを使い、すべてのノードが使えない場合、更新による復旧もできなくなることがあります。クライアントでダウンロード方法を指定できるか確認してください。現在のネットワークから提供元へ直接接続できる場合は、更新操作に限ってダウンロード方法を切り替えます。そうでなければ、到達可能と確認済みの別ネットワークから再試行してください。更新後は設定を元に戻します。現在動作している旧設定を最初に削除せず、失敗時に戻せるコピーを残してください。更新が一度失敗しただけで、既存の接続まで止まるのを防げます。

リクエストは成功したが、読み込み可能な設定ファイルが返ってこない

HTTPの200は、サーバーが何らかの内容を正常に返したことを示すだけです。ログインページ、認証ページ、エラー説明、別のクライアント専用の共有リンク一覧が返される場合もあります。完全な設定ファイルと、proxy-providersで使うノード一覧は用途が異なります。前者にはポリシーグループやルールが含まれることがありますが、後者は通常、メイン設定から参照されます。ノード一覧を完全な設定ファイルとして読み込むと、インポート成功と表示されても想定したポリシーが含まれないことがあります。まずURLの種類を確認し、その後、クライアントがどの段階でエラーを出したかを調べます。

行番号付きのYAMLエラーが出た場合は、オフラインで該当行とその数行前を確認します。よくある原因は、インデントのずれ、タブによる字下げ、リスト項目の位置ずれ、コロンと空白を含む通常のテキストを文字列として記述していないことです。エラーの行は解析を続けられなくなった位置であり、問題はその前にある場合もあります。未対応のプロトコル、フィールド、グループ種別を指摘された場合は、行を削除するのではなく、使用中のカーネルを確認してください。フィールドをむやみに削除すると、ファイルが読み込めてもプロトコルパラメーター、ポリシー参照、ルールの動作が失われることがあります。

更新は成功したのに、古い設定やノードが使われている

サブスクリプション一覧でどの項目が現在の設定に選ばれているか確認し、カーネルが正常に再読み込みされたか調べます。ダウンロードに成功しても、画面上の設定が切り替わったとは限りません。更新後にポリシーグループから以前のノードが見つからない場合は、ノード名が変更または廃止されていないか確認し、現在も存在するメンバーを手動で選びます。ローカルのオーバーライド、マージ、フィルターを使用している場合は、新しいサブスクリプションを別の設定として検証し、ローカルの変更を一つずつ戻します。リモート設定を直接大量に編集すると、次回のダウンロードで上書きされるおそれがあります。

メイン設定が更新されても、ネストされたプロキシプロバイダーが古いキャッシュを使っていることがあります。メイン設定の更新日時だけでなく、プロバイダー画面で最終更新時刻、エラー、ノード数を確認してください。proxy-providersのHTTPプロバイダーにあるintervalの単位は秒です。手動更新で一回の取得を確認し、単発のダウンロードと読み込みが成功してから定期更新の設定を変更します。各フィールドの意味は設定ファイルを項目ごとに解説をご覧ください。クライアントを変更する場合は、まずダウンロードセンターで端末に合わせて推奨のClash Plusまたは他の対応クライアントを選び、移行前にローカルルールをバックアップしてください。

通信速度が遅い:比較テストでノード・回線・端末の負荷を切り分ける

まず、どのように遅いのかを整理する

Webページをクリックしてから長く真っ白な状態が続く場合は、名前解決、接続確立、最初のデータを受信するまでの時間を確認します。ダウンロードの開始は速いのにすぐ遅くなる場合は、継続的な転送速度と短時間の変動を調べます。ビデオ会議が途切れる場合は、パケットロス、ジッター、切り替え時刻を確認します。複数の症状が同時に起こることはありますが、一度の遅延測定で全てを説明することはできません。繰り返しアクセスでき、過度な負荷をかけずにテストできる接続先を一つ選びます。大容量ファイルのテストでは同じファイルまたはサービスを使い、従量制ネットワークで何度もダウンロードしないようにしてください。

テスト対象、端末、場所を固定します。まず通信の接管を無効にして直接接続を測定し、次にノードを固定して測定し、最後にノードだけを変えて再確認します。対象がもともと直接接続できない場合は、別の到達可能な接続先でローカル環境の基準を確認します。ただし、別々の対象の速度を厳密な比較に使わないでください。ブラウザーのキャッシュや接続の再利用により、2回目の表示が速くなることがあります。新しいセッションで初回アクセスを試し、初回接続と再訪問を分けて確認してください。転送速度の単位にも注意が必要です。1秒あたりのバイト数とビット数には8倍の差があります。比較前に単位をそろえましょう。

段階ごとの計測で原因を絞る

以下の2つのコマンドは、curlが利用できるPOSIXシェル向けです。1つ目はプロキシを明示的に無効にし、2つ目はローカルのHTTPプロキシを明示的に指定します。7890はクライアントの実際のHTTPポートまたは混合ポートに置き換えてください。直接接続を比較する前にTUNを無効にします。アプリのプロキシを無効にしても、システムレベルのルーティングは迂回できません。ここで使う小さなページは、ハンドシェイクと最初のデータ受信までの時間を確認するもので、持続的な帯域幅の測定には使いません。

curl --noproxy '*' --max-time 20 -o /dev/null -sS \
  -w 'dns=%{time_namelookup} connect=%{time_connect} tls=%{time_appconnect} first=%{time_starttransfer} total=%{time_total}\n' \
  https://example.com/
curl --noproxy '' --proxy http://127.0.0.1:7890 --max-time 20 -o /dev/null -sS \
  -w 'dns=%{time_namelookup} connect=%{time_connect} tls=%{time_appconnect} first=%{time_starttransfer} total=%{time_total}\n' \
  https://example.com/

表示される時間は秒単位で、リクエスト開始からの累積時間であり、5つの独立した所要時間ではありません。ローカルプロキシ経由の場合、接続時間が示すのは主にローカルの待受への接続です。また、curlのDNS計測にリモート接続先の名前解決が含まれるとは限りません。そのため、プロキシ用コマンドの小さなconnect値だけで回線が速いと判断しないでください。最初のデータ受信までの時間と合計時間が繰り返し長くなるか確認し、カーネルログも併せて、プロキシに入る前の待ち時間と外部接続後の待ち時間を切り分けます。

再現可能な差に基づいて対処する

同じネットワークで特定のノードだけが継続して遅い場合は、最低遅延を追い求めるより、安定した別のノードに切り替えます。複数のノードが決まった時間帯だけ遅くなる場合は、同じテストを時間帯を変えて記録し、共有回線の混雑との関係を確認します。すべてのノードと直接接続が遅い場合は、クラウド同期、システム更新など、大量の通信を使う処理を一時停止します。家庭のWi-Fiでは、有線接続に切り替えるか、アクセスポイントに近づいて再テストしてください。ネットワークを変えて改善しても、元のネットワークで速度制限されていたとは限りません。電波干渉や上り回線の飽和でも同じような症状が起きます。

直接接続とシステムプロキシは正常で、TUNだけ遅い場合は、同じ接続先でTUNが余分なアプリやDNSリクエストまで処理していないか確認します。最初からMTUをむやみに変更しないでください。小さなリクエストは成功する一方、大きな転送が繰り返し停止するなど、再現できる状況がある場合に限り、クライアントのドキュメントに従って少しずつ試し、元の値を記録します。ブラウザーのページで一部のリソースだけ遅い場合は、メインサイトと画像やスクリプトを配信する別ドメインのどちらで失敗しているかを確認し、それぞれにどのルールが適用されたか調べます。メインページと静的リソースが別の出口を通るのは通常の動作です。ページ全体が表示されたかではなく、実際に失敗したリクエストに基づいて調整してください。

詳しい判断例は通信速度が遅い場合の段階的な調査をご覧ください。最後に、最初に遅延が起きた操作をもう一度行い、継続ダウンロード、ページの初回表示、通話の安定性で確認します。遅延の数値が小さくなったことは、そのテストが速くなったことしか示しません。

DNSの問題:名前解決を行った場所・対象・結果を確認する

名前解決の失敗と接続の失敗を区別する

サイト名だけでなく、エラーが発生したドメインを記録してください。Webページは複数のドメインからリソースを読み込むことがあります。一部のリソースで名前解決に失敗しても、ブラウザーにタイトルや古いキャッシュが表示される場合があります。まず次のコマンドを実行して、システム既定の名前解決経路を確認し、失敗したアプリの動作と比較します。コマンドで解決できても、その一回の結果が得られただけです。ブラウザー、TUN、プロキシ経由の接続が同じリゾルバーを使用しているとは限りません。

nslookup -type=A example.com
nslookup -type=AAAA example.com

問題が起きたドメインに置き換えて再テストしてください。AAAAレコードがないからといって、ドメインが存在しないわけではありません。アドレスが返された後に接続が失敗する場合は、外部への経路、ポート、IPv6の疎通を確認します。HTTPSのテストで、名前解決されたIPアドレスを直接アドレスバーに入力して代用しないでください。ドメイン名は証明書の検証や仮想ホストの選択に影響するため、IPへのリクエストが失敗しても、そのアドレスに到達できないとは限りません。2つのネットワークで比較したとき、一般公開サイトが異なるIPアドレスを返すのは、分散型の振り分けによる正常な動作の場合もあります。

mihomoのDNS設定項目を確認する

有効な設定で、まずdns.enableを確認し、次にカーネルのDNSが実際にリクエストを受け取っているかを調べます。カーネルDNSを有効にしても、すべてのアプリが自動的にそこへ問い合わせるとは限りません。アプリ独自の暗号化DNSを使っていたり、システムが従来のリゾルバーへ問い合わせを送信し続けたりすることがあります。特定のブラウザーだけで問題が起きる場合は、セキュアDNSの設定を記録し、システムの名前解決を使って短時間比較した後、元の値に戻します。TUNでのみ問題が起きる場合は、OSのDNS画面だけで結論を出さず、クライアントが生成したDNSの接管設定とカーネルログを確認してください。

フィールド役割確認ポイント
nameserver通常のドメイン名解決に使う上流DNS。現在のネットワークから上流へ接続できるか確認し、リクエストのタイムアウトと上流からの否定応答を区別します。
nameserver-policy条件に一致するドメインのリゾルバーを指定します。問題のドメインが誤った範囲のリゾルバーに送られていないか確認します。
proxy-server-nameserverプロキシノードのドメイン名を解決する上流DNSを指定します。起動時のノード名解決が、すでにノードへ接続できることに依存しないようにします。
fake-ip-filter条件に一致するドメインへのfake-IP割り当てを除外します。互換性がないと確認できた接続先だけ例外にし、該当アプリで動作を検証します。

ドメイン名を使う暗号化DNSの上流を設定する場合は、その上流自身の初回名前解決方法も考慮してください。起動後にリクエストが連続して失敗し、接続が確立してから回復する場合は、上流DNSのドメイン、ノードのドメイン、DNSの接管が互いに依存していないか確認します。社内またはローカルネットワークのリゾルバーが必要な内部ドメインを、すべて外部リゾルバーに置き換えないでください。管理可能なドメイン範囲だけを割り当てて検証し、プリンター、ファイル共有、内部サービスへの影響を避けます。

fake-IPとキャッシュが結果に与える影響を確認する

fake-ipモードでは、カーネルが対応付け用のアドレスを返し、接続時にドメイン名へ復元できます。対応付け用アドレスが表示されても、それだけで名前解決の失敗とは限りません。アプリがそのアドレスを取得しても、ドメイン名を復元できる接管経路を通らない症状がある場合に、接管範囲や対象ドメインの例外を調べます。ネットワークやDNSモードを切り替えた後にだけ問題が起きる場合は、アプリが前回の応答をキャッシュしている可能性があります。まず影響を受けたアプリを終了して再起動します。必要ならOSの方法に従って端末のDNSキャッシュを消去し、同じネットワークで再テストしてください。

設定を変更した後は、一般公開ドメイン、以前失敗したドメイン、業務で使うローカルネットワーク名をそれぞれ確認してください。各接続先について、名前解決と接続確立の両方を確認します。一般公開サイトだけ復旧し、内部ドメインが使えなくなったのであれば、完全な修正とはいえません。カーネルごとの設定項目や既定の動作はmihomoとオリジナル版Clashの違いを参考にしてください。他のクライアント用の設定を丸ごと現在の環境に貼り付けないでください。

システムプロキシが機能しない:OS設定からアプリの動作まで確認

ローカルの待受とシステム側の接続先を確認する

システムプロキシは、その設定に従うアプリへリクエストの転送先を知らせるものであり、自身で待受を行う機能ではありません。まずカーネルが起動しているか、設定のmixed-portまたはHTTP待受ポートと、システムに設定されたポートが一致しているか確認してください。デスクトップのシステムプロキシは通常、127.0.0.1のような端末自身のループバックアドレスを指定します。クライアントのポート再読み込みに失敗してもシステムプロキシの設定だけ成功すると、ブラウザーは待受サービスのないアドレスへ接続しようとします。カーネルの起動ログでバインドエラーを確認してください。ポートが使用中の場合は、まずどのプロセスが使っているか調べ、そのクライアント用に空きポートを設定して、システム側の設定も合わせます。

curlが使えるターミナルで、実際のHTTPポートまたは混合ポートを指定して、次のプロキシ接続テストを実行します。Windows PowerShellではコマンド名をcurl.exeにできます。クライアントがSOCKS待受だけを公開している場合、HTTP形式のコマンドでは検証できません。実際のプロトコルでテストするか、HTTPプロキシを使うアプリ向けに対応する待受を有効にしてください。リクエスト成功後は接続詳細も確認し、想定したポリシーが適用されたかを確かめます。ステータスコードを受け取れたことが示すのは、HTTP応答の段階まで通信が進んだことだけです。

curl --noproxy "" --proxy http://127.0.0.1:7890 --max-time 15 -I https://example.com/

アプリがどの設定を参照しているか確認する

OS設定画面混同しやすい点
Windows設定 → ネットワークとインターネット → プロキシデスクトップアプリ、WinHTTPを使うプログラム、サービスで、同じプロキシ設定を共有しているとは限りません。
macOSシステム設定 → ネットワーク → 現在のネットワークサービス → 詳細 → プロキシネットワークアダプターを切り替えると、新しいネットワークサービスに別のプロキシ設定が適用される場合があります。
Linuxデスクトップ環境のネットワークプロキシ設定、またはアプリ独自の設定コマンドラインツールは、環境変数や独自の設定ファイルだけを参照する場合があります。

プロキシを明示したテストが成功し、通常起動したアプリが失敗する場合は、アプリがシステムプロキシ、独自の手動プロキシ、自動構成スクリプトのどれを使っているか、または直接接続しているかを確認します。バイパスリストも確認してください。ローカルアドレスがバイパスされるのは一般的に想定どおりですが、広すぎるドメインサフィックスが接続先に誤って適用されることがあります。ターミナルツールはhttps_proxyやno_proxyなどの環境変数を参照することがよくあります。デスクトップの切り替え操作で、すでに起動中のターミナルプロセスの環境変数が変わるとは限りません。新しいアプリウィンドウを開くか、アプリを完全に再起動して比較し、既存の長時間接続が再利用されていないことを確認してください。

ブラウザー拡張機能、ネットワーク管理ソフト、別のクライアントが、システムプロキシ設定を交互に書き換えることもあります。まずスイッチをオンにした後、OSの設定画面が本当に変わるか確認し、しばらくして設定が戻されていないかを調べます。組織のポリシーでプロキシ設定が復元される場合は、その設定を維持し、管理者の指示に従ってください。繰り返し強制的に変更しないでください。自動構成スクリプトを使っている場合は、元の値を確認でき、変更権限がある環境に限り、一時的に手動プロキシと分けてテストします。用途不明の設定を直接削除すると、既存のネットワーク接続が使えなくなることがあります。

TUNが必要か判断し、終了後に設定が戻ることを確認する

システムプロキシを参照しないアプリや、その方法では扱えない通信があります。その場合にTUNを検討してください。初回テストでは他の接管方式を停止し、クライアントの想定どおりに仮想ネットワークアダプター、ルート、DNSが設定されているか確認します。TUNは追加の権限やルーティング範囲に関わるため、有効にするとローカルネットワークへのアクセスも変わることがあります。ブラウザーだけをプロキシ経由にしたい場合は、まずブラウザーとシステムプロキシの関係を修正してください。一つのアプリのために端末全体をTUNへ切り替える必要はありません。

調整後は接続ログで対象が想定したルールに一致したことを確認します。次にクライアントから通常の手順でプロキシを無効にして終了し、閉じたポートを指す設定がOSに残っていないか確認します。起動後だけ問題が起きる場合は、クライアントが二重に自動起動していないか、OSが先にプロキシアドレスを復元していないか、アプリ起動時にカーネルの準備が完了していたかを確認します。初回接続の検証手順はサブスクリプションを読み込んだ後の初回接続をご覧ください。

クライアントがクラッシュする:画面・カーネルの終了と設定読み込み失敗を切り分ける

状況を保存し、どの層が終了したか特定する

ウィンドウを開いたとき、設定を読み込んだとき、TUNを有効にしたとき、サブスクリプションを更新したとき、スリープから復帰したときのどのタイミングで発生したか記録します。タスクバーのアイコンが消えても、コアが停止したとは限りません。ウィンドウが反応しないだけで、画面が固まっている場合もあります。まずタスクトレイ、プロセス一覧、既存の起動ログを確認してください。画面が消えてもプロキシでリクエストを処理できる場合は、画面側のプロセスを調べます。画面が残っているのにコアがオフラインと表示される場合は、コアの終了理由とローカルの待受を確認します。読み込み時に行番号付きの検証エラーが出る場合は、多くの場合、設定が拒否されただけで、クライアント全体のクラッシュではありません。

最初に現れたエラーを含め、終了直前と直後のログを少量保存してください。最後の数行に繰り返し表示される再起動メッセージは、多くの場合、問題の結果にすぎません。それより前にあるバインド失敗、ファイル読み込みエラー、権限拒否のほうが原因の特定に役立ちます。保守担当者に送る場合は、個人情報を隠したコピーを使ってください。クライアント終了後もOSが閉じた待受ポートを参照している場合は、ネットに繋がらないの項目に従って、元のネットワーク設定を復旧します。ダウンロードやファイル書き込み中は、できるだけ通常の手順で終了してください。強制終了を繰り返して解決を試みないでください。

設定と実行環境を最小限の変更で切り分ける

アップグレードまたは設定のインポート後に問題が始まった場合は、ローカル設定、ルール、オーバーライドをバックアップしてから、以前使えていた設定に切り替えてください。画面を操作できる場合は、まず画面から戻します。起動するたびにすぐ終了する場合は、クライアントのドキュメントでユーザーデータの保存先を確認し、関連プロセスを完全に終了してから、破損が疑われる設定ファイルやフォルダーの名前を変更して保管し、初期状態で起動します。用途が分からないままアプリのデータ全体を消去しないでください。フォルダーにはサブスクリプション、ログ、設定、プロバイダーのキャッシュが含まれる場合があります。削除すると、調査材料と元に戻す手段を同時に失うおそれがあります。

mihomo単体を使っていて、コマンドラインから実行できる場合は、組み込みのテストモードで設定ファイルを個別に検証できます。以下のコマンドは、現在のディレクトリにconfig.yamlがあることを前提としています。設定がプロバイダーファイル、ルールセットなどを参照している場合は、実際の実行環境と同じデータディレクトリ、カーネルを診断環境で使用してください。異なるカーネルで検証に成功しても、デスクトップクライアントで成功するとは限りません。設定テストは実際の起動とは異なり、ポート、システム権限、通信の接管機能が正常であることも保証しません。

mihomo -t -f ./config.yaml

初期状態で起動できる場合は、まずメイン設定だけを戻し、オーバーライドと過去のキャッシュは復元しません。正常に読み込めたことを確認してから、一項目ずつ戻します。特定の設定を戻した時点で終了する場合は、最小限の再現条件を保存し、同じ環境でもう一度確認してください。TUNを有効にしたときだけ終了する場合は、サービス権限、仮想ネットワークアダプター、他のVPNとの競合を調べます。常に管理者権限で実行する方法を標準的な解決策にしないでください。通常権限でのパスやサービスのインストール問題を隠すことがあります。

インストールパッケージとシステム環境を確認する

初期状態でも繰り返し終了する場合は、OS、プロセッサーのアーキテクチャ、クライアントのリリース情報を確認してください。カーネルが動作することと、グラフィカルインターフェースが動作することは別です。前者には後者の画面関連の依存関係が不要な場合があります。OSのアプリケーションエラーログで障害モジュールを確認します。プログラムファイルが隔離された、またはシステムポリシーでブロックされたと表示されても、起動するために保護機能を無効にしないでください。まず配布元と、組織管理端末でのインストール要件を確認します。更新前後を比較するときは、できるだけ同じ設定を使い、新しい設定との互換性問題をインストールパッケージの不具合と取り違えないようにしてください。

クライアントの変更が必要な場合は、まずクライアント比較を確認し、ダウンロードセンターでOSとアーキテクチャに合うものを選びます。対応プラットフォームでは、まずClash Plusを選べます。修正後は通常終了と再起動を一度行い、初期設定、元の設定、クラッシュが発生した操作をそれぞれ検証してください。再現する場合は、OSとアーキテクチャ、発生までの手順、初期状態で起動できるか、最初に表示されたエラーを共有します。ユーザーデータのフォルダー全体を送る必要はありません。

モバイル端末の問題:VPNによる通信の接管・バックグラウンド動作・ネットワーク切り替え

OSの許可と現在通信を処理しているVPNを確認する

モバイルクライアントは通常、OSのVPN機能を使って通信を処理します。クライアント内の接続ボタンと、OSでVPNが有効になっていることは別です。初回接続ではOSの許可が必要です。許可後、OSのVPN設定で現在接続中のVPN名を確認してから、決めた接続先にアクセスし、クライアントの接続記録を確認します。OSのVPNアイコンは何らかのVPN機能が接続中であることを示すだけで、選択中のノードが使えることまでは保証しません。端末に別のVPN、コンテンツフィルター、組織管理のネットワーク設定がある場合は、実際に通信を処理しているものを特定してください。組織から配布された設定は削除しないでください。

Androidでは、常時接続VPNや、VPNが使えないときに通信を遮断する設定が有効な場合もあります。クライアントを停止した後、端末全体がネットに繋がらなくなる場合は、ノードの切り替えだけで判断せず、これらの設定が有効か確認してください。仕事用プロファイルやアプリの除外リストを使っている場合、個人用アプリと仕事用アプリで通信の接管範囲が異なることもあります。特定のアプリだけプロキシを通らない場合は、許可リストまたは除外リストに含まれているかを確認し、同じドメインへ他のアプリから接続して比較します。公開IPアドレスの検索結果一つだけで、端末全体のルートを判断しないでください。

画面ロック後の切断とネットワーク切り替え後の切断を分ける

条件を分けて2つのテストを行います。1つ目は同じWi-Fiと同じノードを使い、画面を点灯した状態で接続してからロックします。数分後に解除し、VPNの状態と新しいリクエストが続けられるか記録します。2つ目は画面を点灯したままWi-Fiからモバイルデータ通信へ切り替え、OSが新しいネットワークを利用可能と判断した後にリクエストを再送します。前者で失敗する場合はバックグラウンド制限を、後者で失敗する場合は新しいネットワークの疎通、トンネルの再確立、アプリの長時間接続を優先して調べます。古い接続が切れても再接続されていないとは限りません。新しいリクエストを送って確認してください。

Androidの省電力設定やバックグラウンド管理の画面は、端末によって異なります。画面ロック後にクライアントが停止したという根拠がある場合に限り、OSがそのアプリのバックグラウンド動作を制限していないか確認します。変更前の値を記録し、一項目だけ調整して、ロック解除後の動作と待機中の電池消費を比較してください。iOSではAndroidのバックグラウンド維持手順をそのまま使えません。OSのVPN状態、クライアントのオンデマンド接続機能、問題発生時のログにネットワーク変化が記録されているかを確認します。毎回、ロック解除後に手動接続して初めて復旧する場合は、オンデマンドルールが現在のネットワークに適用されるか、管理ポリシーで動作が制限されていないかを調べます。

Wi-Fiでは使えてモバイルデータ通信では使えない場合は、通信の接管を無効にして、影響を受けるアプリとクライアントにモバイルデータ通信の権限があるか確認してから、接管を戻してテストします。反対に、特定のWi-Fiだけで接続できない場合は、まずネットワーク認証を済ませます。その後、そのネットワークでノードのアドレス解決に失敗するのか、接続がタイムアウトするのか、一部の接続先だけ利用できないポリシーに振り分けられるのかを記録します。アクセスポイントを変えるとルーティングと名前解決の両方が変わります。同じノードと接続先で比較し、比較可能な記録を残してください。

ローカルネットワーク・アプリごとの振り分け・復旧手順を確認する

テレビへの画面共有、プリンターの検出、ローカルファイルへのアクセスは、ローカルネットワークの経路に依存し、ブロードキャストやマルチキャストを使う場合もあります。インターネットにアクセスできても、ローカルネットワークのサービスが使えるとは限りません。まずVPNを無効にして接続先の端末をテストし、両方の端末が相互接続できるネットワークにあるか確認します。ゲスト用Wi-Fiでは、接続端末同士の通信が遮断されることがあります。VPNを有効にしたときだけ見つからない場合は、クライアントにローカルネットワーク通信のバイパス設定やアプリごとの設定があるか、OSのローカルネットワークアクセス許可が有効かを確認します。検出機能を直すためにクライアントの待受をローカルネットワーク全体へ公開しないでください。これらは別の機能です。

復旧の確認は順番に行います。まずWi-Fiで新しい接続を試し、次にモバイルデータ通信で新しい接続を試します。最後に画面ロック中の動作と、ネットワーク切り替え後の動作を確認してください。変更が原因と思われる場合は、元の値に戻した後、同じ条件でもう一度試して、一時的な電波の変動を除外します。再インストールまたはクライアントの変更が必要なら、サブスクリプションURLとローカル設定を保存してから、AndroidのダウンロードまたはiOSのダウンロードで対応するものを選びます。クライアントごとに設定名は異なります。OSの接管状態と実際の接続記録を基準に確認してください。

Clash最新版をダウンロード