macOS トラブル診断ガイド

Clashのトラブル診断

通信がどの段階で止まっているかを特定して、該当する設定を見直しましょう。

初めてインストールする場合は、設定ガイドから始め、サブスクリプションの追加、モードの選択、接続、動作確認の順に進めてください。このページでは、すでに発生している問題の原因を特定します。修復後はガイドの確認手順に戻り、普段使うアプリで再度テストしてください。

ネットにつながらない:まず直接接続を確認

プロキシの介入を解除する

まずClashクライアントでシステムプロキシとTUNをオフにし、「システム設定 → ネットワーク」で現在通信に使われているネットワークサービスを確認します。Wi-Fiアイコンが接続済みでも、アクセスポイントにつながっているだけで、インターネットにアクセスできるとは限りません。ドックの有線LANも接続している場合、通信がWi-Fi経由とは限りません。有線ケーブルを一時的に抜くか、Wi-Fiを一時的にオフにして、それぞれの経路を確認してください。

普段から直接アクセスできる公開ページをブラウザで開き、別の独立したサイトも試します。ホテルやゲスト用ネットワークでは、ログインページでの認証が必要な場合があります。先にネットワークへログインし、その後プロキシを再度有効にしてください。同じネットワーク上のほかの端末でも両方のサイトを開けない場合は、ネットワーク側を確認します。このMacだけで失敗する場合は、現在使っているネットワークサービスのアドレス、ルーター、DNSがネットワークの要件どおりか確認してください。

システムプロキシとローカルポートを別々に確認

直接接続が正常なら、Clashクライアントを開き、プロキシ機能を引き継ぐ2つのスイッチはオフのままにします。使用中の設定が読み込まれていることを確認し、設定画面でHTTPまたは混合ポートを確認したら、コマンドでローカルプロキシに明示的に接続します。以下はポート番号と公開テスト用ドメインの例です。ポートが異なる場合は現在の値に置き換えてください。1つ目はアプリケーションレベルのプロキシを強制的に回避し、2つ目はプロキシを明示的に指定します。TUNがオンのままでは、1つ目を完全な直接接続の基準として使えません。

curl --noproxy '*' --max-time 12 -I https://example.com/
curl --noproxy '' --proxy http://127.0.0.1:7897 --max-time 12 -I https://example.com/

2つ目のコマンドでローカルポートに接続できない場合は、まずコアプロセスが起動しているか、ポート番号に誤りがないか、SOCKS専用のポートが設定されていないかを確認します。プロキシには接続できたものの、その後タイムアウトする場合は、すぐにポートを変更しないでください。「接続」または「ログ」でリクエスト時刻を手がかりに対象を探し、一致したルール、出力先のポリシー、次に記録されたエラーを確認します。リクエストがコアまで届いていれば、原因をコアまたはその先の経路に絞れます。

症状に応じて次の確認項目を選ぶ

テスト結果優先して確認いったん変更しない
プロキシをオフにしても失敗するネットワークへのログイン、ルーター、既存のネットワーク設定ノードとグループポリシー
直接接続は成功、明示的なプロキシ接続は失敗待ち受けポート、コアのログ、出力先ポリシーブラウザー拡張機能
明示的なプロキシ接続は成功、アプリでは失敗システムプロキシ、アプリのプロキシ設定、除外リストサブスクリプションとノード
TUNをオンにした場合のみ失敗するアクセス許可、ルーティング、ほかのネットワーク制御ツールアプリのインストーラー

ルールモードでのみ失敗する場合は、実際に適用されたルールを確認してください。グループポリシーの名前は、実際の出力先を示すとは限りません。特定の地域名が付いたグループでも、利用できないノードが選ばれていたり、直接接続が含まれていたりすることがあります。公開テスト用の接続先を一つ選び、一時的にポリシーを切り替えて比較します。テスト後はルールモードに戻してください。グローバルモードを恒久的な解決策にすると、直接接続が必要なサービスにも影響するおそれがあります。

プロキシをオフにすると正常で、TUNをオンにした場合にローカルネットワーク上のリソースにもアクセスできないなら、まずFinderから同じ共有フォルダに接続するなど、通常の方法でアクセスできるか試します。ネットワークのルーティングが組織のツールで管理されていないか、ローカルのサブネットが重複していないかを確認してください。業務に支障が出ない状態まで戻しましょう。一度のテストを成功させるために、組織の端末のネットワークポリシーを勝手に変更しないでください。

一つずつ機能を戻して再テスト

