手把手配好 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 跨设备同步就是来解决这件事的它内置两条通道一条把你的阅读数据推到 Dropbox、WebDAV、FTP 这类云盘上另一条走 KOReader 自家的同步服务器专门搬运阅读进度。配好之后换设备不用再重新认识你读过的书。先弄清KOReader 里其实有两套同步机制结论先行——别把两件事混在一起配通道干什么的数据放哪代码在哪Cloud storage云存储插件文件级同步统计记录、生词本等数据文件也能当网盘用你自己的 Dropbox / WebDAV / FTPplugins/cloudstorage.koplugin/KOSync进度同步插件按书名 页码对齐阅读进度可双向KOReader 官方同步服务器plugins/kosync.koplugin/想同步进度 → 用 KOSync想同步生词本、阅读统计或者干脆把云盘当书库 → 用 Cloud storage。很多同步不生效的困惑其实是配错了通道。三步把 Dropbox 接进来最常见路线第 1 步先拿到两样凭证。去 Dropbox 的开发者后台建应用拿一个 Refresh Token再记下App key:App secret这对密钥。注意别只存 Access Token——它 4 小时就过期KOReader 是靠 Refresh Token 每次现场换新的这段逻辑在 providers/dropbox.lua 里走的是 OAuth2 的 token 接口。第 2 步在 KOReader 里添加服务器。主菜单进入云存储点左上角加号选 Dropbox弹窗里依次填显示名称、Refresh Token、App key:App secret、根目录默认/想只同步一个子目录就填子目录路径。输入界面由 MultiInputDialog 组件提供填错一项都会让你后面列表拉不出来。第 3 步进去验证。加完直接点进这个服务器能看到文件夹列表就说明通了顺手长按服务器条目可以把它设为默认列表里会带 ★以后打开云存储直接进它省一层点击。 小技巧云存储列表页长按左上角可以进入多选模式批量下载/删除文件时很省事。WebDAV 和 FTP 怎么选如果你有自己的 NAS 或服务器WebDAV 是更省心的选择填服务器地址、用户名、密码三项即可内部用 PROPFIND 协议列目录实现见 providers/webdav.lua私有部署、数据不出自己手里。FTP 协议本身不带加密只在可信的局域网里用。同步到底怎么合的三个文件各管一段这是最容易被误解的地方。KOReader 不是简单地谁新用谁它给每个要同步的数据文件准备三份本地文件——设备当前正在用的.temp文件——刚从云端拉下来的.sync文件——上一轮同步时上传的存档代表本地和云端上次一致的状态。为什么要第三份因为只对比本地和云端判断不出这条数据是某台设备上删掉的还是另一台设备上加的。拿.sync做基准一比对本地比存档少了的是本地删了云端比存档少了的是别的设备删了——先各自剔除删除项再做去重合并最后把结果传回云端、刷新.sync。这套三方对比的完整逻辑写在 main.lua 的Cloud:sync函数里注释把每一步都讲得很清楚值得直接翻源码读一遍。KOSync只同步阅读进度时的精调项KOSync 需要先在 KOReader 同步服务器注册账号主菜单里注册/登录入口登录完默认就手动同步不自动推。想让体验更像无感动这几个设置auto_sync打开后才会定时把进度推到服务器pages_before_update翻多少页触发一次上传数字小更勤但更费流量sync_forward / sync_backward进度往前补和往回退分别可以设为 询问 / 自动 / 禁用默认是往前询问、往回禁用防止把进度倒退成意外覆盖checksum_method校验和按内容BINARY或按文件名FILENAME算决定两台设备怎么认定是同一本书的同一处。所有默认值集中在 kosync main.lua 的default_settings里想确认某个行为到底默认什么样查这里最准。同步失败先按这个顺序查⚠️ 九成问题不出在合并逻辑上出在前三步网断了KOSync 的自动推送和云存储列表拉取都依赖网络先确认 Wi-Fi 在线再谈其他凭证过期或写错Dropbox 的 Refresh Token 长期不用可能被吊销重新去开发者后台签发一份换掉412 状态码云端文件被别处改过导致版本对不上Dropbox 用 If-Match/ETag 机制重拉一次目录通常就恢复还不行就看日志在koreader/目录下的 crash.log 里搜DropBoxApi或KOSync警告信息会直接把 HTTP 状态码打出来。收尾数据在你手里才是真的同步KOReader 把云盘接进来之后云端目录对你就是透明可管理的——进云存储列表能看到、能删、能批量操作不想留的历史数据自己清掉即可不存在被黑盒同步的东西。理解本地 / .temp / .sync三份文件的分工再配上 KOSync 的翻页触发参数跨设备阅读体验基本就调到位了。想再往下钻doc/DataStore.md 讲了 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考