配置备份与恢复 —— KOReader 全部数据安全落地
为什么要备份
KOReader 存储了你的阅读生涯：高亮、笔记、书签、阅读进度、排版配置、词典、书单……一次设备损坏、换设备、或升级出问题——可能全部丢失。
建议：每月至少备份一次配置目录。
KOReader 数据在哪
所有 KOReader 数据集中在一个配置目录下，不同平台路径不同：
| 平台 | KOReader 配置目录 |
|---|---|
| Android | KOReader 设置中指定（通常内置存储） |
| Kindle | /mnt/us/.koreader/（USB 挂载后在设备根目录的隐藏文件夹） |
| Kobo | .adds/koreader/ 下的配置子目录 |
| PocketBook | 系统设置的应用数据目录 |
| Linux | ~/.config/koreader/ |
KOReader 配置目录结构示例：
.koreader/
├── data/ ← 词典、OCR 语言包等数据
│ ├── dict/ ← StarDict 词典
│ ├── tessdata/ ← OCR 语言包
│ └── plugins/ ← 插件配置
├── cache/ ← 渲染缓存（可安全删除）
├── patch/ ← 用户补丁
├── setting.dat ← 全局设置（可直接删，会恢复默认）
├── profile.lua ← 配置文件
└── 每本书的 .sdr/ 子目录 ← 书内高亮、笔记、进度、书签手动备份（最可靠）
第一步：关闭 KOReader
确保没有正在打开的书——让所有进度、笔记都落盘。
第二步：复制配置目录
把整个 KOReader 配置目录复制到电脑：
Kindle/Kobo/PocketBook
- USB 连接电脑
- KOReader 配置目录是隐藏的——在文件管理器中开启"显示隐藏文件"
- 找到配置目录（如上表）
- 整个目录复制到电脑（压缩包更好，方便管理）
Android
- 文件管理器直接复制（如果 KOReader 配置在公共存储）
- 或用 KOReader SSH/SFTP 传（见 SSH传书）
- 或 USB 连接后复制
Linux
cp -r ~/.config/koreader/ ~/koreader_backup_$(date +%Y%m%d).tar.gz第三步：标记日期和版本
备份文件名加上日期和 KOReader 版本号，方便日后回溯。
恢复备份
全新设备恢复
- 新设备上安装 KOReader
- 确认新设备的配置目录
- 把电脑上的备份完整复制到新设备的配置目录
- 重启 KOReader → 所有设置、高亮、笔记、书单、配置文件全部回来
单本书恢复
只丢了某本书的进度？找到那本书的 .sdr/ 子目录复制回来即可。
迁移到新设备
买了新的 Kindle/Kobo/PocketBook？从旧设备迁移：
- KOReader 配置目录：直接复制（含设置、书单、词典、插件、用户补丁）
- 书籍文件：从旧设备复制全部电子书文件到新设备（保持目录结构一致）
- 重启新设备 KOReader → 自动识别书籍和所有元数据
跨平台迁移（Kobo → Android）
这是最棘手的情况——不同平台的配置目录路径不同：
- 从旧设备导出所有书籍文件
- 从旧设备复制 KOReader 配置目录
- 在新设备安装 KOReader
- 把书籍文件放到新设备的书库目录
- 从旧配置目录中手动迁移感兴趣的部分：
data/dict/（词典）→ 迁移到新设备词典目录data/tessdata/（OCR 语言包）→ 迁移到新设备patch/（用户补丁）→ 如果需要则迁移setting.dat（全局设置）→ 可能需要手动重设（不同平台设置不同）
高亮和笔记：每本书的 .sdr/ 子目录是绑定书籍路径的——跨平台迁移时书籍路径变了，需要手动迁移每本书的 .sdr/ 到新位置。这步比较繁琐，但如果只是想看笔记而不是继续编辑，用笔记导出功能（Markdown）更简单。
笔记导出作为安全网
除了整体备份，还可以定期单独导出笔记：
- KOReader → 主菜单 → 导出笔记
- 选择 Markdown 格式
- 导出到电脑或云端
- 即使配置目录丢了，笔记内容还在
这是"安全网"式备份——即使所有 KOReader 配置都丢了，你的读书笔记不会丢。
备份频率建议
| 场景 | 频率 |
|---|---|
| 每月读 1-2 本书 | 每月一次 |
| 每月读 5+ 本书 | 每两周一次 |
| 写了大量笔记/高亮 | 每周一次 |
| 准备升级大版本前 | 必须备份 |
| 准备换设备前 | 必须备份 |
自动备份方案
不想手动复制？
- Dropbox/WebDAV 同步：把 KOReader 配置目录（或
.sdr/子目录）放在 Dropbox/WebDAV 同步文件夹下，自动同步到云端 - rsync 定时同步：Linux/Mac 上用 cron + rsync 定时同步到备份服务器
- Kosync 进度同步：进度、书签、高亮自动同步（但不包括排版配置和词典）
常见问题
配置目录太大了？
主要是：
- 词典文件（StarDict 词典 ~5-100MB 每本）
- OCR 语言包（~30-40MB 每本）
- 缓存文件（
cache/子目录，可安全删除）
缓存能删吗？
可以。KOReader 重启后会自动重建缓存。清理缓存能释放空间，但对阅读数据无影响。
备份恢复后书库空了？
配置目录恢复了，但书籍文件没恢复——因为备份是 KOReader 配置目录，不是书籍文件。记得也备份书籍文件目录。
升级大版本前必须备份吗？
强烈建议。虽然 KOReader 升级通常保留配置，但偶尔会有配置格式变更。先备份再升级，出问题了能回退。