接続トラブルシューティング

Mihomo:暗号化providerで no identities found

Mihomo の暗号化 proxy-provider を更新すると no identities found が出る場合は、コアの秘密鍵、provider ごとの鍵、v1.19.34 の修正と暫定対処を確認し、更新と復旧手順を検証します。

  • Mihomo
  • age
  • proxy-providers
  • サブスクリプションの復号
  • v1.19.34
目次

同じ秘密鍵で設定全体は復号できるのに、グローバル起動オプションにその鍵を指定すると、暗号化されたノード provider の更新だけが失敗する場合があります。まず最初のエラーと元の動作していた設定を残してください。すぐに鍵を作り直したり、サブスクリプションのキャッシュを削除したりしないでください。

失敗しているのが暗号化 provider かを確認する

この記事が扱うのは age ASCII armor 形式の Mihomo proxy-provider です。実行中のコアには対応するグローバル秘密鍵がある一方、項目の age-secret-key が未指定または空で、decrypt config error: no identities found が出る場合です。エラーだけでは、この不具合と断定できません。

公式 issue #3449 には、グローバル秘密鍵と provider 個別の秘密鍵を比較した報告があり、報告者は Alpha 478af2a を使用しています。v1.19.33 の固定ソースにも、先に空の鍵を解析する処理が確認できます。これを根拠に、旧版すべてやサブスクリプションの取り込み失敗すべてが影響を受けるとは判断しません。

失敗した段階から切り分ける

現在の症状先に確認すること
暗号化 provider で no identities found が出る実行中のコア、グローバル秘密鍵、provider 個別の鍵設定を確認する
ログインページが返る、認証に失敗する、ダウンロードがタイムアウトする先に内容を取得できない原因を解決する。復号のパッチだけでは直らない
メインの設定全体を読み込めないメイン設定の読み込み方と秘密鍵の取得元を調べる。provider の問題をそのまま当てはめない

グローバル秘密鍵があるのに、なぜ identity が見つからないのか

provider のパーサーは、その項目の age-secret-key を復号関数に渡します。旧実装は空文字列を受け取っても、まず秘密鍵として解析しようとします。そこでエラーになると、後続のグローバル秘密鍵を試す処理まで進みません。鍵を個別に指定していないことが、元は使えるグローバル鍵の利用を妨げる場合があります。

#3450 の修正は、完全に空の文字列をスキップして、その後のグローバル秘密鍵の処理を続けます。v1.19.34 の正式リリースに含まれています。空白文字、壊れた鍵、不正な空でない秘密鍵を有効な鍵に変えるものではなく、グローバル秘密鍵を読み込んでいないプロセスに鍵を補うものでもありません。

単体のコアでは、-age-secret-key オプションの初期値を CLASH_AGE_SECRET_KEY から読み取れます。ただし、自分のターミナルで変数を設定しても、すでに動いている GUI クライアントやバックグラウンドサービスがそれを継承した証拠にはなりません。別のターミナルの値だけで判断せず、実際にそのコアを起動している方法を確認してください。

実行中のコアを更新する。更新できなければ元の秘密鍵を個別に指定する

先に復元できる設定、従来の鍵の扱い方、暗号化 provider のキャッシュをバックアップし、動作していたコアと起動方法を記録します。暗号文と対応する秘密鍵の組み合わせを維持し、このエラーのために無関係な新しい秘密鍵を作らないでください。

プロジェクトがサポートする方法で、#3450 の修正を含むコアを入手してください。この記事で確認した正式版は v1.19.34 です。クライアントを使う場合は、そのアプリでコアをどう更新できるかを確認します。画面にあるアプリのバージョンだけで判断したり、サービスのディレクトリにあるプログラムを不用意に上書きしたりしないでください。

同じ provider で順に確認する

  1. 元の秘密鍵がこの暗号文に対応しているか確認する

    既存の有効な秘密鍵と元の provider の内容を残し、以前に動作した記録を確認します。受信者として指定した公開鍵に対応する秘密鍵が必要です。サブスクリプショントークン、公開鍵、別の設定の秘密鍵を、復号用の identity と取り違えないでください。

  2. 実際の起動ファイルと新しいコアを確認する

    単体のコアは、実際に使う実行ファイルでバージョンを確認できます。GUI クライアントやサービスでは、コア情報と新しい起動ログを確認してください。その後、プロジェクトの手順に従って通常どおり再起動します。従来の有効なグローバル秘密鍵の読み込み方法を保ち、新しいプロセスで修正を使えるようにします。

  3. すぐに更新できなければ、provider 自身のフィールドを使う

    元の proxy-providers 項目で、既存の同じ、暗号文に対応する有効な秘密鍵を age-secret-key に指定し、従来どおり保存して再読み込みします。#3449 の報告者は、この方法で復号できたと述べています。これは暫定対処の提案であり、当サイトによる実機テストの結果ではありません。

  4. ほかの設定を保ち、この項目だけを更新する

    元の provider 名、アドレス、保存先、選択したノードを変えず、同じ provider を再更新して最初のエラーを確認します。同時にサブスクリプションや鍵を変更したり、キャッシュを消したりしないでください。比較できる状態と復元手段を残すためです。

