インストールと移行 · Clash 技術ブログ

FlClash 0.8.97へ更新する方法:Helper・VPN・ロールバックガイド

FlClash 0.8.97 では UI、デスクトップ Helper、Android VPN、コアプロセスが再構築されました。更新前に Profile をバックアップし、更新後はプラットフォーム別にシステムプロキシ、TUN、サブスクリプション、終了後の復旧を確認します。異常時は更新前のバックアップからロールバックできます。

  • FlClash
  • v0.8.97
  • バージョンアップ
  • Helper
  • Android VPN
目次

更新前に、旧版で十分なのか、FlClash v0.8.97の新機能が必要なのかを判断します。更新すると決めたら元の設定とアクセスの記録を残し、機器に合う公式インストーラーを選びます。画面が開いた後も、バックグラウンドプロセスと普段の接続は別々に確認する必要があります。

FlClash v0.8.97 は何を作り直し、更新する価値はある?

FlClash v0.8.97は2026年9月10日に正式な安定版として公開されました。公式の変更点では、画面とローカライズ、アプリのウィンドウ層、デスクトップ向けパッケージ、Android VPN、Helperプラグイン、コアのIPCとプロセスのライフサイクルをそれぞれ確認してください。

v0.8.96 以前の安定版から更新するときは、新しい画面の入口、TUN、Android VPN、ウィンドウ、コアの状態を確認します。Helper はデスクトップのシステム操作を補助するバックグラウンド部品、IPC はアプリとコアの通信方式です。旧版が起動できない場合は、設定を出力できる状態に戻してから進めてください。

公式は、v0.8.97 がすべてのノード、サブスクリプション、DNS の問題を修正したとは発表していません。新しいバージョン番号だけを目的に更新する必要はありません。プロキシ認証やクロスプラットフォームの新しい UI が必要な場合、またはチェックリストに沿って回帰テストできる場合に更新してください。

現在の状態に応じて判断する

現在の状況推奨選択理由
v0.8.96 が安定して動作し、新機能が不要更新を見送ってよい大きな作り直しの前に、復元できる旧設定を残す
v0.8.97 で追加されたプロキシ認証が必要バックアップ後に更新するRelease ノートに明記された新機能です
新しい UI、Helper、Android VPN を検証する準備があるプラットフォーム別に段階的に更新するシステムプロキシ、TUN、VPN のうち、一度に一つの方式だけをテストする
旧版ですでにノードの Timeout やサブスクリプション失敗があるまず元の障害を特定する更新はノード、設定、DNS の診断に代わるものではありません

Profile と設定を保存し、更新前の通信結果を記録する

旧版で現在の Profile のサブスクリプション自動更新を一時停止し、Profile、ポリシーグループ、動作モード、システムプロキシまたは VPN/TUN の状態を記録します。実際の HTTPS リクエストを行い、FlClash の終了後に直接接続へ戻ることも確認してください。これらを更新前後の比較に使います。

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 の v0.8.97 公式 Release でタグ、ファイル名、SHA256SUMS を確認してください。

パッケージの表記

対応プラットフォーム一般的な端末v0.8.97 で選ぶファイル
WindowsIntel または AMD 搭載 PCwindows-amd64-setup.exe
WindowsARM Windows 端末windows-arm64-setup.exe
macOSApple M シリーズmacos-arm64.dmg
macOSIntel Macmacos-amd64.dmg
Android多くの現行スマートフォンandroid-arm64-v8a.apk
Linuxディストリビューションと uname -m に合わせるアーキテクチャに合う AppImage、DEB、または RPM

アプリだけを置き換え、設定は同時に変更しない

  1. 公式安定版をダウンロードする

    ページのタグが v0.8.97 であることを確認し、OS と CPU アーキテクチャに合う添付ファイルを選びます。

  2. チェックサム一覧を照合する

    端末のファイル検証ツールでインストールパッケージの SHA256 を計算し、同じ Release の SHA256SUMS にある該当ファイルの値と全桁を比較します。ファイル名が一致するだけでは不十分です。他人が名前を変えたり再梱包したりしたファイルは使わないでください。

  3. 旧版を完全に終了する

    システムプロキシ、TUN、または Android VPN を先に無効化し、アプリの終了操作を行って旧いコアが停止するまで待ちます。

  4. 上書きインストールを完了する

    元の設定ディレクトリを残し、更新中に新しいサブスクリプションを読み込んだり、DNS やノードを変更したりしないでください。

