ダウンロード・解析・設定の有効化を切り分ける
リモートサブスクリプションの読み込みは、データの取得、設定の解析、設定の有効化の3段階に分かれます。画面上では一連の操作に見えても、原因はそれぞれ異なります。エラーが「読み込み」を押したとき、手動更新したとき、新しい設定に切り替えたときのどの段階で発生したかを記録しましょう。Clash Verge Revでは、サイドバーの「サブスクリプション」から設定を操作し、「ログ」で設定切り替え後にコアが出したエラーを確認できます。ボタンの位置はバージョンによって異なる場合があります。ダウンロードに失敗した場合も、データがコアに渡される前にリクエストが失敗している可能性があるため、サブスクリプション画面のメッセージを残しておきましょう。
| エラー・症状 | まず確認する項目 |
|---|---|
| HTTP 401、403、404、410 | サーバーによるアクセス拒否、または利用できないパスが考えられます。現在のサブスクリプションURLとアカウントの状態を確認してください。 |
no such host または lookup … timeout | サブスクリプションのドメイン名解決と、現在のネットワークのDNS状態。 |
certificate has expired or is not yet valid | デバイスの時刻、証明書の有効期間、エラーに記載されたドメイン名。 |
yaml: line 12 などのメッセージ | レスポンスの本文がYAMLかどうかを確認し、ローカルに保存したファイルの12行目とその前後を調べます。 |
| 設定の読み込み後、有効化するとポリシーグループが見つからない | ルールの参照先、グループ名、設定をマージした後の参照関係。 |
サブスクリプションのリンク切れ・無効化、またはログインページが返される
- サブスクリプション提供元のアカウントページでサービスの状態を確認し、使用するクライアントに対応したURLをコピーし直します。先頭が想定どおり
https://か、コピー時に引用符や改行、説明文まで含めていないか確認してください。クエリパラメーターは手動で削除しないでください。 - 提供元が最近サブスクリプショントークンを再発行していないか確認します。アカウントの有効期限とリンクの有効性は別です。アカウントが有効でも、トークンの再発行によって古いリンクが使えなくなることがあります。まず現在使える設定を残し、提供元の案内に従ってURLを更新するか、新しい設定を追加して確認してください。
- サービスの状態とHTTPレスポンスを確認します。
401は認証の問題、403はサーバーによるリクエスト拒否を示し、アクセス制限が原因の可能性があります。404はパスの入力ミスの場合もあります。429はリクエスト過多を示します。Retry-Afterがある場合は指定された時間だけ待ち、更新を連打しないでください。
HTTP 200 はレスポンスを取得できたことを示すだけです。ログインページや公衆Wi-Fiの認証ページ、サーバーのエラーメッセージも 200 で返る場合があります。提供元がレスポンスをローカルに保存できる場合は、テキストエディターで先頭部分を確認してください。<!doctype html> や <html> があれば、YAMLを変更するのではなく、Webページが返された原因を調べます。ブラウザーにはログインCookieが送信される場合がありますが、クライアントのリクエストでは通常そのセッションを共有しません。そのため、ブラウザーで開けることだけではサブスクリプションを読み込める証明にはなりません。
ネットワークタイムアウト・DNS・証明書エラー
サブスクリプションサービスまでリクエストが届いているか確認する
HTTPSのURLでポートを明示していない場合、通常はTCP 443に接続します。no such host はドメイン名の解決段階で発生します。dial tcp に続いて接続タイムアウトが表示される場合は、ログに接続先IPアドレスが記録されているか確認してください。timeout だけでは、DNS、接続確立、サーバーの応答遅延のどれが原因か判断できません。まず現在のネットワークで必要なログインを済ませ、利用権限のある信頼できるネットワークでも一度試します。リンクや設定は変えず、ネットワークだけを切り替えて比較してください。
ログに 127.0.0.1 の特定ポートへ接続できないと明記されている場合は、そのポートとクライアントに表示されている実際の待ち受けポートを照合します。システムプロキシが終了済みのクライアントを参照している、または起動していないプロキシ経由でサブスクリプションを更新する設定になっている可能性があります。現在の設定を記録してから、端末が通常どおりインターネットに接続できる状態に戻して再試行してください。TUNを有効にしても、期限切れのトークンや誤ったファイル形式は解決しません。初回の読み込み失敗に対する既定の対処として使うべきではありません。
デバイスの時刻を確認してから、証明書エラーを切り分ける
Windows 11では「設定 → 時刻と言語 → 日付と時刻」を開き、「時刻を自動的に設定する」を確認して「今すぐ同期」を実行します。表示される日付とタイムゾーンも確認してください。時刻を同期しても証明書の有効期限切れが表示される場合は、サブスクリプションのドメイン名に使われている証明書の状態を提供元に確認します。certificate signed by unknown authority と表示される場合は、システムの信頼チェーンを確認するか、管理者に管理対象ネットワークの証明書ポリシーを確認してもらいます。サブスクリプションを読み込むために証明書の検証を無効にしないでください。
YAML解析エラーとClash・mihomoの形式の違い
サブスクリプションは配布方法の一つであり、形式が決まっているわけではありません。同じ提供元でも、Clash用設定、mihomo向け設定、汎用ノードリストが別々に提供される場合があります。ノードURIだけのテキストや、エンコードされたノードリストは、Clashの完全なYAML設定としてそのまま読み込めません。proxies リストだけのファイルは、想定しているプロキシグループやルールを含むメイン設定ではなく、proxy-providers から参照するデータの場合もあります。まず提供元で、使用するクライアントとコアに合った形式を選んでください。
- 構文エラー:設定ファイルをローカルで編集した場合は、エラーが示す行とその直前のブロックについて、インデントの階層、リスト項目のハイフン、閉じ忘れた引用符を確認します。インデントにはスペースを使ってください。
mapping values are not allowed in this contextは構造上の問題を示すことが多く、エラーに表示された行が最初の誤りとは限りません。 - 未対応のフィールド・プロトコル:Clash Metaはその後、mihomoとして開発が継続されています。オリジナル版Clashとmihomoでは設定の対応範囲が異なります。たとえば、オリジナル版Clashは
hysteria2ノードに対応していません。未対応のプロキシタイプがある場合は、実際に動作しているコアとバージョンを確認してください。クライアント名だけで判断したり、検証を通すためにタイプ名を別のプロトコルに書き換えたりしないでください。 - 参照エラー:設定を読み込めても、有効化できない場合があります。たとえば、ルール
MATCH,手动选择が「手動選択」という名前のポリシーを参照しているとします。設定のマージや上書き後にそのポリシーの名前が変更または削除されると、読み込み時に見つからないというエラーがコアに表示されることがあります。リモートの元ファイルだけでなく、最終的に適用される設定を確認してください。
ローカルコピーの構文を調べるのは、元のサブスクリプションが設定ファイルである場合に限ります。クライアントがローカルファイルの読み込みに対応している場合は、手を加えていないコピーで比較できます。ローカルでは有効化できるのにリモートでは失敗するなら、ダウンロード経路やレスポンスの違いを優先して調べます。両方で同じ行の構文エラーが出るなら、元ファイルを確認してください。リモート更新でローカルの編集内容が上書きされる場合があります。検証後は問題を提供元に報告するか、必要な変更をクライアントが対応する独立したオーバーライドに保存してください。
更新に失敗しても以前の設定が残っている場合の再テスト
古い設定にノードが表示されている場合、クライアントは前回保存した内容を使っている可能性があります。今回の更新が成功したとは限りません。逆に、新しい設定が有効になっても利用可能なノードがない場合、サブスクリプションの読み込み失敗とは限りません。設定が proxy-providers でノードを別途取得する場合、メイン設定のURLとプロバイダーのURLは別々のリクエストです。まずログで、どちらのリクエストにエラーが出ているか確認してから、メインのサブスクリプションとプロバイダーのどちらを調べるか決めてください。
- 現在使える設定を残し、操作時刻、クライアントとコアのバージョン、失敗した段階、最初に表示された具体的なエラーを記録します。
- 一度に変更する条件は一つだけにします。たとえば、アカウントページからコピーし直したURLに変えるか、時刻を合わせます。その後、手動更新を一度実行し、新しい成功記録が出るか確認してください。
- 更新したばかりの設定が有効になっていることを確認します。想定したポリシーグループとノードの取得元が読み込まれているか調べてください。ノードの遅延テストは、設定の有効化に成功してから行います。遅延テストがタイムアウトしても、サブスクリプションの期限切れとは判断できません。ノードまたはテスト先を別途調べてください。
原因を特定できない場合は、個人情報を伏せた記録を添えて、サブスクリプション提供元またはクライアントのメンテナーに問い合わせます。初回の読み込みと更新のどちらで失敗したか、別の信頼できるネットワークでも再現するか、ローカルコピーでも同じエラーが出るかを伝えましょう。「読み込めない」とだけ伝えるより、原因を絞り込みやすくなります。