目次
今回の更新が適しているか、まず変更範囲を確認する
FlClash v0.8.97 は 2026年9月10日に正式な安定版として公開されました。公式の説明によれば、小規模な修正の集まりではなく、UI とローカライズ、アプリウィンドウ層、デスクトップパッケージ、Android VPN、Helper プラグイン、さらにコアの IPC とプロセスライフサイクルが同時に再構築されています。
この記事は、v0.8.96 以前の安定版を使用して更新を予定している方、または更新後に画面の入口、TUN、Android VPN、ウィンドウやコアの状態が以前と異なると気付いた方を対象とします。旧版がすでに起動できない場合は、まず設定をエクスポートできる状態まで復旧してください。
公式は、v0.8.97 がすべてのノード、サブスクリプション、DNS の問題を修正したとは発表していません。新しいバージョン番号だけを目的に更新する必要はありません。プロキシ認証やクロスプラットフォームの新しい UI が必要な場合、またはチェックリストに沿って回帰テストできる場合に更新してください。
現在の状態に応じて判断する
| 現在の状況 | 推奨 | 選択理由 |
|---|---|---|
| v0.8.96 が安定して動作し、新機能が不要 | 更新を見送ってよい | 大規模な再構築の前に利用可能な基準状態を残す価値がある |
| v0.8.97 で追加されたプロキシ認証が必要 | バックアップ後に更新する | Release ノートに明記された新機能です |
| 新しい UI、Helper、Android VPN を検証する準備がある | プラットフォーム別に段階的に更新する | 一度に一つの通信取り込み経路だけをテストする |
| 旧版ですでにノードの Timeout やサブスクリプション失敗がある | まず元の障害を特定する | 更新はノード、設定、DNS の診断に代わるものではありません |
更新前に Profile、設定、利用可能な基準状態を保存する
更新前の最重要準備はバージョン番号のスクリーンショットではなく、復旧可能なネットワーク経路を一つ残すことです。旧版では現在の Profile のサブスクリプション自動更新を一時的に無効にし、現在の Profile、ポリシーグループ、動作モード、システムプロキシまたは VPN/TUN の状態を記録してから、実際の HTTPS リクエストを一度完了してください。
FlClash のバックアップまたはエクスポート機能で Profile とアプリ設定を保存し、バックアップをアプリのデータディレクトリ外へコピーします。サブスクリプション URL、ノードのパスワード、WebDAV の認証情報はいずれも機密情報です。公開ストレージ、issue、スクリーンショットへ載せないでください。
デスクトップ版では現在のパッケージのアーキテクチャとシステムサービスの使用有無も記録します。Android では OS バージョン、バッテリー制限、VPN の許可状態を記録してください。これにより、更新後にアプリの変更と端末固有の制限を切り分けられます。
更新前の基準状態
- 現在の FlClash バージョンと OS アーキテクチャを記録した
- Profile、オーバーライド、アプリ設定をアプリ外へコピーした
- 現在のポリシーグループと動作確認済みノード一つを記録した
- システムプロキシ、TUN、または Android VPN の元の状態を記録した
- 旧版で実際の HTTPS リクエストを一度完了し、接続記録を残した
- FlClash 終了後に端末を直接接続へ戻す方法を確認した
公式 Release から端末に合うパッケージを選ぶ
v0.8.97 の公式 Release では、Windows amd64・arm64 向けのインストーラと ZIP、macOS amd64・arm64 向けの DMG、Android 向けの三種類の ABI、Linux amd64・arm64 向けの AppImage、DEB、RPM が提供されています。
当サイトで確認済みのローカルバックアップは引き続き v0.8.96 です。旧いバックアップを v0.8.97 として扱わないでください。新しい安定版へ更新する場合は chen08209/FlClash の公式 Release を開き、タグ、ファイル名、SHA256SUMS を照合します。
インストール前にトレイまたはアプリメニューから FlClash を完全に終了し、旧いコアが停止したことを確認します。二つのデスクトップクライアントから同時にシステムプロキシを変更しないでください。Android VPN が動作中のまま上書きインストールし、直後に何度も起動することも避けてください。
パッケージの表記
| 対応プラットフォーム | 一般的な端末 | v0.8.97 で選ぶファイル |
|---|---|---|
| Windows | Intel または AMD 搭載 PC | windows-amd64-setup.exe |
| Windows | ARM Windows 端末 | windows-arm64-setup.exe |
| macOS | Apple M シリーズ | macos-arm64.dmg |
| macOS | Intel Mac | macos-amd64.dmg |
| Android | 多くの現行スマートフォン | android-arm64-v8a.apk |
| Linux | ディストリビューションと uname -m に合わせる | アーキテクチャに合う AppImage、DEB、または RPM |
アプリだけを置き換え、設定は同時に変更しない
公式安定版をダウンロードする
ページのタグが v0.8.97 であることを確認し、OS と CPU アーキテクチャに合う添付ファイルを選びます。
チェックサム一覧を照合する
ファイル名を同じ Release の SHA256SUMS と照合し、第三者が名前を変更したファイルや再パッケージしたファイルは使いません。
旧版を完全に終了する
システムプロキシ、TUN、または Android VPN を先に無効化し、アプリの終了操作を行って旧いコアが停止するまで待ちます。
上書きインストールを完了する
元の設定ディレクトリを残し、更新中に新しいサブスクリプションを読み込んだり、DNS やノードを変更したりしないでください。
デスクトップ版では UI、コア、Helper を個別に検証する
v0.8.97 ではデスクトップランナー、プラグイン、Helper、Rust bridge、コア IPC が同時に再構築されました。ウィンドウが開くことは UI の起動を示すだけです。Profile の読み込み、コアの継続動作、システムプロキシまたは TUN による実通信の取り込みも確認する必要があります。
初回起動では更新前の Profile と固定したノードだけを使います。まずシステムプロキシを有効にしてブラウザーからリクエストを送り、接続記録を確認します。以前から TUN を使っていた場合も、システムプロキシ経路が安定してから TUN だけを追加で有効にしてください。
プロキシ認証は新機能であり、既定で必ず有効にする設定ではありません。ローカルプロキシの入口で実際にユーザー名とパスワードが必要な場合だけ設定し、誤った認証情報は拒否され、正しい認証情報ではアクセスできることを比較して確認します。
ウィンドウは開くが、プロキシグループが空、またはコアが再起動を繰り返す
アプリまたはコアの最初のエラーを確認し、サブスクリプションの再読み込みやサービスの再インストールはまだ行わないでください。
システムプロキシは使えるが、TUN を有効にしたときだけ通信できなくなる
問題は Helper、権限、DNS、または TUN 経路にあります。システムプロキシへ戻して切り分けを続けてください。
ブラウザーのアクセスが失敗し、接続記録も空
システムプロキシが現在の FlClash ポートを指しているか確認し、ほかのプロキシクライアントを終了します。
接続記録はあるが、ノードが Timeout になる
別の動作確認済みノードへ固定し、一般的なノード障害を v0.8.97 の問題と決めつけないでください。
プロキシ認証を使うとすべてのアプリが失敗する
今回の認証設定を元に戻し、アプリがローカルプロキシへ認証情報を送信できるか確認します。
デスクトップ版の合格基準
- アプリに v0.8.97 と表示され、更新前の Profile とポリシー選択が残っている
- コアが継続して動作し、画面に IPC またはプロセスエラーが繰り返し表示されない
- システムプロキシ経由の実際の HTTPS リクエストが成功し、接続記録を確認できる
- TUN が必要な場合は、単独で有効にすると以前取り込めなかったアプリが通信できる
- 完全終了するとシステムプロキシまたは TUN が解除され、端末が直接接続へ戻る
- 一度再起動した後も Profile、ウィンドウの状態、通信の取り込み方式を利用できる
Android では一つの VPN ライフサイクルだけを検証する
Android 版 v0.8.97 では VPN サービスとライフサイクルが再構築されました。更新後は停止状態から始め、元の Profile で VPN を一度起動し、フォアグラウンドでのアクセス、画面ロック、Wi-Fi とモバイル通信の切り替えを試してから手動で停止します。
ステータスバーに VPN アイコンが表示されても、プロキシが使えるとは限りません。接続記録と実際の HTTPS リクエストを同時に確認してください。画面ロック後にアイコンが消える場合はバックグラウンド制限、アイコンが残っていてもリクエストが Timeout になる場合はノード、DNS、ルールを引き続き調べます。
Android 版の回帰テスト手順
元の Profile を確認する
アプリを開いたら Profile、ポリシーグループ、固定したノードを確認し、すべてのサブスクリプションをすぐに更新しないでください。
VPN を一度起動する
FlClash に対するシステムの VPN 要求を許可し、フォアグラウンドのリクエストが接続記録へ入ることを確認します。
ネットワーク切り替えをテストする
Wi-Fi、モバイル通信、画面ロックからの復帰を順にテストし、毎回同じ対象サイトだけを観察します。
手動で停止する
FlClash またはシステムの VPN 画面から切断し、通常のネットワークへ直ちに戻ることを確認します。
公開直後の報告は監視範囲の設定にだけ使う
v0.8.97 の公開後、公式 issue には Windows でのコア再起動、Android での設定保存、スクリプトのオーバーライド、空のプロキシグループなどの初期報告が出ています。いずれも共通の再現手順、メンテナーの結論、正式な修正がまだなく、すべてのユーザーに起きる確認済みの不具合とは表現できません。
端末で異常が起きた場合は、バージョン、プラットフォーム、パッケージ名、最初のエラー、最小再現手順を先に残します。同じ Profile で v0.8.97 と更新前のバージョンを比較する方が、データ削除、ノード変更、DNS 変更を同時に行うより判断に役立ちます。
異常が発生した層
| 症状 | 残しておく証拠 | 安全な対応 |
|---|---|---|
| アプリを起動できない | OS バージョン、アーキテクチャ、パッケージ名、最初のエラー | 直接接続へ戻し、公式パッケージを照合する |
| Profile または設定が想定と異なる | 更新前後のバックアップと該当する設定項目 | 保存を続けて旧いコピーを上書きしない |
| コアまたはプロキシグループの異常 | アプリログ、コアログ、同じ Profile | 通信の取り込みを無効にしてバージョンを比較する |
| 実際の接続だけが失敗する | ドメイン、適用ルール、送信経路、ノードの結果 | ノード、DNS、ルールの調査へ移る |
異常時は旧版へ戻し、更新時の証拠を残す
v0.8.97 を端末上で安定して起動、通信取り込み、停止できない場合は、まずシステムプロキシ、TUN、または Android VPN を無効にします。端末が直接接続へ戻ったことを確認してからアプリを完全に終了してください。新旧のプロセスが同時に動作している間に設定ディレクトリを上書きしてはいけません。
v0.8.97 の機密情報を伏せたログと現在のデータコピーを保存してから、新しいアプリをアンインストールまたは削除します。更新前に実際に動作していた公式版を再インストールし、更新前のバックアップを読み込んでください。当サイトの v0.8.96 バックアップは、旧版と明記したロールバック元としてのみ利用できます。
ロールバック後も同じ Profile、同じノード、同じネットワークで検証を繰り返します。旧版では復旧し、v0.8.97 では一貫して失敗する場合に初めて有効なバージョン比較になります。プロジェクトへ報告する際も、サブスクリプション URL、ノードのパスワード、完全な設定はアップロードしないでください。
更新またはロールバックの完了基準
- 現在の実行バージョンとパッケージの配布元を照合できる
- Profile、オーバーライド、ポリシー選択がバックアップと一致する
- システムプロキシまたは Android VPN 経由の実際のリクエストが成功する
- TUN が必要な場合は、権限、DNS、接続記録を個別に検証した
- 完全終了後に端末が直接接続へ戻り、通信の取り込みが残っていない
- 更新時の異常について、最小再現手順、最初のエラー、バージョン比較を保存した
- サブスクリプションリンク、パスワード、ログのパス、個人情報をすべて伏せた