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昨晚在 Kobo 上读到第 80 页顺手划了两处高亮。今早换 Kindle 打开同一本书进度回到第 1 页批注也没了。KOReader 的跨设备同步就是为这类场景准备的每台设备登录同一账号后批注和阅读进度会自动在多端之间保持一致。这篇教程按准备 → 配置 → 验证的顺序带你走完全程最后附一份故障排查路径。先看清楚能同步什么不能同步什么动手之前先确认 KOReader 同步的能力边界能同步阅读进度页码位置、书签、高亮、批注额外能同步阅读统计、生词本等插件数据走云存储通道不能同步书籍文件本身——书仍要拷到每台设备上或通过云存储下载不能同步字体、边距、屏幕设置等本地个性化配置一句话记住同步的是你的阅读痕迹不是你的文件。两条同步路线一张对比表选默认方案KOReader 里有两个同步通道职责不同容易混淆进度同步KOSync云存储CloudStorage管什么进度、书签、高亮、批注云文件浏览、下载 / 上传统计、生词本等数据依赖的服务端KOReader 同步服务器或自建服务器Dropbox / WebDAV / FTP需要的凭据KOReader 账号注册 / 登录对应云服务的账号或令牌能否自动支持可每翻 N 页自动同步一次手动触发默认推荐只想同一本书两端无缝接着读开启进度同步即可需要取书、传文件时再配置云存储。两者的实现分别在 plugins/kosync.koplugin/ 和 plugins/cloudstorage.koplugin/进阶读者可以直接读源码。KOReader 同步配置步骤准备、配置、验证三步走准备两台设备有同一本书、同一账号确保两台上都能看到这本书手动拷贝或用云存储分别下载每台设备依次打开主菜单 →Progress sync进度同步→ 注册 / 登录 KOReader 服务器登录同一个账号如果你自建了同步服务先在Custom sync server自定义同步服务器里填入服务端地址再登录配置开启自动同步顺带设置云存储主菜单的Progress sync下这几个选项你会用到自动同步Auto sync打开后每隔你设定的页数自动触发一次同步每翻 N 页同步一次数值越大联网越少e-ink 设备建议调大一些向前 / 向后同步策略分别决定远端进度更新和远端进度更旧时怎么处理可各自选询问 / 自动 / 禁用新手保持默认即可要用云存储的话去主菜单的Cloud storage云存储里添加服务器三选一Dropbox填写 App Key:App Secret 和访问令牌WebDAV填写服务器地址、用户名、密码FTP填写地址、用户名、密码。⚠️ FTP 无加密建议只在可信网络内使用连接成功后你会在列表里看到云端目录可以直接下载书籍也可以选定一个文件夹作为上传目录。验证确认进度和批注真的同步了很多教程到配置完成就结束了真正的验收在这里在设备 A 上翻几页、加一条高亮然后在阅读器菜单触发推送进度Push progress from this device看到Progress has been synchronized进度已同步的提示说明写入成功在设备 B 上打开同一本书触发拉取进度Pull progress from other devices页码应停在刚才的位置高亮也在做一遍删除测试在设备 B 删掉一个书签同步后再看设备 A——书签应该也消失了前三个通过就算配置成功第四步不通过直接看下一节的排查路径。原理速览阅读进度是怎么存下来、又怎么对齐的不用深入代码理解两个机制就够用了。机制一每本书都有一本小账本。KOReader 会把某本书的页码、书签、高亮、批注写进以书名命名的.sdr设置文件存放在 koreader 主目录里与书籍路径对应。所谓同步本质就是把这份小账本交给服务器、再让其他设备领回来。所以同步出问题时几乎都可以往这份文件有没有传成功这个方向查。机制二三个文件做合并避免删除被复活。多台设备改同一份数据时简单的谁新用谁会把一台设备上删掉的东西在另一台设备上找回来。因此同步流程每次会准备三份文件本地文件当前正在用的下载文件刚从云端取回的缓存文件上一轮上传后的版本即各设备上次达成一致的状态拿缓存文件跟当前状态对比就能区分新增和删除新增的合并进来删除的两边一起删掉合并结果再上传回云端并刷新缓存。这套逻辑实现在 plugins/cloudstorage.koplugin/main.lua 中。排查指南同步失败的常见症状与处理按症状 → 原因 → 解法组织对号入座即可症状可能原因解法另一台设备打开书进度没变第一台没同步或自动同步没开手动推送 / 拉取一次再确认自动同步处于开启状态自动同步悄悄不生效墨水屏设备的 WiFi 策略是每次询问系统会自动禁用自动同步避免反复弹窗把 WiFi 改为自动连接或改用手动同步同步时提示检查网络连接未联网或自定义服务器地址填错先确认能打开网页再核对服务器地址删掉的批注又出现删除后没推送只在一边拉取了删除的那台先推送另一边再拉取云存储提示认证失败令牌过期或权限不足常见于 Dropbox重新生成令牌更新 App Key:App Secret⚠️ 注意如果同步之后书还是不一样这是预期行为——同步的只有进度和批注书籍文件需要另外下载或拷贝。资源直达需要深入时看哪里配置完成后书跟着人走任何一台设备打开页码、高亮、批注都在它该在的位置。进度同步插件源码plugins/kosync.koplugin/云存储插件与 Dropbox / WebDAV / FTP 三套实现plugins/cloudstorage.koplugin/Dropbox 凭据配置逻辑plugins/cloudstorage.koplugin/providers/dropbox.lua每本书的数据存储说明doc/DataStore.md单文档设置模块frontend/docsettings.lua【免费下载链接】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），仅供参考
