OpenClash invalid tun stack：旧コアで復旧

OpenClash #5361 では、v0.47.156 から v0.48.002 へ更新し、旧コアを使い続けた際にこの現象が報告されています。報告者の Kwrt の fake-ip-tun モードでは、未保存の stack_type が空なのに、実際の設定には mips が書き込まれていました。

その旧コア alpha-fe22fdd はこの値の設定検証に失敗し、mixed に変更すると検証を通過して起動しました。報告はまだ未解決で、公式の修正判断も出ていません。本記事は固定バージョンのソースと整合する条件付きの切り分け手順であり、ルーター実機での再現検証は行っていません。

v0.48.002 の設定画面では、mips が TUN スタックの既定値です。生成スクリプトはまず渡されたスタック値を使い、空なら別の引数を参照し、それも空の場合に mips へフォールバックします。自分の環境で最終的に生成された設定を確認し、すべてのサブスクリプションが無条件で上書きされるとは考えないでください。

ここでの mips は TUN スタックの名称で、ルーターの MIPS プロセッサーアーキテクチャでも、MASQUE アウトバウンドの ip-stack でもありません。この名称を見ただけで、コアのアーキテクチャやアウトバウンドのノード設定を変えないでください。

Mihomo v1.19.30 の固定バージョンの解析コードには gvisor、system、mixed だけがあり、v1.19.31 にはすでに mips が含まれ、v1.19.32 でも使えます。コアによって対応する値が異なることは確認できますが、自分が使っているビルドをプラグインのバージョンだけで判断することはできません。

OpenClash は起動失敗時に enable を 0 に書き換えます。起動処理は無効な状態を検出すると、そのまま終了します。このため、stack_type を変更してから start を実行するだけでは、無効との表示が続く場合があります。復旧時には、プラグインが再び有効になったことも必ず確認してください。

まずルーターを管理できるローカル接続を確保し、中断できない転送は一時停止します。プラグイン設定、サブスクリプション、カスタム設定を別の場所へ保存して、コピーが読み取れることを確認します。以前動作していたモードとスタック、プラグインの有効・無効の状態も記録してください。

プラグインのコア情報と起動ログで、実際に読み込まれた Mihomo のバージョンを確認します。端末から実行できる別のコアが、プラグインの使用中のコアと同じとは限りません。アプリのバージョンやファイル名だけで、対応するスタックを判断しないでください。

最初のコマンドに出力がない場合、その項目が未設定の可能性があります。最終的な設定も空とは限りません。プラグインが生成した実行用設定の tun.stack を別途確認し、最初の解析エラーを記録してください。設定全体、サブスクリプションのアドレス、ノードのパスワード、コントローラーの secret は公開しないでください。

追加の検証が必要なら、プラグインが現在使っているコアと実際の設定で設定チェックを行います。チェックの成功が示すのは解析できたことだけで、転送、DNS、ローカルネットワークの通信処理まで正常とは限りません。本記事では、テスト用コアのダウンロードや報告者のバイナリの実行は必要ありません。

エラー、最終的な mips の値、コアの互換性が一致する場合に限り、以下の項目だけを変えて比較します。Mixed は今回の報告者が動作を確認し、前述の旧バージョンの固定コードでも使える選択肢です。あらゆるネットワーク環境に最適な値という意味ではありません。

プラグインが生成し、後から上書きされる可能性がある実行用 YAML は直接編集しないでください。問題を見えなくするために既定値のスクリプトを手で書き換えることも避けます。公式コアへの更新は後で個別に検討できますが、プラットフォームのアーキテクチャ、設定の互換性、バックアップを確認する必要があります。本記事ではコアを入れ替える更新手順全体を検証していません。

今回のネットワーク、時刻、変更前後のスタック値、リクエストの結果をまとめて保存します。設定チェックを通過しても接続できない場合は、ルーティング、権限、DNS、ノードの実際のエラーをさらに確認する必要があります。すべての症状をこの解析エラーだけに結び付けないでください。

記録しておいた元のスタックと有効・無効の状態に戻し、以前動作を確認した独立した設定や動作モードを使います。バックアップをインポートする必要がある場合は、先に現在の状態を別途保存し、バックアップが対応するバージョンを確認してください。データを全消去したり、唯一の設定コピーを古いプラグインで上書きしたりしないでください。

旧コアを使い続けると元の解析エラーが再発する場合は、その失敗する組み合わせの利用をいったん停止し、以前動作を確認した接続方法で管理できる状態に戻します。一時的な接続復旧と TUN の修正完了は、それぞれ別に検証する必要があります。特定のスイッチを切ればすべてのルーターが直るとは保証できません。

プロジェクトへの報告には、プラグインと実際のコアのバージョン、ファームウェアと機器、元のスタック値、最終的な tun.stack、再び有効にしたかどうか、最初の解析エラー、最小限の再現手順を含めます。サブスクリプションの Token、ノードの認証情報、secret は除き、機密情報を含む設定全体のアップロードを避けてください。

今後の公式修正、既定値の変更、新たな対象範囲については、プロジェクトのメンテナーとリリース記録を基準にしてください。本記事で確認したのはユーザー報告と明確なバージョンの上流ソースです。報告者による Dev ソースの比較を、複数バージョンでの実行検証とは扱いません。