· トラブル対処 · 約7分で読めます

ClashのサブスクリプションURLが無効・解析できないときの原因と確認手順

Clashのサブスクリプションを読み込めない原因を、URLの期限切れ、形式の非対応、ネットワーク制限、YAML構文エラーに分けて解説。順番に確認できるチェックリストも紹介します。

まず失敗した段階を確認する

現在使えている古い設定は残したまま、Clashクライアントのログまたはサブスクリプション更新の詳細を開きます。手動で一度更新し、実行時刻と最初に出たエラーを記録してください。サブスクリプションの読み込みは、レスポンスの取得、設定の解析、コアによる読み込みの3段階で進みます。画面に表示される「更新失敗」は、どの段階のエラーでも起こり得ます。

エラー・症状まず確認すること
401、403、404アカウントの状態、URLの完全性、サーバー側のアクセス制限
no such host、timeout、x509ドメイン名の解決、接続経路、証明書の信頼性
HTTP 200なのに形式が無効と表示されるレスポンスが設定ファイル、ログインページ、汎用ノード一覧のどれか
yaml: line 12 または unsupported proxy typeYAMLの構造とコアの対応範囲をそれぞれ確認する

401・403・404:URLとアカウントの状態を確認

  1. サービス提供元のアカウントページからURLをコピーし直します。Clashまたはmihomo向けと明記されたサブスクリプションを選んでください。貼り付けたURLに引用符、改行、末尾の空白が含まれていないか確認します。クエリパラメーターはそのまま残し、?以降を手作業で削除・変更しないでください。画面上で省略表示されたURLからコピーするのも避けましょう。
  2. 有効期限とトークンの状態を確認します。アカウントにログインできても、以前のサブスクリプションURLが有効とは限りません。更新、サブスクリプションのリセット、サービスの移行をした直後なら、まずアカウントページに表示されている最新のURLで設定を新規作成し、正常に読み込めた後で古い項目を置き換えてください。
  3. HTTPステータスコードで原因を絞ります。401は通常、認証失敗を示します。403はリクエストが拒否された状態で、アカウント権限、アクセス頻度、ゲートウェイのポリシーなどが原因として考えられます。404はURLのパスが変更されたか、サーバー側でリソースの状態が隠されている可能性があります。429はリクエスト過多を示すため、サービス提供元の案内に従って時間を置いてください。連続して再試行しないようにしましょう。

ブラウザーでは開けるのにClashクライアントで403が返る場合は、Safariで「ファイル」→「新規プライベートウインドウ」を開いて再確認してください。通常のウインドウではログイン済みCookieが使われることがありますが、サブスクリプション更新機能は通常、ブラウザーのセッションを共有しません。プライベートウインドウでもClashクライアントと完全に同じ結果になるとは限りません。リクエストの識別情報や接続経路が異なる場合があります。ログイン後にしか内容を表示できない場合は、サブスクリプションの直リンクではなく、WebページのURLをコピーしていないかサービス提供元に確認してください。

タイムアウト・解析エラー・証明書エラー:macOSのネットワークを確認

現在の接続とプロキシポートを確認する

macOS 13以降では、「システム設定」→「ネットワーク」→現在のネットワークサービス→「詳細」→「プロキシ」を開きます。WebプロキシとセキュアWebプロキシの接続先が、現在も待ち受けているアドレスか確認してください。たとえばシステム設定が127.0.0.1:7890を指定している一方、Clashクライアントの混合ポートが7897に変更されていると、システムプロキシを使うアプリは接続できないことがあります。このポート番号は確認用の例です。実際の設定はClashクライアントの画面で確認してください。

サブスクリプション更新機能がシステムプロキシを使うかどうかは、Clashクライアントとダウンロード設定によって異なります。設定を切り替える前は更新できていた場合、まず以前の設定に戻して確認してください。システムプロキシやTUNがテストに影響している場合は、利用が許可されたネットワーク上で設定を一度に一つだけ変更し、同じサブスクリプションURLで結果を比較します。Safariでページが開けることだけを根拠に、更新機能も接続できると判断しないでください。

DNS・タイムアウト・TLSを切り分ける

  • no such host:まずドメイン名の入力を確認し、現在のネットワークサービスの「詳細」にある「DNS」を確認します。公共Wi-Fiを使っている場合は、ネットワークのログイン認証が完了していることも確認してください。
  • i/o timeout:エラーが名前解決時、接続時、レスポンス待ちのどの段階で発生したか確認します。可能であれば、利用が許可された別のネットワークでも一度テストしてください。特定のネットワークだけで失敗する場合は、そのネットワークのプロキシやアクセス制限を優先して確認します。すぐにサブスクリプションをリセットする必要はありません。
  • x509: certificate signed by unknown authorityや証明書の有効期限切れが表示される場合は、「システム設定」→「一般」→「日付と時刻」を開き、システム時刻が正しいか確認してください。解決しない場合は、ネットワーク管理者またはサービス提供元に問い合わせます。証明書の検証を無効にしたり、入手元の不明なルート証明書をインストールしたりしないでください。

HTTP 200でも解析できない:レスポンス形式を確認