まず、問題が起きる前に使用していたプロキシ機能のうち一つだけをオンにします。公開ページ、問題が起きたアプリ、普段直接接続する必要があるリソースをそれぞれ再テストしてください。システムプロキシをオンにすると公開ページは開くものの、コマンドラインだけ失敗する場合はシステムプロキシのセクションを確認します。複数のサイトでサーバーが見つからないと表示される一方、アプリから既知のローカルアドレスにアクセスできる場合はDNSのセクションを確認してください。ノードとDNS設定を同時に変更しないでください。

クライアントを終了するとネットにつながらなくなる場合は、現在のネットワークサービスのプロキシ設定に戻り、ローカルポートが指定されたままになっていないか確認します。今回のテストで追加されたプロキシ設定だけを取り消し、既存の自動設定や管理対象の設定は残してください。繰り返し発生する場合は、通常終了と強制終了を分けて記録します。強制終了した場合だけプロキシ設定が残るなら、まず異常終了の原因を解決し、通常終了後にネットワークが復旧するか確認してください。

ノードのタイムアウト:疎通テストと実際のリクエストを区別する

テスト対象と時刻を固定する

遅延テストの結果は、指定された接続確認用アドレスに左右されます。タイムアウトは、今回のテストが制限時間内に完了しなかったことを示すだけで、すべてのサイトが利用できないとは限りません。テスト時刻、接続中のネットワーク、グループポリシー、実際に選択されたノードを記録してください。同じ接続確認用アドレスを使い、比較対象となる利用可能なノードを2つ手動でテストしてから、同じ公開ページに実際にアクセスします。これにより、個別ノードの問題、テスト先の問題、すべての出力経路の障害を切り分けられます。

実際のアクセスは正常で、接続確認だけがタイムアウトする場合は、グループポリシーの接続確認先に到達できるか、特定のステータスコードが必要か、リダイレクトが発生していないかを確認します。タイムアウト時間を大幅に延ばすより、まず確認先と判定方法を見直してください。時間を長くしすぎると障害時の切り替えが遅れ、短すぎると一時的な通信の揺らぎを利用不可と誤判定することがあります。遅延が一時的に高くなるだけでは、設定全体を変更する根拠にはなりません。

ログから通信が止まった段階を確認

失敗した時刻から少し前にさかのぼってログを確認します。ノードのホスト名を解決できないというエラーなら、確認対象はノードアドレスの名前解決であり、Webサイトのドメインに対するルールではありません。名前解決後にリモートアドレスへの接続がタイムアウトする場合は、端末からリモートまでの通信経路に原因がある可能性が高くなります。接続後にハンドシェイクで失敗する場合は、サブスクリプション設定の期限、クライアントのコアが設定内のプロトコル項目に対応しているか、システムの日付とタイムゾーンが正しいかを確認してください。

証明書関連のエラーを、証明書の検証を無視して解決しようとしないでください。端末の時計を確認したうえで、設定の提供元が確認したパラメーターを使うか、古い設定を残したままサブスクリプションを更新します。特定の項目が未対応だとログに明記されている場合は、現在のクライアントの互換性情報を確認してください。起動するまで項目を一つずつ削除するのは避けましょう。構文チェックを通過しても、構造を読み取れることが確認できただけで、接続先が接続を許可するとは限りません。

個別ノード、同じグループのノード、異なるネットワークを比較

ノードが一つだけタイムアウトする場合は、同じグループの別ノードを手動で選び、進行中ではない新しいリクエストを実行します。グループ全体で失敗するものの、同じ設定の別グループは使える場合は、失敗するグループで接続確認先、上流の接続先、出力経路が共通していないか確認してください。自動選択グループの表示が未更新、または以前の接続確認結果のままの場合もあります。グループ一覧の表示ではなく、実際の接続ログに記録された出力先を確認してください。

現在のWi-Fiで全ノードがタイムアウトし、直接接続が正常と確認できている場合は、可能な範囲でスマートフォンのテザリングに切り替えて再テストします。ノード、モード、接続先は変えないでください。テザリングで正常でも、違いが接続ネットワークに関係することが分かるだけで、ルーター、アドレスファミリー、接続先の制限のどれが原因かは特定できません。元のネットワークで別の端末から同じテストを行い、問題がネットワークに追随するのか、このMacだけで起きるのかを確認します。

2つのネットワークでどちらも失敗し、以前動作していた設定が手元にある場合は、同じ端末で古い設定に切り替えて比較できます。古い設定もすでに期限切れなら、クライアント側の問題を証明する材料にはなりません。複数の設定で失敗する場合は、エラーが同じ段階で止まるかを記録します。どちらもタイムアウトと表示されても、ローカル接続の拒否とリモート接続のタイムアウトでは発生箇所がまったく異なります。

自動切り替えによる誤判定を防ぐ