単体コアのバージョン確認:実際の起動ファイルを使う
mihomo -v

上のコマンドで分かるのは、呼び出したプログラムのバージョンだけです。PATH にある同名プログラムが、クライアントで実行中のコアとは限りません。下の例は、元の provider 項目内に追加するフィールドだけを示しており、完全な設定ではありません。プレースホルダーは既存の対応する秘密鍵に置き換えてください。そのままコピーして実行するものではありません。

暫定設定の例:元の provider 項目内に追加する
age-secret-key: "<YOUR_EXISTING_MATCHING_PRIVATE_KEY>"

秘密鍵は自分で管理する設定の保存先に置き、相談用のスクリーンショット、コマンド履歴、公開ログには貼り付けないでください。このフィールドを残すために、再生成される実行用 YAML を直接編集しないでください。従来からサポートされている設定または永続的な上書きの方法を使います。

provider の読み込みを確認し、新しいリクエストを送る

新しく起動した実際のコアに v1.19.34 の修正が含まれていることを確認してから、失敗していた provider を更新します。今回の更新が完了したか、元の復号エラーが消えたか、期待するノードが実際に読み込まれたかを確認してください。古い一覧が残っていることや構文チェックの成功だけでは、リモートの暗号文を復号できた証拠になりません。

次に、期待するノードの一つを選び、元々アクセスしたかった宛先へ新しい実際のリクエストを送り、接続記録と照合します。provider の復号成功はノード設定を取得できたことを意味するだけで、ノード、DNS、接続先サービスへの到達を保証しません。

この問題の検証チェックリスト

  • 実行中のコア、起動方法、秘密鍵の取得元が明確で、GUI のバージョンだけで判断していない。
  • 同じ provider の暗号文と対応する秘密鍵を使って検証し、サブスクリプションの変更で結果を見えなくしていない。
  • 今回の provider 更新が成功し、期待するノードが読み込まれ、元の復号エラーが再発していない。
  • 新しい実際のプロキシリクエストが正常に動く。失敗した場合は現在の最初のエラーを残し、ネットワークの問題を切り分ける。
  • バックアップを復元でき、追加した provider の秘密鍵のコピーも、自分の設定と同様に保護している。

まだ失敗する場合は、最初のエラーに沿って復旧・切り分けする

サービスやクライアントのコアに、グローバル秘密鍵が渡っていない

そのプロジェクトがサポートする起動設定に戻って確認し、通常どおり再起動してから再確認します。別のターミナルの一時的な変数だけを根拠に、すでに動いているプロセスが秘密鍵を取得したと判断しないでください。

provider に空白、誤った鍵、壊れた空でない秘密鍵を指定している

元の有効な秘密鍵と、対応する暗号文を確認します。修正がスキップするのは空文字列だけです。不正な鍵を黙って無視するものでも、自動フォールバックの成功を保証するものでもありません。

内容が想定した age ASCII armor でない、またはダウンロードに失敗している

実際の応答内容とダウンロードエラーを確認し、提供元に形式と鍵を確認します。ログインページ、認証失敗、無関係な YAML エラーを、同じパッチで説明しないでください。

保存や再読み込み後に、元の設定まで使えなくなった

変更を重ねるのを止め、動作確認済みの設定、起動方法、保護しておいたキャッシュのコピーを復元します。必要ならプロジェクトがサポートする方法で、元の動作するコアに戻してください。ロールバックは、旧版の不具合が直ったことを意味しません。

報告時は、コアの完全なバージョン、provider の種類、グローバルと個別のどちらの秘密鍵を使うか、機密情報を伏せた最初のエラーを添えてください。設定全体、元の暗号文、秘密鍵は自分で管理する場所に保管し、相談用のコピーからサブスクリプショントークン、秘密鍵、ノードのパスワードを削除します。

この記事は公式リリース、固定ソース、issue の議論を照合したものです。コアのダウンロード、利用者の認証情報の処理、実際のクライアントでの復号再現は行っていません。#3449 は現在もオープンであり、修正のマージを issue の終了や利用者による検証完了と同一視しません。

参考資料