KOReader 跨设备同步怎么配批注与阅读进度 5 分钟上云指南【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader墨水屏上读到第 5 章、随手记了 3 条批注切到手机想继续——进度回到第 1 页批注也没了。这篇指南用大约 5 分钟帮你在 KOReader 里配好跨设备同步以 Dropbox、WebDAV 或 FTP 作为云端中转让阅读进度和批注数据跟到哪台设备都能接着读。1. 先选型Dropbox、WebDAV、FTP 哪个适合你KOReader 的云存储功能由 plugins/cloudstorage.koplugin/ 插件提供开箱即支持三家服务。三者差别不在功能多少而在数据放哪、你愿意花多少力气服务上手成本数据可控性适合人群Dropbox最低开发者控制台拿令牌填进去就能用数据存在 Dropbox 服务器用它的空间配额个人用户、有多台设备的读者WebDAV较高需要一台 WebDAV 服务器自搭或租用数据在自己手里规则自己定重视数据自主权的人、小团队FTP中等需要一台 FTP 服务器可自持但协议本身加密弱内网里的技术用户 一句话提醒FTP 传输几乎不加密只建议放在可信的内网里用别暴露到公网。2. 快速上手5 分钟完成 KOReader Dropbox 配置下面以 Dropbox 为例走一遍共 5 步。WebDAV / FTP 的界面结构相同只是填的字段换成服务器地址、账号密码。在 Dropbox 拿三样凭证。打开 Dropbox 开发者控制台创建一个应用并开启 Dropbox API 权限然后记下APP_KEY:APP_SECRET应用身份格式类似abc123:def456和Refresh Token刷新令牌可以理解为一张不过期的授权书KOReader 用它随时换新的短期访问令牌。打开云存储菜单。在 KOReader 主菜单里找到Cloud storage云存储项。添加服务器并填 4 个字段。点添加后会出现一个对话框源码在 plugins/cloudstorage.koplugin/providers/dropbox.luaName随便起的显示名如我的 DropboxDropbox refresh token第 1 步拿到的 Refresh TokenDropbox APP_KEY:APP_SECRET应用密钥对Start folder起始目录例如/books填/则是根目录指定同步目录。回到服务器列表用Sync folder功能设置两个目录远程源文件夹云端的哪一层和本地目标文件夹下载到设备哪个位置。两个都设好后同步菜单项才会变为可用。点同步。界面会逐个显示Downloading file (n/N)结束后出现Successfully synchronized.的提示。3. 验证同步生效一个双设备小实验 配完别急着收工花 3 分钟做个实验确认链路真的通了。设备 A把一个小文件比如一段笔记test.md放进 Dropbox 的 Start folder/books下。设备 A执行第 2 节的同步打开本地目标文件夹确认test.md出现了。设备 B用同一账号按第 2 节配好同样的服务器与同步目录执行同步。✅成功的判定标准设备 B 的目标文件夹里出现了同一份test.md内容一致。❌失败了怎么办直接跳到 第 6 节故障排查按顺序过一遍即可。阅读进度本身还有更省事的通道内置的Progress sync插件plugins/kosync.koplugin/注册 KOReader 服务器账号后会自动把你的阅读进度推到服务器设备 B 打开同一本书进度就停在你上次的位置。4. 幕后原理同步的到底是什么这一节只回答三个问题不贴代码。同步的内容分三条线阅读进度由 Progress sync 负责把页码等进度推到 KOReader 服务器可选是否附带书籍元数据。批注与阅读数据Statistics阅读统计和 Vocabulary builder生词本这类插件的数据文件通过云存储走三文件机制同步下一小节。书籍与文件云存储的 Sync folder 做的是文件级同步——远端有、本地没有或大小不同的文件会被下载到目标文件夹。冲突怎么解三份文件一起比较同步某一数据文件时KOReader 手里其实有三份正在用的本地文件、刚从云端拉下来的临时文件.temp、以及上一轮上传时的缓存副本.sync。为什么要第三份只比较本地和云端的话你在 A 设备删掉的条目会因为 B 设备还留着而复活。用缓存副本对照才能认出哪些是最近被删的先剔除再合并删掉的内容不会死灰复燃。上传时还带版本校验若云端文件在此期间被别人改过就重新下载再合并直到一次成功。何时触发进度开启自动同步后按你设定的翻页间隔推送两次操作间隔不足 25 秒的会合并避免刷屏式请求后台还有定时推送兜底。云存储从 Cloud storage 菜单手动触发不会悄悄跑流量。5. 进阶玩法让同步更合身选择性同步Progress sync 支持分别控制向前/向后同步的策略询问、静默执行或完全关闭也可以选择不发送书籍元数据只同步进度本身。也就是说你可以只让进度跟手批注类数据留在本地。弱网环境优化 推送有 25 秒防抖连续快速翻页只会产生一次请求。不稳定的网络下建议关掉自动同步改用手动或依赖它的定时推送。同步的是小文件进度、统计数据单次流量本身不大不必担心。云端空间清理Dropbox 服务器条目里有Info按钮点一下能看到账户类型、已用空间和总空间。隔段时间把不再需要的旧文件从同步文件夹里删掉即可。6. 故障排查按顺序查这 4 步网络设备离线时请求会被挂起网络恢复后 KOReader 会自动重跑先确认能正常联网。凭证过期Dropbox 短期令牌只有 4 小时有效期每次会话用 Refresh Token 换新。如果反复报错优先复查APP_KEY:APP_SECRET和 Refresh Token 是否填对、应用是否还有效。本地空间目标文件夹所在磁盘是否还有空间尤其是一口气同步大书的时候。看日志定位打开 KOReader 的日志文件搜索DropBoxApi或sync关键词。cannot get access token指向凭证问题cannot upload/download file指向网络或权限问题报错里的 HTTP 状态码如 401、409能进一步缩小范围。7. 安全提醒4 条Refresh Token 等于长期授权泄露后去 Dropbox 控制台吊销配置完成后它保存在 KOReader 本地设置文件里设备借人前留意一下。日常访问用的 4 小时短期令牌风险窗口小但仍不建议把凭证截图发到聊天群。WebDAV / FTP 自架服务器要管好访问控制FTP 仅内网使用。重要批注和生词本定期用内置的导出功能存一份到本地或另一台设备双保险。延伸阅读配置只是开始进度和批注从此跟手之后换设备读书就像翻页一样自然。云存储插件源码plugins/cloudstorage.koplugin/进度同步插件源码plugins/kosync.koplugin/开发指南doc/Development_guide.md数据存储机制说明doc/DataStore.md【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