再生中の動画、ダウンロード、長時間接続は、グループ内の選択を変えてもすぐに移行しないことがあります。ノードを切り替えた後はテスト中の接続を閉じ、同じアプリで新しいリクエストを作成してください。古い接続の失敗を新しいノードの問題と誤認しにくくなります。クライアントでルールごとの接続を確認できる場合は、接続先アドレスやリクエスト時刻で現在の接続を探し、グループ一覧の選択表示だけでなく、出力先が実際に変わったことを確認します。

利用可能なノードを手動で選ぶと復旧するものの、自動グループが後から失敗するノードに戻す場合は、一時的に手動グループで接続を維持できます。その後、自動グループの接続確認先、間隔、対象メンバーを確認してから、自動選択に戻してください。再現条件を記録する際は、エラーが起きた段階と、個人情報を削除したグループ名だけで十分です。サブスクリプションURLやノードの認証情報をフィードバックに含めないでください。

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

現在使える設定を残す

更新に失敗しても、現在有効な設定が使えなくなったとは限りません。まず、最後に更新が成功した時刻がクライアントに表示されているか、現在のリクエストが引き続き通信できるかを確認します。有効な設定を削除したり、すべてのサブスクリプションを消去したりしないでください。クライアントでエクスポートできる場合は、使える設定を端末内の安全な場所にバックアップできます。設定には機密性の高い接続情報が含まれる場合があるため、通常のログとして他人に送らないでください。

更新ボタンを押した後、内容の解析中、新しい設定を有効にした後のどの段階で失敗したか記録します。まずクライアントが内容を取得できるかを確認し、次に内容の形式と構造を確認します。ポリシーの参照関係やコアの起動を調べるのはその後です。画面に「インポートに失敗しました」としか表示されない場合は、ログを開いて同じ時刻に出た最初の具体的なエラーを確認してください。最後の曖昧なメッセージだけで判断しないでください。

応答ステータスと更新経路を確認

提供元の管理ページから、クライアントに対応したサブスクリプションURLをコピーし直します。貼り付ける際は先頭や末尾の空白、改行に注意し、クエリパラメーターを自分で削除・変更しないでください。認証エラーやアクセス禁止が表示される場合は、サブスクリプションの期限切れやリセット、提供元によるサブスクリプション種別の制限を確認します。リクエストが多すぎるというエラーが出たら、連続更新をやめ、制限が解除されるまで待ってから再試行してください。何度も更新ボタンを押すと、元のエラーを特定しにくくなります。

ホスト名を解決できない、または接続がタイムアウトすると表示される場合は、クライアントが更新を実行するときに使うネットワークを確認します。ブラウザーでページを開けても、それはブラウザーからアクセスできることを示すだけです。クライアントのバックグラウンドダウンロードでは、異なるプロキシ経路を使う場合があります。クライアントにサブスクリプション更新用のプロキシ設定があるかを調べ、直接更新した場合と、利用可能と分かっているプロキシ経由で更新した場合を比較してください。現在使えない設定に接続が依存している場合は、別の利用可能な設定、または許可されたネットワークで更新経路を確保します。

成功ステータスが返ってきても、期待する設定ではなくログインページ、アクセス案内、提供元のエラーメッセージが返されていることがあります。確認のためにサブスクリプションURLをオンライン解析サービスに送信しないでください。クライアントのエラー詳細や提供元のサポート情報で応答の種類を確認し、必要であれば内容は端末内でのみ確認します。証明書エラーが発生した場合は、時刻とアクセス先を確認するか、提供元に問い合わせてください。証明書の検証を無効にしないでください。

エラーに応じて形式、インデント、参照を確認

同じ提供元のURLでも、完全な設定、ノードの一覧、ほかのクライアント向け形式がそれぞれ出力される場合があります。完全な設定は単独で有効にできることが多く、ノード一覧やルール一覧は既存の設定から参照する場合があります。インポート時にトップレベルの項目が不足している場合は、どの種類のデータを取得したか確認してください。一度のインポートを成功させるために、ノードだけのデータを既存のルールの末尾へ無理に貼り付けないでください。

行番号が表示された場合は、その行だけでなく、直前の数行も確認します。よくある原因は、リスト項目のインデントのずれ、コピー時に混入したタブ、閉じられていない文字列、コロンの後の内容が想定どおりに解釈されないことです。カスタムオーバーライドを使っている場合は、まずテスト用の複製で無効にします。元のサブスクリプションは読み込めて、結合後にだけエラーが出るなら、正常なサブスクリプションを置き換えるのではなく、オーバーライドを修正してください。

構文チェックに通るのに、コアがグループポリシーの不在を報告する場合は、ルールの参照名が現在の設定と完全に一致しているか、空白や句読点も含めて確認します。サブスクリプション更新でグループ名が変わり、ローカルのオーバーライドが古い名前を参照し続けている場合があります。複製した設定で参照を一か所修正し、再読み込みしてください。不明なポリシーをすべて直接接続に変更すると、構文エラーは解消しても実際の通信経路が変わってしまいます。