200はサーバーがコンテンツを返したことを示すだけで、その内容が設定ファイルとは限りません。Clashクライアントでレスポンスをプレビューできる場合は、先頭部分と主要なフィールドを確認してください。<!doctype html>、ログイン案内、ゲートウェイの案内が表示されるなら、レスポンスがWebページに置き換わった理由を調べます。JSON形式のエラーオブジェクトが返っている場合は、まずサーバー側のエラーメッセージを確認してください。拡張子を.yamlに変えても形式は変わりません。

  • 完全な設定ファイル:通常はproxies:またはproxy-providers:が含まれ、proxy-groups:やrules:が記述されている場合もあります。トップレベルのフィールドと参照関係が、使用中のコアの要件を満たしている必要があります。
  • プロキシプロバイダーから参照するデータのみ:YAMLファイルによってはノード一覧だけを含み、既存の設定ファイルからproxy-providersで参照する形式になっています。この形式のURLを取得した場合は、完全な設定ファイルを取得できるURLがあるかサービス提供元に確認してください。設定全体をそのまま置き換えられるとは限りません。
  • 汎用ノードサブスクリプション:レスポンスがBase64テキストの場合もあれば、ss://などのURIが1行ずつ並ぶ場合もあります。読み込めるかどうかは、Clashクライアントがその形式の入口に明確に対応しているかによります。対応していない場合は、サービス提供元が案内する形式を使ってください。

同じURLでも、リクエストの識別情報によって異なる形式が返る場合があります。ブラウザーのプレビューとログの内容が一致しない場合は、現在使用しているClashクライアント向けにサービス提供元が案内しているURLを優先してください。ログでメイン設定のURLとプロキシプロバイダーのURLを区別できる場合は、どちらが失敗したのかも確認します。メイン設定を取得できても、そこから参照されるノードデータまで更新されたとは限りません。

YAMLの行番号エラーとコアのエラーは分けて対処

行番号が表示されたら、インデントとリストを確認

設定ファイルのコピーをローカルのテキストエディターで開きます。ログに12行目と表示されていても、11行目や同じ階層のフィールドも確認してください。パーサーは、次の項目を読み込む段階で、直前の項目の引用符、コロン、リスト記号の不足に気づくことがあります。インデントにはTabではなくスペースを使い、同じ階層の項目を揃えます。次の例はルール一覧の書き方のみを示すもので、完全な設定ファイルではありません。

rules:
  - DOMAIN,example.com,DIRECT
  - MATCH,DIRECT

リモートサブスクリプションを更新すると、手動編集した内容が上書きされることがあります。ダウンロード直後のレスポンスに構文エラーがある場合は、該当行とエラーの種類を、機密情報を隠したうえでサービス提供元に報告してください。アプリの上書き設定を適用した後だけエラーが出る場合は、直近で変更した上書き項目を無効にしてから、コピーした設定で再テストします。

解析できても読み込めない場合は、コアを確認

unsupported proxy typeはインデントエラーではありません。現在のローダーが、設定ファイルに記述されたノードの種類に対応していないことを示します。Clashクライアントの「このアプリについて」または起動ログで、クライアントとコアのバージョンを記録してください。たとえばログにmihomo v1.19.0と表示されます。アプリのバージョンはコアのバージョンの代わりにはなりません。Clash Meta(mihomo)向けの設定には、旧バージョンのClashコアが認識できないプロトコルやフィールドが使われている場合があります。サービス提供元の案内とコアのドキュメントを照らし合わせてください。

プロキシやポリシーグループが見つからないというエラーなら、名前の参照先を確認してください。rulesに指定されたターゲットが、組み込みポリシー、ノード、またはポリシーグループと一致している必要があります。ポリシーグループに列挙されているノード名が存在するかも確認します。上書き設定でグループ名だけを変更し、ルール側を更新していないケースにも注意してください。エラー行を単純に削除するのは避けましょう。最後のフォールバックルールを削除したり、誤ったポリシーに変更したりすると、設定の読み込みには成功しても通信先が変わることがあります。

修正後は更新・読み込み・接続をそれぞれ確認

  1. 更新を確認します。手動で一度更新し、対象項目の更新時刻とログを確認して、新しいレスポンスと古いキャッシュを区別します。リモートのプロキシプロバイダーを使っている場合は、その更新結果も確認してください。
  2. 読み込みを確認します。読み込んだばかりの設定を明示的に選択し、コアが受け付けているか、ノードとポリシーグループが表示されるか確認してください。更新に成功しても設定を切り替えていなければ、画面には古いノードが表示されたままの場合があります。
  3. 接続を確認します。直結する想定のサイトとプロキシ経由の想定のサイトを一つずつ使い、接続ログでルールと通信先が意図どおりか確認してください。ノードのタイムアウトだけが続くなら、問題はサブスクリプションの読み込みではなくノードへの接続にあります。サブスクリプションURLを変更し続ける必要はありません。

解決しない場合は、macOSのバージョン、Clashクライアントのバージョン、コアのバージョン、更新時刻、HTTPステータスコード、最初に発生したエラー(機密情報は伏せる)を記録してください。利用が許可された別のネットワークでも再現するかを添えて問い合わせます。接続や通信の経路制御に関する問題は、設定のトラブル診断も参考にしてください。

Clashをダウンロード