备份与恢复

首页 · English

要备份哪些内容

内容	快速开始示例中的位置
账户、设置、进度及其他应用数据	整个 data/storage 文件夹
电子书、漫画、PDF、有声书原文件	library 及另外添加的所有书籍文件夹
Docker 部署配置	compose.yaml、存在时的 .env

fnOS 用户需同时备份应用的 storage 数据目录和 shuku.library 共享书库。应用数据目录位于 fnOS 的应用持久数据位置，不在共享书库中；具体位置请在 NAS 上确认。

备份应另存到其他磁盘或设备，不要只放在同一块盘上。

在应用内创建备份

网页进入“设置 → 数据和系统 → 备份与恢复”，创建备份并确认列表显示成功。

这类备份保存图书信息、账户权限、阅读进度、书签和设置等记录，不包含原始读物和封面图片文件，不能代替完整文件夹备份。备份文件保存在应用数据目录内；整机故障后，同盘的备份也可能丢失。

完整备份

1. 暂停导入和阅读，停止二毛图书。Docker 用户在原部署文件夹运行：

   docker compose stop web
   

2. 复制完整应用数据、所有原始书籍文件夹及部署配置到备份位置。

3. 完成后恢复运行：

   docker compose start web
   

fnOS 用户通过应用中心停止和启动。不要只复制正在使用中的单个数据库文件。

恢复

恢复前先保存当前数据副本。应用内恢复会覆盖现有图书信息、进度和相关设置。

• 恢复应用内备份：在“备份与恢复”中选择对应备份，按提示确认。原始书籍文件不会被恢复，也不会被该操作删除。提示旧备份不受支持时，保留备份，先在匹配的旧版环境中恢复；不要反复强行导入。
• 恢复完整文件夹：停止应用，恢复完整应用数据、书籍文件夹和部署配置；使用与备份匹配的应用版本，保持原来在应用中使用的书库路径，检查权限后再启动。

恢复后确认可以登录、书库数量正确、原文件能打开，且阅读进度仍在。需要退回旧版本时，应恢复对应的更新前完整备份，不要直接让旧版使用新版数据。