Clashのよくある質問とトラブルシューティング

mihomoは設定の読み込み、ルールの照合、プロキシ接続の確立を担うコアです。ClashXやClash Verge RevなどのGUIクライアントは、そのコア上でサブスクリプション管理、ポリシー切り替え、システムプロキシのオン・オフを提供します。問題を切り分ける際は、画面の設定とコアの稼働状態を区別してください。画面が開いていてもコアが起動しているとは限らず、コアが起動していてもシステム通信が処理されているとは限りません。

ルールモードは設定内の rules を上から順に使い、ドメイン、IP、ルールセットを照合するため、普段使いに適しています。グローバルモードは処理可能な接続を同じポリシーグループに渡すため、ノードの一時的な検証に向いています。直接接続モードでは通信がプロキシを経由しません。接続問題の確認時は一時的にグローバルモードへ切り替えます。グローバルでは接続でき、ルールモードで失敗する場合は、ルールの順序、ポリシーグループの選択、ルールセットの読み込み状態を確認してください。

サブスクリプションURLではサーバーから設定が返され、クライアントは指定した間隔で再取得できます。ローカル設定ファイルは端末に保存され、変更してもリモート側から自動的に上書きされません。サブスクリプションはノード一覧の管理に、ローカルオーバーライドはDNS、TUN、自作ルールの追加に適しています。サブスクリプションから生成された一時ファイルを直接編集すると、次回更新時に置き換えられる可能性があります。長期的な変更は、クライアントが対応するオーバーライドまたはマージ機能に追加してください。

システムプロキシは、アプリがOSのプロキシ設定を読み取ることで動作します。ブラウザーや多くのデスクトップアプリで利用できますが、一部のゲーム、コマンドラインツール、直接接続に固定されたアプリは迂回することがあります。TUNモードは仮想ネットワークアダプターを通じてネットワーク層でより広範な通信を処理しますが、管理者権限と正しいDNS設定が必要です。普段のブラウジングではまずシステムプロキシを使い、より多くのアプリを対象にする場合はTUNを有効にしてください。

まずサブスクリプションの更新結果とコアのログを確認し、サーバーがログインページや案内文、空のレスポンスではなく、Clashが読み込めるYAML設定を返していることを確認します。次に、設定に proxies、proxy-providers、proxy-groups が存在するか確認してください。ノードが provider 内にある場合は、provider のダウンロードが成功していることも確認します。無効な設定を削除する前に、利用可能だった以前の設定へ戻すと、現在の接続が同時に切れるのを防げます。

まずブラウザーでサブスクリプションURLにアクセスできることを確認し、URLが途中で切れていないか、期限切れでないか、余分な空白がないかを確認します。現在のネットワークからサブスクリプションサーバーへ直接接続できない場合は、利用可能な設定に接続してから更新するか、更新時に使用するプロキシがクライアントに設定されているか確認してください。ログのタイムアウトはネットワーク経路、ステータスコードのエラーはサブスクリプションの権限やサーバーの状態を示すことが多いです。

Windowsでは関連サービスを管理者権限で起動し、仮想ネットワークアダプターのドライバーが正常にインストールされていることを確認します。macOSでは通常、ネットワーク拡張機能や補助サービスのインストールが求められるため、システム設定で許可してください。LinuxでTUNデバイスを作成するには、通常root権限または CAP_NET_ADMIN 権限が必要です。許可後も失敗する場合は、他の仮想ネットワークソフトを終了してクライアントを再起動し、ログでドライバー、ルーティング、DNS初期化のどの段階で失敗したか確認します。

一部のUWPアプリはローカルループバックの分離制限により、Clashが 127.0.0.1 で待ち受けるプロキシポートへ直接接続できません。クライアントのUWPループバックツールで対象アプリにループバックの免除を設定して保存し、アプリを再起動してください。プロキシが必要なアプリだけを対象にします。TUNを有効にして通信が正常に処理されている場合は、通常ループバック免除を重ねて設定する必要はありません。

