三步开启跨设备同步KOReader阅读进度同步完整指南【免费下载链接】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在墨水屏平板上读到第87页通勤路上掏出手机却要先翻半天进度条找回位置KOReader 内置的进度同步KOSync就是干这个的多台设备登录同一个账号阅读位置自动接力翻页就能接着读。这篇教程带你把它跑通并看懂背后的同步机制。 功能一览它做什么把你当前读到的位置页内进度/百分比上报到同步服务器另一台设备打开同一本书时拉取最新位置并跳过去。注意它同步的是阅读进度不包含批注和高亮内容。适合谁有多台墨水屏设备、或在平板和手机之间共用一本电子书的人。为什么值得开开启后关书、息屏、恢复时会自动上报不用记页码随时也能在菜单里手动推送/拉取。配置成本填一次账号、勾一个开关两分钟搞定。三步快速上手跑通只需要三步唯一的分叉是用哪个同步服务器方案服务器搭建网络要求数据存放适合谁官方同步服务器无需搭建注册即用HTTPS 公网KOReader 官方云端绝大多数用户自建自定义服务器需自行部署并填写地址取决于你的环境自己的服务器隐私敏感/内网用户一句话建议没有特殊需求就用官方服务器想自己掌控数据才去填自定义服务器。第一步注册/登录同步服务器目标拿到服务器认可的账号身份。操作打开主菜单 →Progress sync进度同步→Register / Login输入用户名和密码新用户点注册、已有账号点登录。预期结果屏幕提示Logged in to KOReader server菜单项变为 Logout。第二步打开自动同步目标让进度自动上报无需手动操作。操作在同一个菜单勾选Automatically keep documents in sync。若提示需要把Action when Wi-Fi is offWi-Fi 关闭时的动作改为 turn on先按提示改完网络设置再回来勾选。预期结果之后关书、挂起、恢复联网时进度会自动推送到服务器你不需要做任何事。第三步验证接力目标确认进度真的跨设备动了。操作在设备 A 上翻几页然后在设备 B 上打开同一本书。预期结果设备 B 要么静默跳到最新位置要么弹出Sync to latest location 87% from device ××?点确认后位置无缝接上。⚙️ 它是如何工作的原理可以类比成大家往同一块黑板上写进度新来的人先看黑板。主过程分五步KOReader 为每本书生成一个指纹默认是文件内容的部分 MD5 校验值也可在菜单改为按文件名匹配用它来判断两台设备读的是不是同一本书。阅读中会记录翻页在关键节点关书、挂起、恢复或达到每翻 N 页同步一次的设定值把指纹、位置、百分比、设备名打包成同步请求。请求经 HTTPS 发往服务器相邻两次操作之间约有 25 秒的合并窗口避免疯狂刷接口。另一台设备打开同一本书时用相同指纹向服务器查询最新记录。对比双方时间戳谁更新听谁的再按你的同步行为设置决定静默跳转还是弹窗确认。主逻辑在 plugins/kosync.koplugin/main.luaHTTP 请求层在 plugins/kosync.koplugin/KOSyncClient.lua想看细节可以直接翻源码。 关键细节书籍匹配方式决定同一本书的判定范围默认按二进制指纹匹配文件内容完全一致才算同一本书重新导出的 epub 会得到新指纹。改成按文件名匹配后同名文件即视为同一本更宽松适合文件名稳定的用户。相关设置与默认值见 plugins/kosync.koplugin/main.lua。前进/后退同步可以分开控制菜单里的Sync behavior有两组独立开关同步到更新的位置和同步到更旧的位置各可选自动、询问、禁止。比如想我落后时自动跟上我领先时别被拉回去就把前者设为 Auto、后者设为 Never。这是最常被调整的配置实现同样在 plugins/kosync.koplugin/main.lua。断网时进度不会丢上传失败的进度会写入本地队列下次联网时按顺序补发队列 4 周过期、上限 200 条自动清理。这套先离线、后补传的设计让地铁和山里都能安心读书。队列实现在 plugins/kosync.koplugin/KOSyncQueue.lua。每条同步记录的结构非常简单{ document doc_digest, -- 书籍指纹MD5 progress progress, -- 书内精确位置 percentage percentage, -- 百分比 device Kindle Paperwhite, device_id self.device_id, }❓ 常见问题速查遇到Please register or login before using the progress synchronization feature → 尚未登录先到Progress sync菜单完成注册/登录。遇到自动同步勾不上、有提示弹窗 → 把Wi-Fi 关闭时的动作改为 turn on再回来开启自动同步。遇到网络错误提示 → 不用手动重发进度已进入队列联网后自动补传。看到Latest progress is coming from this device → 服务器最新记录就是本设备贡献的一切已是最新无需操作。两台设备进度不一致、不想互相覆盖 → 把同步到更新/更旧位置都设为 Never用Push now / Pull now手动控制方向。 安全提示用专用账号设备本地只保存密码的 MD5userkey而非明文但建议仍使用与主账号无关的专用密码。传输有加密官方服务器走 HTTPS认证信息只在加密通道内传输。自建即自担自定义同步服务器只指向你自己运维或信任的地址因为进度数据含文件名与设备信息会存在那里。本地是底线同步只在联网时生效切换设备时本地也会保留进度记录别随意清空设备数据目录。总结登录账号、勾选自动同步KOReader 的阅读位置就会自动跟着你在设备间接力背后不过书籍指纹 时间戳比较 离线队列三件事。想深入的话按下面的入口继续功能源码目录plugins/kosync.koplugin/同步服务器接口定义plugins/kosync.koplugin/api.json项目开发指南doc/Development_guide.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），仅供参考