在 NAS 上搭建家用电子书库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-readerKoodo Reader 是一款开源的跨平台电子书管理与阅读工具支持 EPUB、PDF、MOBI、AZW3、TXT、CBZ 等格式。将它部署到 NAS 之后就成为一个家用 NAS 电子书管理服务书库集中存放各设备接入同一份数据进度和笔记跟着人走。本文讲三件事在群晖上装好它、把其他设备接进同一个书库、日常维护要做的少数几项。先说清它解决的问题典型的情况是书散落在电脑、手机、U 盘里每换一台设备就要重新拷一遍文件上次读到第几章只能凭印象换设备后书签和高亮也带不过去想查某本书在哪没有统一入口。Koodo Reader 把书库收敛到一个地方书上传一次浏览器、桌面客户端、移动端都能读阅读进度、书签、高亮、笔记存在同一份数据里换设备从断点继续。在群晖 NAS 上装好 Koodo Reader前提是在 NAS 上装好 Container Manager即 Docker并在共享文件夹里建一个存放书籍的目录下文用/opt/uploads指代它。把源码拉到 NAS 的任意目录git clone https://gitcode.com/GitHub_Trending/koo/koodo-reader然后在源码目录下执行docker compose up -d --build仓库自带的docker-compose.yml里需要关注三处端口映射了容器的 80网页端和 8080上传用的 HTTP 服务到宿主机。80 被其他服务占用时把宿主机一侧改成空闲端口例如8081:80。挂载/opt/uploads:/app/uploads把书籍目录挂进容器。书都存在宿主机的这个目录里容器删了书也不丢。账号SERVER_USERNAME/SERVER_PASSWORD是登录凭据。密码默认值是securePass123部署前务必改掉仓库里另提供docker-compose-secret.yml用 secret 文件管理密码安全性更高。完成后在浏览器打开NAS 的 IP用刚设置的账号登录网页版即可以使用。镜像由 Caddy 提供静态页面Go 写的 httpserver/ 负责上传与 OPDS 相关接口。其他设备怎么连上同一个书库三条常用路径按设备情况选浏览器任意设备访问 NAS 的 IP 即可最简单适合临时使用。客户端经云存储同步Windows、macOS、Linux、Android、iOS 客户端都支持把书库数据放在云盘上包括 OneDrive、Google Drive、Dropbox、iCloud、阿里云盘、百度网盘、FTP/SFTP、SMB、WebDAV 等。在客户端里配置好对应网盘后库里的书、进度、笔记经网盘同步手机和电脑看到的就是同一份数据。其他阅读器走 OPDSKoodo Reader 支持以 OPDS 协议对外提供书库OPDS 是电子书目录的标准协议实现见 httpserver/opds.go由环境变量ENABLE_OPDS控制开关第三方阅读应用可以按 OPDS 源浏览你的书。如果你有 Kindle 设备仓库的 Dockerfile 还声明了 KOReader 同步服务端7200 端口ENABLE_KOREADER_SERVER控制可在 compose 里自行映射端口实现与 KOReader 的阅读进度互通。长期运行要做的事改掉默认凭据SERVER_PASSWORD与SERVER_USERNAME都有默认值生产环境必须覆盖或用 secret 文件方式存放。定期备份书籍目录备份 NAS 上/opt/uploads对应目录即可保住全部书籍客户端侧的库数据如果走网盘会随网盘自动冗余。升级在源码目录执行git pull再跑一次docker compose up -d --build。如果改用现成镜像docker-compose-secret.yml中的ghcr.io镜像写法改 tag 后重新up -d即可。磁盘容量书籍是纯文件存储库大了之后注意该目录所在共享文件夹的剩余空间。延伸阅读项目中文说明与功能清单README_cn.md容器构建方式端口、环境变量、启动脚本DockerfileHTTP 上传与 OPDS 服务实现httpserver/【免费下载链接】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），仅供参考