デスクトップのウィンドウが開いたら、コア、システムプロキシ、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 は起動、回線切り替え、画面ロック、停止後も正常?

ステータスバーに VPN アイコンが表示されても、プロキシが使えるとは限りません。接続記録と実際の HTTPS リクエストを同時に確認してください。画面ロック後にアイコンが消える場合はバックグラウンド制限、アイコンが残っていてもリクエストが Timeout になる場合はノード、DNS、ルールを引き続き調べます。

Android でアプリを更新した後の確認手順

  1. 元の Profile を確認する

    アプリを開いたら Profile、ポリシーグループ、固定したノードを確認し、すべてのサブスクリプションをすぐに更新しないでください。

  2. VPN を一度起動する

    FlClash に対するシステムの VPN 要求を許可し、フォアグラウンドのリクエストが接続記録へ入ることを確認します。

  3. ネットワーク切り替えをテストする

    Wi-Fi、モバイル通信、画面ロックからの復帰を順にテストし、毎回同じ対象サイトだけを観察します。

  4. 手動で停止する

    FlClash またはシステムの VPN 画面から切断し、通常のネットワークへ直ちに戻ることを確認します。

更新後の異常で、正式修正があるものと利用者報告だけのものは?

v0.8.97 の公開後、公式 issue には Windows でのコア再起動、Android の設定保存、スクリプトのオーバーライド、空のプロキシグループなどの初期報告が寄せられました。

スクリプトの報告者は後に、変数を const または let で宣言すると解決したと説明し、issue を閉じています。報告ごとに状態と証拠は異なり、すべてのユーザーに起きる不具合とは言えません。また、報告者の対処方法を、メンテナーが確認した共通の修正として扱うこともできません。

v0.8.98 に明記されているのは、Windows Modern Standby で Core を維持する修正と Geo ファイル情報を更新する修正の二つだけです。これを根拠に、ほかの報告も解決済みとは言えません。

端末で異常が起きた場合は、バージョン、プラットフォーム、パッケージ名、最初のエラー、最小再現手順を先に残します。同じ Profile で v0.8.97 と更新前のバージョンを比較する方が、データ削除、ノード変更、DNS 変更を同時に行うより判断に役立ちます。

実際の異常に対応する証拠を残す

症状残しておく証拠安全な対応
アプリを起動できないOS バージョン、アーキテクチャ、パッケージ名、最初のエラー直接接続へ戻し、公式パッケージを照合する
Profile または設定が想定と異なる更新前後のバックアップと該当する設定項目保存を続けて旧いコピーを上書きしない
コアまたはプロキシグループの異常アプリログ、コアログ、同じ Profile通信の取り込みを無効にしてバージョンを比較する
実際の接続だけが失敗するドメイン、適用ルール、送信経路、ノードの結果ノード、DNS、ルールの調査へ移る

異常時は旧版へ戻し、更新時の証拠を残す

v0.8.97 を端末上で安定して起動、通信取り込み、停止できない場合は、まずシステムプロキシ、TUN、または Android VPN を無効にします。端末が直接接続へ戻ったことを確認してからアプリを完全に終了してください。新旧のプロセスが同時に動作している間に設定ディレクトリを上書きしてはいけません。

機密情報を削除した v0.8.97 のログと現在のデータのコピーを保存してから、新しいアプリをアンインストールまたは削除してください。ロールバックには、アップグレード前にその端末で確実に動作していた公式バージョンを選び、アップグレード前のバックアップを読み込む必要があります。ダウンロードページで現在提供している当サイトのバックアップが必要な旧版とは限らないため、ロールバック前にバージョンと配布元を確認してください。

ロールバック後も同じ Profile、同じノード、同じネットワークで検証を繰り返します。旧版では復旧し、v0.8.97 では一貫して失敗する場合に初めて有効なバージョン比較になります。プロジェクトへ報告する際も、サブスクリプション URL、ノードのパスワード、完全な設定はアップロードしないでください。

参考資料