select はユーザーがノードを手動で指定するため、結果が安定し管理しやすい方式です。url-test は設定した間隔で候補ノードを測定し、応答の速いノードを選ぶため、普段の自動選択に適しています。fallback は上から順に最初の利用可能なノードを使い、現在のノードが失敗すると切り替わるため、継続性を重視する場面に向いています。自動グループの結果はテストURL、interval、tolerance に左右され、すべてのサイトでの実測速度を示すものではありません。

遅延テストは通常、指定URLへの接続時間または応答時間だけを測定します。特定時点の少量通信における往復時間を示すもので、帯域幅、パケットロス、長時間接続の安定性は反映しません。クライアントによってテストURL、タイムアウト、接続の再利用方法が異なる場合もあります。ノードを選ぶ際は、複数回の連続テスト、実際のページ読み込み、ダウンロード結果を組み合わせて判断し、1回だけの最低遅延値に頼らないでください。

まずDNSリクエストが実際にClashで処理されていることを確認し、enhanced-mode、nameserver、fallback などの項目が揃っているか確認します。LAN機器、ゲーム機、実IPを必要とするアプリはFake-IPに適さない場合があるため、対象ドメインを fake-ip-filter に追加してください。ログで名前解決の失敗が続く場合は、上流DNSへの接続性を個別にテストし、別の暗号化DNS、ブラウザーのセキュアDNS、端末のファイアウォールが現在の設定を迂回していないか確認します。

まずクライアントが提供する設定のマージ、オーバーライド、スクリプト機能を使い、リモートのサブスクリプションをノードの取得元、ローカルファイルをルール、DNS、ポリシーグループの追加層として扱います。統合時は、ポリシーグループが参照するノード名または provider 名が実際に存在することを確認し、同名項目の上書き順にも注意してください。変更後は必ず設定を検証してから新しい設定へ切り替え、YAMLのインデントや重複キーによるコアの読み込み拒否を防ぎます。

まず同じポリシーグループ内の別ノードへ切り替え、問題が単一ノードなのかグループ全体なのかを確認します。次に端末の時刻、ネットワークによるプロトコル制限、ノードのアドレスとポートへの接続可否を確認してください。ログの dial tcp timeout は、宛先へ到達できないか経路が遮断されている場合に多く発生します。TLSエラーではシステム時刻、ドメイン、転送パラメーターを確認します。テスト中は重複起動しているプロキシクライアントを終了し、ポートやルートの干渉を避けてください。

多くのコマンドラインツールはデスクトップのシステムプロキシを自動的に読み取りません。ツールに応じて HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 環境変数を設定し、ポートをClashが実際に待ち受ける mixed-port、port、socks-port に変更してください。設定後は現在のターミナルで環境変数を確認し、curl でテストURLへアクセスします。1つのコマンドだけにプロキシを適用したい場合は、そのコマンドに一時的な環境変数を追加すると、パッケージマネージャーやLAN接続への影響を避けられます。

まず利用可能だった以前の設定を残し、何度も上書きしないでください。ブラウザーでサブスクリプションURLにアクセスし、権限に関する案内、期限切れの通知、Webページの内容、形式が不完全なYAMLが返っていないか確認します。同時に端末の時刻とサブスクリプションアカウントの状態も確認してください。クライアントで解析エラーが表示された場合は、ログから行番号を特定し、インデント、重複キー、現在のコアが対応していない項目を重点的に確認します。サーバーが復旧するまではキャッシュ済みの設定を使えます。

まずログで失敗しているのがGeoIPデータベース、GeoSiteデータベース、リモートの rule-provider のどれかを確認します。それぞれダウンロード先と更新手順が異なります。保存先に書き込み権限があるか、ディスク容量が十分か、現在のネットワークからデータソースへアクセスできるかを確認してください。更新中に古いファイルをすぐ削除しないでください。新しいファイルのダウンロードが不完全な場合は、クライアントを終了して該当する一時ファイルを削除し、再起動して更新をやり直します。