新しい設定を有効にしたら範囲を絞って確認

新しい設定のインポートに成功したら、手動で有効な設定に切り替え、グループポリシーがそろっているかを確認します。異なるポリシーを使う公開接続先を2つ選んで再テストしてください。有効にした後でネットにつながらなくなった場合は、すぐに動作確認済みの設定に戻し、エラーが起きた段階と関連ログを保存します。自動更新の時刻を変更する場合は、重要な作業時間を避けてください。まず手動更新が最後まで完了することを確認してから、定期実行を設定しましょう。エラーの例はサブスクリプションURLの無効化・解析エラーを自分で確認する方法も参照してください。

通信速度が遅い:待ち時間と転送速度を区別

遅いのが接続前かデータ転送中かを確認

ページが長時間白く表示される、開いた後に内容が少しずつ読み込まれる、ダウンロードが最初から最後まで遅い。これらはそれぞれ異なる症状です。最初のケースではDNS、接続、ハンドシェイクを確認します。2つ目のケースでは、メインページと画像やスクリプトなどのリソースのどちらが止まっているかを調べます。3つ目のケースではページの表示時間ではなく、データ転送を確認してください。テストを始める前に、大容量ファイルの同期やシステムのダウンロードを一時停止し、各回でバックグラウンド処理による帯域の違いが出ないようにします。

公開されている安定したテスト先を一つ決め、同じ端末・同じネットワークで、まず直接接続の基準を測り、次に同じグループポリシー内の別ノードを経由して測定します。毎回変更する項目は一つだけにし、2つの経路を交互にテストすると、ネットワークの一時的な変動による誤差を減らせます。ダウンロード速度の比較には同じ配信元の同じファイルを使い、異なるサイトの速度を比べないでください。ブラウザーの表示速度を比べる際は、キャッシュの影響にも注意します。

HTTPリクエストの各段階の所要時間を確認

curl --noproxy '*' --max-time 20 --silent --show-error \
  --output /dev/null \
  --write-out 'dns=%{time_namelookup}\nconnect=%{time_connect}\ntls=%{time_appconnect}\nfirst=%{time_starttransfer}\ntotal=%{time_total}\n' \
  https://example.com/

各値の単位は秒で、リクエスト開始からの累計です。直接接続のリクエストでは、接続完了時間からDNS解決時間を引くと、接続確立にかかった時間を確認できます。ハンドシェイク完了時間から接続完了時間を引けば、ハンドシェイク段階の所要時間を確認できます。テストコマンドはレスポンス本文を破棄するため、小さなリクエストの待ち時間比較に適していますが、帯域測定ツールではありません。実際の直接接続を測定する場合は、先にTUNをオフにしてください。プロキシを回避するオプションだけでは、仮想ネットワークインターフェースを回避できません。

HTTPプロキシを明示的に指定して比較する場合は、1行目のプロキシ回避オプションを--noproxy '' --proxy http://127.0.0.1:7897に置き換えます。ポート番号はクライアントの設定に合わせてください。この場合、接続時間は主にローカルプロキシへの接続を反映し、DNS解決時間もリモートドメインの解決にかかった時間とは限りません。エンドツーエンドの初回バイト受信時間を比較し、ログと照らし合わせて、遅いのがプロキシ接続か上流からの応答かを確認します。

ノード、ルール、クライアントの負荷を切り分ける

直接接続とプロキシ接続の両方が遅い場合は、同じ時間帯にWi-Fiの再送、ルーターの混雑、バックグラウンドのアップロードが起きていないか確認します。アクセスポイントに近づくか、有線接続に切り替えて比較できます。直接接続は安定しているのに、特定ノード経由のファイル転送だけが遅い場合は、同じグループの別ノードで同じファイルを比較してください。ノードの接続確認が速く、ダウンロードが遅いことは矛盾しません。少量の接続確認データでは、持続的な転送速度を測れないためです。

特定のサイトだけが遅い場合は、ブラウザーの開発者ツールにあるネットワークパネルで最も時間がかかるリクエストを探し、Clashクライアントの接続履歴で該当ドメインを確認します。メインページと関連リソースで異なるポリシーが適用されることがあります。どのリクエストが長く待たされているか特定してから対処してください。画像の読み込みが遅いからといって、ブラウザー全体をグローバルモードにしないでください。古いリクエストは以前の経路を使い続ける場合があるため、新しいリクエストで比較します。

