TheFeed数据备份与恢复完全指南：加密文件导出全部配置与消息

TheFeed 是一款基于 DNS 的 Feed 阅读器与轻量加密 messenger，让你只靠 DNS 查询就能读取 Telegram 频道、X 公开账号并收发端到端加密消息。当你要换设备、升级系统或担心数据丢失时，TheFeed 内置的数据备份与恢复功能可以一键把全部配置、聊天身份、已保存消息和媒体文件打包成一个加密的.tfbak备份文件，换设备后导入即可完整找回。

🗂️ 备份文件里都有什么？

TheFeed 的备份采用分节（Sections）设计，你可以按需选择要打包的内容。备份入口位于设置页的Backup选项卡，五个可勾选的节分别是：

备份文件的结构以魔术头TFBAK1开头，后接 16 字节随机盐值和密文区。整段数据用你的备份密码派生密钥后以AES-256-GCM密封加密，文件默认命名thefeed-backup.tfbak，单文件上限 200 MB。即使备份文件被截获，没有密码也无法读出任何内容。

加密与格式的核心实现在 backup.go，静态加密细节（Argon2id 派生密钥 + AES-256-GCM）可参考 saved_crypto.go。

📥 如何导出加密备份文件

导出操作只需三步，全程在网页端完成：

1. 打开Settings（设置）→Backup（备份）选项卡；
2. 勾选需要备份的节（profiles、chat、saved默认勾选，媒体文件与背景图按需勾选），并在下方输入框设置一个备份密码；
3. 点击Download Backup File（下载备份文件）按钮，浏览器会自动下载thefeed-backup.tfbak文件。

⚠️ 注意：如果你为 Saved 消息启用了口令锁（passphrase 模式）且当前处于锁定状态，导出saved或savedMedia会返回saved store is locked（HTTP 423），需要先解锁保存的消息存储再导出。

💾 换新设备如何恢复数据

恢复流程同样是三步，且支持预览确认，避免误恢复：

1. 在新设备的Backup选项卡中，点击文件选择器加载你的.tfbak文件，并输入导出时设置的密码；
2. 点击Open & Review（打开并预览）。界面会显示备份创建时间，以及各节的摘要——配置数量与名称、联系人/会话/消息条数、已保存条目数、媒体文件数与总大小；
3. 按需勾选要恢复的节（全部默认选中），点击Restore（恢复）确认。系统会弹出提示「This will overwrite current data. Continue?」，确认后数据即写入本地。

恢复成功后，profiles节还会自动切回备份时的活动 Profile 并重建抓取器；媒体文件会按 size + CRC 去重，已存在的不会重复写入。

❓ 常见错误与解决办法

• Wrong password（401）：预览或恢复时密码错误。备份密码不可找回，只能重新导出；
• saved store is locked（423）：Saved 存储处于口令锁锁定状态，先解锁再操作；
• no sections selected（400）：导出或恢复时一个节都没勾选，至少选择一项；
• file too large（413）：备份文件超过 200 MB 上限，建议取消savedMedia后重新导出；
• invalid backup format（400）：文件不是 TheFeed 导出的.tfbak格式，请确认文件来源。

🔐 备份安全最佳实践

• 密码牢记：.tfbak文件的安全性完全依赖备份密码，建议使用强密码并离线记录；
• 别忘了聊天恢复码：聊天身份另有独立的恢复码（recovery code），可在 Chat 页面菜单的「Show recovery code」中查看并记录。设备丢失时没有恢复码就无法找回账号，建议与备份文件分开存放；
• 多介质存档：重要备份建议同时保存云端与本地两处，.tfbak是纯二进制加密文件，可直接用网盘传输；
• 选择性备份：只想迁移配置时只勾选profiles，可让文件更小、恢复更快。

📎 相关源码位置

• 备份导出/预览/恢复接口实现：internal/web/backup.go
• 设置页 Backup 面板界面：internal/web/static/index.html
• 前端导出与恢复逻辑：internal/web/static/js/settings.js
• 端到端导出-预览-恢复完整测试：test/e2e/backup_e2e_test.go

按以上步骤操作，你就能在几秒内完成 TheFeed 数据的加密备份与跨设备恢复，换机不再丢数据。