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晚上在手机上把一本书翻到第 83 页第二天想换 Kindle 接着读结果它还停在第 30 页这就是 KOReader 跨设备阅读进度同步要解决的问题把读到哪了这件事存到云端任何一台登录了同一账号的设备打开这本书时都能对上位置。配完之后你能得到打开书自动跳到云端最新位置关书、休眠时自动把当前位置推上去两台设备同时读过一本书时弹窗告诉你哪边更新由你决定跳不跳。动手之前确认这几件事两台设备都装了 KOReaderKindle、Kobo、手机等任意设备组合都行设备能连上网络想一个能记住的用户名和密码如果打算开自动同步把网络设置里Wi-Fi 关闭时的动作改成打开开自动同步时 KOReader 会直接提醒你先花 10 秒理解一下原理后面调参数就不迷糊了。KOReader 用一个叫 KOSync 的插件干这个活核心逻辑在 plugins/kosync.koplugin/。每本书在服务器上的进度是以文档标识为键存的默认取文件内容的 MD5 校验和意思是两台设备上的文件必须一模一样才算同一本书。进度本身包含百分比、xpointer 位置、设备名和时间戳。动作只有两个开书时拉pull云端进度关书或休眠时推push本地进度哪边新就用服务器返回的时间戳和本机最近翻页时间比。推失败断网不丢数据会存进本地队列网络恢复后自动补推。注册并登录同步账号打开主菜单左上角汉堡按钮找到Progress sync进度同步点里面的Register / Login。弹出输入框后填用户名和密码第一次点Register以后都点Login。看到Logged in to KOReader server.的提示就成了。放心密码只在本地算成 MD5 哈希再发出去明文凭据不上传存在本地的kosync.lua配置文件里。菜单里还有个Custom sync server项默认指向官方同步服务器普通用户不用动自己搭了 KOSync 服务才需要改它。设置同步方向和策略账号配好之后进Sync behavior子菜单这里有两组开关别被术语绕晕Sync to a newer state云端有更新的位置时怎么办。默认Prompt弹窗问你显示来源设备名和百分比也可以Silently直接跳过去或Never不管。Sync to an older state你本地读得比云端更远时怎么办。默认Never——不往回跳防止你在某台设备上读完了换设备打开却被拽回前文。大多数人的最佳组合就是新的问我旧的不理保持默认即可。开启自动同步回到 Progress sync 菜单勾选Automatically keep documents in sync。KOReader 会先做一次拉取确认云端位置不会被你马上关书时推上来的旧进度盖掉——这个细节挺贴心。开好之后行为是这样的开书自动拉取最新位置关书、设备休眠时自动推送当前位置翻满设定页数也会推一次。断网时推送进队列网络恢复自动补推不用你操心。旁边那项Periodically sync every # pages就是设页数阈值的拖个数字出来点 Set。手动推/拉一次验证回到菜单点Push progress from this device now推一次然后在另一台设备上打开同一本书点Pull progress from other devices now。看到Progress has been synchronized.提示整条链路就通了。关键参数速查参数默认作用自动同步auto sync关开书拉取、关书推送每 N 页同步一次0关翻阅超过 N 页才触发一次推送省流量同步到新位置弹窗发现更远的进度时问 / 静默跳 / 不处理同步到旧位置关闭本地读得更多时不往回跳文档匹配方式按内容校验二进制校验文件须完全一致或按文件名匹配设备主机名机型名同步弹窗里显示来自哪台设备进阶调优两台设备的书文件名不一致比如一台叫book.epub另一台叫book_v2.epub把Document matching method改成按文件名匹配它会用文件名的 MD5 做标识内容不完全相同也能对上反过来同内容不同名的文件在二进制模式下会同步不到。自架同步服务器有 NAS 或服务器可以自建 KOSync把Custom sync server填上你的地址进度数据就完全留在自己手里。给设备起名字Device hostname里给每台设备设个名字比如手机Kindle弹窗提示来自 XXX 的 83% 位置时一眼就能分辨。你可能会遇到的情况自动同步勾不上去提示要求把网络设置里的Wi-Fi 关闭时的动作改成打开。因为自动同步要随时能连网每次问我在这种场景下没法用。提示Latest progress is coming from this device说明云端最新进度本来就是这台设备推上去的不用任何操作关掉就行。离线推送失败别慌进度进了本地队列联网后自动补推。只有账号失效认证失败才会直接报错重新登录即可。现在你可以放心把书丢给任意一台设备手机读到一半Kindle 上打开就是同一个位置。想看实现细节的话plugins/kosync.koplugin/main.lua 里的updateProgress和getProgress两个函数就是推和拉的全部逻辑数据存在哪、怎么比对对照着看一遍就明白了。【免费下载链接】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），仅供参考