TUNをオンにしたときだけ端末が熱くなり、ページのスクロールも遅くなる場合は、「アクティビティモニタ」でクライアントの画面、コア、ほかのアプリのどれがCPUを使い続けているか確認します。詳細ログの大量出力や、接続一覧の頻繁な更新も負荷を増やすことがあります。まず通常のログレベルに戻し、不要なデバッグ表示を閉じてから同じ操作を再度試してください。CPU使用率が一時的に上がっただけでは、継続的な性能問題とは判断できません。

原因を説明できるポリシーに戻し、安定性を確認

自動選択の接続確認間隔が短すぎると、小さな変動で頻繁にノードが切り替わる場合があります。まずトラブルシューティング中は安定して動作するノードを固定し、会議やダウンロードが中断せず完了するか確認してから、接続確認間隔やグループのメンバーを調整します。特定の時間帯に限って特定サイトが繰り返し遅くなる場合は、時刻、対象リソース、出力先を記録し、後で再テストしてください。再現する遅いリクエストを解決することを優先し、すべての状況に最速のノードを探す必要はありません。

DNSの問題:名前解決の経路を確認

名前解決できない問題と、解決したアドレスに接続できない問題を区別

ブラウザーにサーバーが見つからないと表示された場合は、まずドメイン名の入力ミスがないか確認し、複数の公開ドメインでも同じ問題が起きるか試します。一つのドメインだけ解決できない場合は、DNSレコードの変更やドメイン自体の存在を確認します。複数の公開ドメインで同時に失敗するなら、現在のDNSリゾルバーとネットワークの入口を調べてください。アドレスを取得できてもWebページがタイムアウトする場合、すぐにDNSの問題と判断しないでください。アドレスに到達できるか、ハンドシェイクが完了するかも確認します。

scutil --dns
dscacheutil -q host -a name example.com
dig +time=2 +tries=1 example.com A
dig +time=2 +tries=1 example.com AAAA

scutil --dnsは、システムが現在使用しているリゾルバーや、ドメイン・インターフェースごとに限定された設定を確認するコマンドです。指定したドメインの名前解決を実行するものではありません。dscacheutilはシステムのホスト検索結果を確認しますが、結果がキャッシュ由来の場合があります。digはDNSクエリの応答を確認するコマンドですが、macOSではアプリと同じシステムの名前解決経路でサーバーを選ぶとは限りません。3つの結果が異なる場合は、すぐにキャッシュを消去せず、まず経路の違いを確認してください。

システム、ブラウザー、コアの結果を比較

コマンドでは名前解決できるのにブラウザーだけ失敗する場合は、ブラウザー独自のセキュアDNS設定や、接続方法を変更する拡張機能がないか確認します。Mac全体をリセットするより、別のブラウザーや新しいブラウザープロファイルで比較する方が、原因の特定に役立ちます。反対に、ブラウザーは正常でもシステムの名前解決が失敗する場合、ブラウザーの結果だけでシステムの経路が復旧したとは判断できません。

HTTPまたはSOCKS経由でリクエストを転送すると、リクエスト元のアプリではなく、クライアントのコアがドメインを解決する場合があります。SOCKSを明示したcurlのテストでは、socks5://とsocks5h://でドメインを解決する場所が異なります。前者ではcurlがローカルで解決し、後者ではホスト名をプロキシに渡します。比較時は同じポートと接続先を使ってください。異なる場合、観察した差を名前解決の場所によるものとは判断できません。

TUNとコアのDNS設定は別々の項目です。DNSを引き継ぐよう設定していても、リクエストが実際にその対象となる経路を通っているか確認してください。暗号化DNSを使うアプリは、通常のDNSクエリの入口を通らないことがあります。スイッチの表示だけで結論を出さないでください。fake-ipモードでは、仮想アドレスが返ること自体はDNS漏れやエラーを意味しません。その後の接続をコアが正しいドメインに対応付けられているか確認します。

LANやプライベートドメインの名前解決を保護

公開サイトには接続できるのに社内ネットワークやローカル機器の名前だけ解決できない場合は、新たに有効にしたプロキシ機能をオフにし、元のネットワークで名前解決できるか確認します。組織のネットワークでは、ドメインのサフィックスに応じて専用のDNSサーバーを使う場合があります。すべてのリクエストを一律に公開DNSへ送ると、社内ネットワークが利用できなくなることがあります。.localはローカルのマルチキャスト名前解決で処理されることが多いため、公開DNSへのクエリ結果だけで機器がオンラインかどうかを判断できません。

設定によっては、特定のドメインに使うリゾルバーを選んだり、特定のドメインをfake-ipの対象外にしたりできますが、この2つの設定は役割が異なります。前者は問い合わせ先を決め、後者は返されるアドレスの形式に影響します。まず使用中のコアの設定ガイドで該当項目を確認し、問題がこの層にあると特定できてから、対象となるドメインのサフィックスだけを最小限変更してください。管理対象の専用DNSルールは、ネットワーク管理者に確認してください。

