本文目录
这次升级适合谁，先看改动范围
FlClash v0.8.97 于 2026 年 9 月 10 日作为正式稳定版发布。官方说明不是一组小修补，而是同时重构界面与本地化、应用窗口层、桌面打包、Android VPN、Helper 插件，以及核心 IPC 与进程生命周期。
本文适合正在使用 v0.8.96 或更早稳定版、准备升级，或升级后发现界面入口、TUN、Android VPN、窗口与核心状态和以前不同的用户。若旧版已经无法启动，应先恢复到可导出配置的状态。
官方没有宣称 v0.8.97 修复所有节点、订阅或 DNS 问题。只为追求新版本号而升级没有必要；需要代理认证、跨平台新界面，或愿意按清单完成回归验证时再更新。
按当前状态决定
| 当前情况 | 建议 | 理由 |
|---|---|---|
| v0.8.96 工作稳定，没有新功能需求 | 可以暂缓 | 大范围重构值得先保留可用基线 |
| 需要 v0.8.97 新增的代理认证 | 备份后升级 | 这是发布说明明确列出的新增能力 |
| 准备验证新界面、Helper 或 Android VPN | 按平台分步升级 | 一次只测试一个接管路径 |
| 旧版已出现节点 Timeout 或订阅失败 | 先定位原故障 | 升级不能代替节点、配置与 DNS 诊断 |
升级前保存 Profile、设置和可用基线
升级最重要的准备不是截图版本号，而是保留一条可以恢复的网络路径。在旧版中先暂时关闭当前 Profile 的订阅自动更新，记录当前 Profile、策略组、运行模式、系统代理或 VPN/TUN 状态，再完成一次真实 HTTPS 请求。
使用 FlClash 自带的备份或导出功能保存 Profile 与应用设置，并把备份复制到应用数据目录之外。订阅 URL、节点密码和 WebDAV 凭据都属于敏感信息，不应放进公开网盘、issue 或截图。
桌面端还应记下当前安装包架构和是否使用系统级服务；Android 则记录系统版本、电池限制与 VPN 授权状态。这样升级后才能区分应用改动和设备原有限制。
升级前基线
- 当前 FlClash 版本和操作系统架构已记录
- 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 电脑 | 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，并选择与系统和 CPU 架构匹配的附件。
核对校验清单
把文件名与同一 Release 的 SHA256SUMS 对照，不使用他人重命名或重新打包的文件。
完整退出旧版本
先关闭系统代理、TUN 或 Android VPN，再从应用入口退出，等待旧核心停止。
完成覆盖安装
保留原配置目录，不在升级过程中导入新订阅、改 DNS 或更换节点。
桌面端把界面、核心和 Helper 分开验证
v0.8.97 同时重构桌面运行器、插件、Helper、Rust bridge 与核心 IPC。窗口能够打开，只能证明界面启动；还要确认 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 更能帮助判断。
异常发生在哪一层
| 现象 | 保留的证据 | 安全动作 |
|---|---|---|
| 应用无法打开 | 系统版本、架构、安装包名、首条错误 | 恢复直连并核对官方包 |
| 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 与连接记录
- 完整退出后设备恢复直连，没有残留接管
- 升级异常已保留最小复现、首条错误和版本对照
- 订阅链接、密码、日志路径和个人信息均已脱敏