Clashの起動ログを確認する:ウィンドウ終了とカーネル終了を見分ける

クライアントを起動してウィンドウが消えたら、まずタスクトレイやメニューバーにアイコンが残っているか確認します。ウィンドウを閉じてもバックグラウンドで動作し続けるクライアントもあれば、ウィンドウは表示されたままでもカーネルの子プロセスが終了し、接続エラーになる場合もあります。調査時は起動をクリックした時刻を記録し、再試行は一度だけにして、その時刻の画面ログ、カーネルログ、システムログを照らし合わせてください。複数回の起動で出た別々のエラーを混同せずに済みます。

  • ウィンドウを開ける場合:クライアントに「ログ」と「カーネルログ」の入口がある場合は、まずカーネルログで最初に出たエラーを確認し、次に画面ログで起動対象のカーネルのパスと、実際に読み込まれた設定ファイルのパスを確認します。
  • Windowsでウィンドウが一瞬で消える場合:「イベント ビューアー」→「Windowsログ」→「アプリケーション」を開き、起動した時刻のエラーを探します。「アプリケーション エラー」の記録があれば、障害が発生したアプリケーション名とモジュール名を確認し、終了したのがクライアント本体かカーネルかを見分けてください。通常の設定読み込みエラーは、ここに記録されないこともあります。
  • macOSでウィンドウが一瞬で消える場合:「アプリケーション」→「ユーティリティ」→「コンソール」で、該当時刻のクラッシュレポートを探します。レポートがない場合は、クライアントが保存した起動ログも確認してください。エラーを出力した後にプロセスが自ら終了する場合、クラッシュレポートは作成されません。
ログの内容次に確認すること
yaml: line 12実際に読み込まれたYAMLを開き、12行目から上に向かってインデントとリストの構造を確認します。
address already in use同じログに記載されたアドレス、ポート、プロトコルをもとに、待ち受け中のプロセスを調べます。
no such file or directory不足しているのがカーネル、設定ファイル、ルールファイルのどれかを確認し、エラーに記載された完全なパスを調べます。
exec format errorカーネルファイルの形式と、インストールパッケージが使用中のOSおよびプロセッサアーキテクチャに対応しているかを確認します。

YAML設定エラー:エラー行だけでなく直前の項目も確認

ログに12行目と表示されても、誤りが12行目にあるとは限りません。たとえば11行目の文字列の引用符が閉じていないと、パーサーが次の行まで読み進めてからエラーを出すことがあります。まずログに記載されたパスからファイルを開き、行番号と空白文字を表示できるテキストエディターで確認してください。購読の統合やオーバーライドに対応したクライアントでは、カーネルが読み込むのは購読元のファイルではなく、生成後の設定ファイルであることがよくあります。生成されたファイルで問題を特定したら、原因に応じてローカルのオーバーライドまたは購読元を修正しましょう。次回の更新で変更が上書きされるのを防げます。

まず構文を確認し、次に参照先を調べる

  1. 同じ階層の項目はインデントをそろえ、Tabではなくスペースを使います。mixed-port: 7890のようなキーと値の間は、コロンの後に半角スペースを1つ入れます。2~3行前までさかのぼり、閉じていない引用符や、リスト項目の先頭にある-の抜けがないかも確認してください。
  2. ファイルの先頭が<!doctype html>なら、ダウンロードされたのは設定ファイルではなく、ログインページやエラーページの可能性があります。購読元に戻り、URLと出力形式を確認してください。WebページをYAMLとして修正したり、アクセストークン付きの購読URLを公開の質問掲示板に貼ったりしないでください。
  3. ログにポリシーグループやルールセットが見つからないとある場合は、ルール末尾のターゲット名がproxy-groups内の名前と一致するか、RULE-SETの参照先がrule-providers内のキーと対応しているか確認します。YAMLとして解析できても、参照先が有効とは限りません。mihomoから旧バージョンのClashカーネルに戻した場合は、そのバージョンが使用中のフィールドやルールタイプに対応しているかも確認してください。

最小限のローカル設定で購読とオーバーライドを切り分ける

まずクライアントから設定をエクスポートするか、クライアントを終了して元の設定をバックアップします。その後、以下の数行をtest.yamlとして別名保存し、現在使用中の購読設定には上書きしないでください。この例ではローカルホストの混合プロキシポートだけを待ち受け、ルールに一致した通信はすべて直接接続します。プロキシノードのテストは行いません。7890がすでに使用中の場合は、次のセクションで空いているポートを確認してから起動テストを行ってください。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

同じバージョンのmihomo実行ファイルを別途用意できる場合は、-tで設定を検証できます。以下はWindows PowerShellでの実行例です。カレントディレクトリにmihomo.exe、test.yaml、今回のテスト用に用意した空のディレクトリclash-test-homeがあるものとします。

.\mihomo.exe -t -d .\clash-test-home -f .\test.yaml

ここでは、-dでカーネルの作業ディレクトリを、-fで設定ファイルを指定しています。テストが通った後は、待ち受けポートとクライアントの起動手順が正常か確認するため、実際に一度起動してください。元の設定をテストする場合、作業ディレクトリ内のルールファイルなどに依存していると、空のディレクトリでは別のファイル不足エラーが出ることがあります。そのエラーをYAML構文エラーと混同しないでください。

7890ポートの競合:アドレスとプロトコルを確認してプロセスを特定