DNS漏れの判定は想定経路と照らし合わせて確認

テストページに特定のDNSサービス事業者が表示されても、それだけでDNS漏れとは判断できません。まず今回のテストで、どのアプリがどのDNSリゾルバーを使う想定かを確認し、結果をブラウザーの設定、現在のモード、コアのログと照合します。変更後は同じアプリで新しいリクエストを作成し、公開ドメインと、ローカルでの名前解決が必要なドメインを一つずつ確認してください。IPv6アドレスへの接続だけが失敗する場合も、IPv6を全体で無効にするのではなく、まずIPv6の接続性を調べます。

システムプロキシが機能しない:ネットワークサービスとアプリを確認

現在使われているサービスのプロキシ設定を確認

クライアントのスイッチがオンでも、すべてのアプリが現在のシステムプロキシを使うとは限りません。「システム設定 → ネットワーク」で通信に使用中のネットワークサービスを開き、「詳細 → プロキシ」でWebプロキシ、安全なWebプロキシ、SOCKSプロキシを確認します。macOSのバージョンによって画面上の名称が多少異なる場合があります。Wi-Fi、ドック、ユーザーアカウントを切り替えた後は、現在使っているサービスの設定を参照しているか改めて確認してください。

networksetup -listallnetworkservices
scutil --proxy
networksetup -getwebproxy 'Wi-Fi'
networksetup -getsecurewebproxy 'Wi-Fi'

後半の2つのコマンドにあるサービス名は、最初のコマンドの出力に合わせて置き換えます。有効・無効の状態、ホスト、ポートを照合し、自動プロキシ設定や除外リストが設定されているかも確認してください。ここで確認できるのは設定値であり、ポートが実際に待ち受けていることを示すものではありません。システムに127.0.0.1と表示されている場合、プロキシはローカルにあります。クライアントやコアを終了した後もこの設定が残っていると、その設定を参照するアプリは接続できません。

システム設定が実際に待ち受けているポートを指しているか確認

macOSのターミナルでlsof -nP -iTCP:7897 -sTCP:LISTENを実行すると、例として示したポートをどのプロセスが待ち受けているか確認できます。ポート番号はクライアントで設定した値に置き換えてください。別のプロセスがポートを使用している場合は、プロセス名と用途を先に確認し、見覚えのないサービスを強制終了しないでください。ポートを変更した後はシステムプロキシを再適用し、設定画面の数字を見るだけでなく、プロキシを明示したコマンドで接続を確認します。

以下はmihomoの最小限のポート設定例です。項目を確認するためのもので、完全な設定ではありません。混合ポートはHTTPとSOCKSの両方の接続を受け付けます。ローカルでのみ使う場合は、LANからのアクセスを許可しない状態にしてください。ローカルのブラウザーからプロキシを使うために、LAN接続の待ち受けを有効にする必要はありません。クライアント画面が実行時設定でポートを上書きする場合もあるため、変更後は実際の待ち受けポートとシステムプロキシの値を確認してください。

mixed-port: 7897
allow-lan: false

ブラウザー、ターミナル、除外設定を個別に確認

ブラウザーは通常システムプロキシを利用しますが、拡張機能、管理対象のブラウザーポリシー、独自のプロキシ設定によって動作が変わることがあります。公開ページを新しいリクエストで開き、時刻を手がかりにクライアントの接続履歴を確認してください。ブラウザーからリクエストがあるのにコアに記録されない場合は、入口や除外設定を調べます。コアに記録があり、出力先が直接接続なら、プロキシは機能していてルールも適用されています。スイッチを再度オンにするのではなく、該当したルールを確認してください。

ターミナルのツールがmacOSのシステムプロキシを使うとは限りません。現在のプロセスの環境変数を参照するものも、専用の設定ファイルを使うものもあります。起動ファイルに誤ったポートを書き込まないよう、まずはコマンド単位のオプションでテストしてください。プロキシを明示するとコマンドが成功する場合は、アプリがプロキシ設定をどこから取得しているかに問題があります。一つのターミナルウィンドウだけで失敗する場合は、環境の違いを比較してください。認証情報が含まれる可能性のある環境変数の値を公開しないでください。

除外リストは、ローカルサービスなど特定のホストをシステムプロキシ経由にしないための設定です。問題の接続先が除外範囲に該当する場合、クライアントの接続履歴に表示されないのは正常です。リスト全体を消去せず、特定のホストだけの問題か、ドメインパターンの誤一致かを確認し、元の設定を記録してください。組織から配布されたプロキシ自動設定や除外ルールは、個人端末と同じ方法で変更しないでください。ブラウザーとコマンドラインの違いはアプリごとにシステムプロキシを切り分ける方法も参照してください。

