3步搞定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/koreaderKOReader 是一款能在 Kindle、Kobo、Android 上跑的电子阅读应用。你在 A 设备读到第 50 页、随手画了几处高亮换到 B 设备打开时却从第 1 页开始——用云同步把进度、书签和批注搬上云端两台设备从此保持一致。下面带你 3 步配好 Dropbox 同步。动手前4步走通KOReader云同步四步就能理解它怎么工作不用先啃源码本机把阅读进度、书签、高亮存成元数据文件文件上传到云端指定文件夹别的设备登录同一云账号把文件拉下来合并进度按时间戳取最新批注追加合并不互相覆盖。先选对云服务Dropbox、WebDAV、FTP 谁适合你KOReader 的云端存储是插件式架构内置三种搬运工服务上手难度适合谁注意事项Dropbox低个人多设备同步要在开发者控制台取凭证令牌有有效期WebDAV中自建私有云用户需要一台稳定在线的服务器FTP中局域网、技术玩家协议不加密只建议可信内网使用WebDAV 可以理解为走 HTTP 的文件网盘协议Nextcloud 之类的私有云都支持它FTP 则是老牌文件传输协议简单但明文。 一句话选型自己不想管服务器就 Dropbox已有私有云选 WebDAV纯局域网折腾选 FTP。手把手配置Dropbox云同步配置全程在设备上进行大概 10 分钟。1. 去哪拿凭证Token 到底填什么Dropbox 的 access token 只有 4 小时有效期所以给它长期通行证refresh token。打开 Dropbox 开发者控制台创建应用勾选文件读写范围记下APP_KEY:APP_SECRET这一对字符串生成并保存refresh token。对应源码plugins/cloudstorage.koplugin/providers/dropbox.lua2. 把服务器加进KOReader进文件管理器点左上角选Dropbox弹出多行输入框依次填显示名、refresh token、APP_KEY:APP_SECRET、起始目录如/books确认列表里出现带★的服务器即成功。对应源码plugins/cloudstorage.koplugin/cloudstorage.lua3. 定一个两边都认的同步目录在云盘里建个专属文件夹比如koreader_sync在文件管理器长按服务器名选「Sync settings」分别指定远程来源文件夹和本地目标文件夹。目录名各设备保持一致同步才不会出现你在找 A 目录、我在找 B 目录的错位。同步是怎么跑的你看到的 vs 系统做的平时你几乎感觉不到它在动。对照着看你看到的操作关书、锁屏、翻页一切照常想立刻同步时长按服务器选「Sync now」。系统实际做的自动关闭文档、挂起/恢复、Wi-Fi 重连时各推送或拉取一次进度定时可按每翻 N 页的节奏攒一批再上传降低网络频率离线时进度先写进本地队列联网后自动补传不丢数据上传前先带版本号校验If-Match云端文件被别人动过就重试防止互相覆盖。两边都改了同一本书谁赢进度看时间戳新写的赢批注和书签走追加合并各留一份。更有意思的是三方比较系统同时对比本地文件、刚下载的云端文件和上一次上传留底的缓存文件。假如你在 A 设备删了一条批注、B 设备又加了一条直接合并会把删掉的那条复活拿缓存文件一比对就能确认这条确实是新删的先从两边剔除再合并。进阶玩法少传点、慢点传三个常用调优点只推你需要的同步服务由插件按需调用比如统计、生词本不想同步的数据本来就不参与限制传输量手动上传单文件体积上限约 150MB大文件先想好要不要搬降低频率把每 N 页推送一次的 N 调大省电又省流量改默认值常用参数可以直接在 defaults.lua 里改示例如下G_reader_settings:saveSetting(kosync_pages_before_update, 10) G_reader_settings:saveSetting(kosync_auto_sync, true)出错怎么办按现象 → 排查 → 解决来同步失败提示多半是断网。先确认 Wi-Fi再长按服务器选「Sync now」重试。Dropbox 认证报错refresh token 被撤销或过期的典型症状。回控制台重新生成替换后重试。一直显示无文件可下载检查「Sync settings」里的远程目录是否和实际存放目录一致注意首尾斜杠。本地没空间清理缓存目录或换一台磁盘余量充足的设备。 日志线索打开 KOReader 数据目录下的crash.log搜DropBoxApi、Cloud等关键词认证失败、目录拉取失败的具体状态码都在里面。安全提醒refresh token 等同网盘钥匙别截图外发、别写进公开仓库凭证存在设备本地配置里是明文设备丢了先改 token传输走 HTTPS但 FTP 方案自身不加密公网慎用重要批注定期导出一份Markdown 或文本云端也会出意外。写在最后配置只是开头之后 KOReader 会在你翻页、关书、联网时默默把进度和批注对齐跨设备续读不再需要手动搬文件。想继续深挖看这几处同步核心与三方合并plugins/cloudstorage.koplugin/main.lua阅读进度云同步服务plugins/kosync.koplugin/存储与目录约定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），仅供参考