mixed-portはHTTPとSOCKSプロキシで共用する待ち受けポート、external-controllerはコントロールAPIのアドレスです。実際のエラーはDNSの待ち受けアドレスが原因の場合もあります。ログにlisten tcp 127.0.0.1:7890とあればTCPの7890番ポートを調べます。コントロールAPIの127.0.0.1:9090でエラーが出ている場合、混合ポートだけを変更しても競合は解消しません。また、0.0.0.0:7890のようなワイルドカードアドレスは、ループバックアドレスでの待ち受けもすでにカバーしている可能性があるため注意してください。

Windows:待ち受けの記録を見つけてPIDを確認

netstat -ano -p tcp | findstr ":7890"

「ローカル アドレス」列の末尾が:7890で、状態がLISTENINGになっているか確認します。検索結果にリモートポートだけが7890の接続が含まれることもあるため、その行をポートの使用プロセスと誤認しないでください。最後の列に表示されるPIDを確認し、「タスク マネージャー」→「詳細」で該当プロセスを調べます。エラーにUDPとある場合は、netstat -ano -p udpで該当するローカルポートを確認してください。UDPの結果にはTCPのような待ち受け状態の列はありません。

macOS:TCPの待ち受けプロセスを一覧表示

lsof -nP -iTCP:7890 -sTCP:LISTEN

出力のCOMMAND列とPID列でプロセスを確認します。UDPポートの場合はlsof -nP -iUDP:7890を使い、7890をログに記載された実際のポート番号に置き換えてください。一般ユーザー権限ではすべてのプロセスを確認できないことがあります。また、結果が空でも、すでに使用プロセスが終了している可能性があります。できればエラーが出た直後に照合してください。

カーネルファイルが見つからない:パス・パッケージ・OSのアーキテクチャを確認

クライアントの画面とプロキシカーネルは別の構成要素です。アプリのアイコンが表示されていても、起動時に呼び出すカーネルファイルが残っているとは限りません。ポータブル版でメインプログラムだけを圧縮ファイルから取り出した場合や、アップデート後も古いディレクトリを参照している場合などは、画面からカーネルを見つけられないことがあります。ログに子プロセスの起動失敗とある場合は、エラーに記載されたパスが実行ファイルを指しているか確認してください。ルールセット、地理データ、設定ファイルを指している場合は、カーネルを入れ替えるのではなく、該当リソースを戻すか作業ディレクトリを修正します。

  1. ファイルの場所を確認する。ログに記載された完全なパスを開き、ファイルがあるか確認します。ポータブル版はフォルダー構成を維持したまま、パッケージ全体をローカルディレクトリに展開してください。インストール版は、同じクライアントの配布パッケージで修復するのが基本です。他のクライアントのカーネルを適当に改名して配置しないでください。
  2. OSとアーキテクチャを確認する。Windowsでは「設定」→「システム」→「バージョン情報」の「システムの種類」で、x64とARM64を確認します。macOSではAppleメニュー→「このMacについて」で、AppleシリコンかIntelプロセッサかを確認してください。配布ページにarm64、x64、universalと記載されている場合は、プロジェクトのOS・アーキテクチャの案内に従って選びます。
  3. システムによるブロックの有無を確認する。Windowsでは「Windows セキュリティ」→「ウイルスと脅威の防止」→「保護の履歴」で、日時とパスを確認します。macOSでは「システム設定」→「プライバシーとセキュリティ」で該当する通知を確認してください。入手元が不明なパッケージや、システムが具体的な脅威を報告したファイルは実行せず、プロジェクトの信頼できる配布元から入手し直してください。調査のためにシステム全体の保護を無効にしないでください。
  4. TUNの起動失敗かどうかを確認する。設定の読み込みとローカルプロキシの待ち受けがログに記録された後で、仮想インターフェース、ルート、権限のエラーが出ている場合、カーネルは見つかっています。クライアントを開ける場合は、まずTUNを無効にして通常の待ち受けを試してください。ローカル設定を使う場合は、テスト用コピーの既存のtunセクションでenableをfalseに変更します。同じ名前のセクションを新たに追加しないでください。無効にすると起動できる場合は、クライアントの説明に従ってサービスや権限の要件を個別に確認します。

最小構成でもクラッシュする場合:クライアントの状態を切り分けて段階的に戻す

同じバージョンの単体カーネルが最小構成で起動するのに、GUIクライアントが起動直後に終了する場合は、前回の設定の自動復元、自動で有効になるTUN、アップデート後に残ったカーネルのパスなど、クライアント固有の状態を確認します。アプリを正常に終了し、バックグラウンドにプロセスが残っていないことを確認してから、クライアントのドキュメントでデータディレクトリを調べてください。ユーザーデータを再作成できる場合は、先にバックアップを取り、アプリが新しいディレクトリを作成できるよう古いディレクトリの名前を一時的に変更します。古いディレクトリを直接削除したり、新旧のデータを一度に混在させたりしないでください。

  1. まず空の状態で画面を開き、最小構成だけを読み込みます。いったん終了してもう一度起動し、前回の状態の復元によって再びクラッシュしないことを確認してください。
  2. 購読設定を戻して起動できることを確認したら、オーバーライドとルールを一つずつ戻します。項目を追加するたびに再起動してください。最後にシステムプロキシまたはTUNを戻します。最小の直接接続設定で起動できても、原因の一部を切り分けられただけで、購読先のノードが使えることの証明にはなりません。
  3. それでも起動しない場合は、OSのバージョン、クライアントのバージョン、カーネルのバージョン、直近の変更内容、最初のエラーの前後数行を記録します。ログを共有する前に、購読URL、トークン、ノードの認証情報、ローカルのユーザー名を隠してください。終了を示す最後の1行だけでは、原因を特定できないことがほとんどです。