TUNが必要なケースを確認

アプリが必要なとおりシステムプロキシを使えるなら、そのアプリのためにTUNを有効にする必要はありません。システムプロキシを使わないアプリでは、まずアプリ自体にプロキシ設定があるか確認し、なければ仮想ネットワークインターフェースによる通信の取り込みを検討します。TUNを検証するときは、今回のテストで使うシステムプロキシを無効にし、どの入口を使っているか明確にしてから、DNS、LAN、普段使うアプリを確認してください。結果が悪化しても、どの設定が原因か特定しやすくなります。

クライアントがクラッシュする:画面、コア、アクセス許可を切り分ける

終了した段階を記録し、すぐに再インストールしない

アプリを開いてすぐ終了する、画面は正常でもコアが動作していない、特定の設定に切り替えた後だけ終了するなど、症状によって対処方法は異なります。最後に実行した操作と、終了前にシステムの警告が表示されたかを記録してください。バックグラウンドで動作しているか分からない場合は、「アクティビティモニタ」で関連プロセスを確認します。ウィンドウが閉じてもアプリが終了したとは限らず、アプリが応答しなくてもコアの待ち受けが停止したとは限りません。

終了後にネットにつながらなくなった場合は、先にネットに接続できない場合のセクションを参照して接続を復旧し、その後クラッシュを調べます。macOSの「コンソール」でクラッシュレポートを開き、時刻とプロセス名で直近の記録を探すか、クライアントが提供するログを確認してください。画面を表示するプロセスとプロキシのコアは別です。ウィンドウの症状だけで判断するより、レポートがどのプロセスのものか確認する方が役立ちます。発生時の操作とレポートの概要を記録し、ファイル全体をアップロードする必要はありません。

Macの機種、インストール先、システムの警告を確認

「このMacについて」でチップとプロセッサのどちらが表示されるかを確認し、AppleシリコンまたはIntelに対応したインストーラーを選んでください。再インストールや別のクライアントへの切り替えを検討する場合は、まずmacOSダウンロードページで推奨のClash Plusを確認し、システム要件に合ったものを選びます。Clash Verge RevやFlClashを使い続ける場合も、同じくMacのアーキテクチャに対応したものを選んでください。インストーラーのアイコンだけで判断しないでください。

アプリが通常の「アプリケーション」フォルダにコピーされていることを確認してください。ディスクイメージから直接開く状態と、インストール後に起動する状態は異なります。macOSがアプリとシステムの非互換性を明示している場合は、対応範囲を確認します。セキュリティ制限やシステム管理上の制限が表示される場合は、システムの案内に従って配布元とアクセス許可を確認してください。起動できるか試すためにシステムのセキュリティ機能を無効にしないでください。セキュリティ警告とプロセスのクラッシュを同じエラーとして扱わないようにします。

設定や起動時の競合を最小限の変更で切り分ける

設定をインポートした後やTUNを有効にした後に問題が起きる場合は、画面を操作できるうちに該当機能を無効にし、最後に正常動作した設定に戻します。起動時に問題が自動で再発しないよう、「システム設定 → 一般 → ログイン項目と機能拡張」で自分が追加したログイン項目を確認してください。再起動後はClashクライアントを一つだけ手動で起動し、メイン画面が安定して表示されることを確認します。その後、設定のインポート、必要な通信の取り込みの順に進めてください。

画面は開くのにコアが起動しない場合は、まずコアのエラーを確認します。設定の構造エラー、ポートの競合、サービスへのアクセス許可不足などが原因でコアの起動に失敗することがあります。この場合、画面を再インストールしても解決しない可能性があります。通常のシステムプロキシでは使えるのにTUNを有効にすると失敗する場合は、クライアントが要求するサービスのインストールやアクセス許可の案内を確認し、別のツールが仮想ネットワークを同時に制御していないか調べてください。管理対象の端末では管理者にアクセス許可を確認します。

更新後に画面の起動直後に終了する場合は、まずクライアントの対応情報を確認し、ユーザー設定をバックアップして無効にした状態で起動できるか調べます。設定ディレクトリの場所と所有者を確認し、アプリを完全に終了してバックアップを取った後に限り、該当クライアントの設定ディレクトリを別の場所に移動して検証することを検討してください。システムのライブラリをまとめて削除したり、別のクライアントのディレクトリを原因と誤認したりしないでください。

機能を一つずつ戻して結果を記録

初期状態で起動できる場合は、まず画面とコアの動作を確認し、形式が正しいと分かっている設定をインポートします。自動起動とTUNはオフのままにし、接続履歴が正常に記録されることを確認してから必要な機能を戻します。毎回一つだけ有効にし、異常のきっかけとなる操作を特定してください。初期状態でもクラッシュする場合は、Macのアーキテクチャ、システムバージョン、エラーが発生したプロセス名、再現手順をまとめ、該当プロジェクトのサポート窓口に送ります。サブスクリプションファイルや未整理のログは添付しないでください。

