FluxDown 重装不丢数据 — SQLite 数据库是真相源

为什么强调重装不丢数据

下载器的「设置 + 历史任务 + 队列配置」通常攒了很久——RSS 订阅、每日队列计划、自定义主题、Tracker 列表、Webhook 端点这些，重装一次要重配一次会很折腾。好消息是：FluxDown 的这些数据全部集中在一个 SQLite 数据库文件里，重装只要不删这个文件就不会丢。

重装路径

路径一：覆盖安装（最推荐）

不要先卸载，直接用新版覆盖安装：

路径二：卸载后重装（SQLite 位置记对）

如果你非要先卸载再装（比如 FluxDown 已经坏了），先备份 SQLite 数据库：

SQLite 数据库位置：
- Windows（安装版）  → %APPDATA%\FluxDown\fluxdown.db
- Windows（便携版）  → 解压目录旁边的 data\fluxdown.db
- macOS              → ~/Library/Application Support/FluxDown/fluxdown.db
- Linux              → ~/.local/share/fluxdown/fluxdown.db
- Docker Server      → 容器内 /data/fluxdown.db（host 上是数据卷）

卸载（只删应用）→ 重装新版 → 把备份的 fluxdown.db 放到对应位置 → 启动 FluxDown。

重要：如果新版改了数据库 schema，首次启动会自动做 migration（见 自动更新）。直接覆盖就行，不要手动 migration。

路径三：迁移到新机器

1. 旧机器：备份 fluxdown.db。
2. 新机器：装 FluxDown → 启动一次让它生成初始数据库 → 关掉 → 把备份的 fluxdown.db 替换掉新生成的。
3. 启动新机器上的 FluxDown，一切照旧。

下载文件在新机器上的路径可能和旧机器不一样——FluxDown 数据库里记录了下载时的落盘路径，如果路径找不到了（比如旧机器下载目录在 D:\Downloads 新机器没有 D 盘），FluxDown 会在启动时提示路径丢失，手动改下载目录设置即可。任务状态、队列、设置不受影响。

SQLite 备份（定期做）

建议定期手动备份 SQLite 数据库——虽然 FluxDown 引擎原子写入，数据库损坏概率极低，但磁盘故障、系统崩溃后电源突然断开都有可能影响。

简单备份：直接复制 fluxdown.db 到另一个位置（U 盘、云盘、另一硬盘都行）。

FluxDown 启动时如果检测到数据库损坏，会自动尝试修复；修复失败会提示恢复备份。

为什么不能「把旧机器的整个安装目录复制过去」

• Windows 安装版写了注册表项（Native Messaging、fluxdown:// 协议、.torrent 关联）——光复制 exe 目录没用。
• macOS 的 Application Support 目录和 .app 包是分开的——SQLite 在 Application Support 里。
• Docker 的数据在数据卷里——不在容器镜像里。
• 正确做法是：应用正常安装 → 只迁 SQLite 数据库文件。