Koodo Reader：三步搞定跨设备电子书同步
【免费下载链接】koodo-readerA modern ebook manager and reader with sync and backup capacities for Windows, macOS, Linux, Android, iOS and Web项目地址: https://gitcode.com/GitHub_Trending/koo/koodo-reader
办公室读到最后一页，晚上地铁里掏出手机接着翻，Koodo Reader 把阅读进度、书签和笔记在桌面端与 Web 端之间同步好，还能为整个书库做备份，电子书库不必再拆成两份。
Koodo Reader 是什么
Koodo Reader 是一款跨平台的电子书管理器兼阅读器，跑在 Windows、macOS、Linux、Android、iOS 和 Web 上，支持 EPUB、MOBI、AZW3、PDF 等常见格式。它解决的核心问题是：书导入之后，书库存在哪、换台设备怎么继续读到同一页。
跨设备同步到底是怎么做到的
同步的入口是一个很小的文件 src/utils/storage/syncService.ts：它为每种云服务（WebDAV、S3 兼容对象存储、网盘等）维护一个连接实例，token 过期或切换数据源时才重建。你在 A 设备上授权过一次，之后换设备或换源都不必反复登录。
备份走的是另一条链路：src/utils/file/backup.ts 会把整个书库打包成一个快照，可以落在本地磁盘，也可以直接上传到任意已绑定的云源。换新设备时走 restore（恢复）入口，一键还原整个书库，而不是逐本重新下载。
本地跑通 Koodo Reader 的四步
- 装好 Node.js 20 以上版本和 yarn。
- 拉取源码：
git clone https://gitcode.com/GitHub_Trending/koo/koodo-reader - 进入仓库目录执行
yarn，依赖安装时会自动重建 better-sqlite3 原生模块。 - 桌面端执行
yarn dev，Web 版执行yarn start，浏览器打开本地 3000 端口即可。 - 在管理页导入电子书文件，点进去开读。
WebDAV 同步怎么配，哪几个开关要打开
如果你在 Web 版上绑定自建 WebDAV（一种基于 HTTP 的远程文件协议），记得先在服务端开启 CORS（跨域资源共享，允许网页跨域名请求），否则浏览器会直接拦截请求，只有 Alist 提供的服务除外。
如果你总忘手动同步，可以考虑设置scheduledSyncInterval定时同步间隔，让书库按固定周期自动上传。
如果你的书存放在 WebDAV、网盘这类云源上，建议打开autoOffline（自动下载云端书籍）开关，提前把在读书目缓存到本地，网络不好的时候照样能翻。
想换个阅读氛围的话，阅读背景也可以从内置图里挑，效果大致是这样：
换设备之前，先问自己两件事
下个月准备换新手机，默认同步源绑到 WebDAV 了吗？最近一次完整备份是什么时候？这两件事在阅读之前做完，之后换设备就只剩"打开应用、等它刷新"这一步。
【免费下载链接】koodo-readerA modern ebook manager and reader with sync and backup capacities for Windows, macOS, Linux, Android, iOS and Web项目地址: https://gitcode.com/GitHub_Trending/koo/koodo-reader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