モバイル版:アクセス許可、バックグラウンド動作、ネットワーク切り替え

システムがVPN接続を確立しているか確認

モバイル版とmacOSのシステムプロキシは、通信を取り込む入口が異なります。まずクライアントを前面で起動し、OSのVPN構成へのアクセス許可に応答してから、システム設定で現在の接続がどのアプリに属するか確認します。ステータスバーにVPNと表示されても、何らかの接続があることを示すだけです。その接続がこのクライアントによるものか、対象の通信が利用可能なポリシーを通っているかは保証されません。公開ページを一つテストし、クライアントで該当リクエストの記録を確認してください。

スマートフォンに企業VPN、別のプロキシツール、ローカルVPNを使うフィルタリングアプリがある場合は、システムのVPN接続を使用中でないか確認します。停止するのは自分で変更する権限のあるツールだけにしてください。組織が管理する接続を削除したり上書きしたりしないでください。個人端末と比較できる場合、同じ設定が個人端末では動作し、管理対象端末でだけ失敗するなら、設定の互換性を疑う前に端末のポリシーを確認します。

プラットフォーム優先して確認する項目確認方法
AndroidVPNのアクセス許可、バックグラウンドのバッテリー管理、常駐通知画面をロックしてから解除し、新しいリクエストを送信
iOSVPN構成の所有アプリ、接続状態、オンデマンド接続の設定ネットワークを切り替えた後、再接続できるか確認

Android:バックグラウンドで停止されていないか確認

前面では正常に動作し、しばらく画面をロックすると切断される場合は、システムのVPN状態とクライアントの常駐通知が同時に消えるかを確認します。次にシステムのアプリ情報を開き、バッテリー管理を確認してください。メーカーによって設定の場所は異なり、「バッテリー使用量」や「バックグラウンドでの使用」などにあります。使用中のクライアントに限って必要に応じて制限を緩和し、同じ時間ロックした後に再テストします。端末全体の省電力機能を無効にする必要はありません。詳しい手順はAndroidのアクセス許可と省電力設定を参照してください。

VPNが接続中のままでも、一部のアプリだけ通信できない場合は、クライアントにアプリの許可リストや除外リストが設定されていないか確認します。システムで「常時接続VPN」や「VPNを経由しない接続をブロック」が有効になっていないかも確認してください。後者は通信を取り込まないアプリの動作に影響するため、その挙動をノードの障害と決めつけないでください。テストが終わったら、診断のために変更した設定を残さず、元のセキュリティ設定に戻します。

iOS:接続が復旧しない問題と古いリクエストが復旧しない問題を区別

システムのVPN設定で有効な構成のアプリを確認し、Clash Plusに戻って接続状態を確認します。オンデマンド接続を設定している場合は、実際に適用される条件を確認してください。すべてのネットワークで直ちに再接続するとは限りません。Wi-Fiからモバイル通信に切り替えてテストする際は、システムが新しいネットワークを利用可能と確認してから、新しいWebリクエストを送信します。古い音声通話やダウンロードが引き継がれないだけでは、新しい接続も使えないとは判断できません。

モバイル通信だけで失敗する場合は、今回のプロキシ機能をオフにし、システムのデータ通信と対象アプリのモバイルデータ通信の許可をそれぞれ確認します。ゲストWi-Fiだけで失敗する場合は、まずネットワークにログインしてからVPNを試してください。複数の設定を次々に切り替えないでください。クライアントと動作確認済みの設定を一つに固定し、2つのネットワークでの結果を別々に記録します。

別の端末に移行した後、機能を再確認

Macでインポートできたサブスクリプションでも、モバイル端末がデスクトップ向けの設定をすべて認識できるとは限りません。デスクトップ用のローカルポート、オーバーライド、LANポリシー、拡張項目は、別途設定が必要な場合があります。まずプラットフォームに対応した形式でテスト用の設定をインポートし、公開接続先と直接接続が必要なリソースを一つずつ確認します。モバイル端末で再開時やネットワーク切り替え時だけ失敗する場合は、ルール全体を変更する前に、通信を取り込む状態と新しいリクエストの結果を記録してください。

修復後は同じアプリを使い、前面での利用、画面ロック後の再開、ネットワーク切り替えの3つの状況で確認します。問題が続く場合は、端末のOS、ネットワークの種類、再現手順、失敗時のVPN状態を添えて報告してください。その試行に関係するログだけを個人情報が分からないようにして添付し、無関係なアプリのリクエスト一覧は共有しないでください。