Koodo Reader 装进 NAS一条命令跑通全家共享的电子书库【免费下载链接】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周末把手机、平板、电脑上的书翻个遍却发现每部设备各存各的进度封面、书签、批注还散落在不同的 App 里——有没有一个地方能让全家打开同一个书库、接着上次那一页继续读Koodo Reader 是一款跨平台电子书管理与阅读器支持 EPUB、PDF、MOBI、AZW3 等格式自带云盘同步、笔记批注和阅读统计。把它用 Docker 丢进 Synology 之类的 NAS等于在家门口架起一座私人书房浏览器一开就能读不用装任何客户端数据归你管。下面把从拉取镜像到首次登录的每一步走一遍照着做就能通。先搞清楚这套东西到底把什么放在 NAS 上很多人以为 NAS 部署后书都存在服务器里Koodo Reader 的 Web 版不是这么运作的。先对齐一下认知能帮你少走弯路部分存在哪里说明网页阅读器本体NAS 容器Caddy 提供的前端浏览器访问即可书库元数据、进度、批注你浏览器 云盘默认存在浏览器配好云盘后跨设备同步上传的书 / 同步数据库NAS 的/app/uploads卷只有开了上传或 KOReader 服务时才用到一句话NAS 负责随时能打开的入口你的云盘负责书和进度的家。这样分工想清楚了后面的配置就不会绕晕。动手前三项自检别急着建容器先确认这三件事能省下大半排错时间Docker 套件已装好能在映像里看到容器和注册表两个标签留好一个共享文件夹打算专门放uploads数据别和系统盘混在一起端口没被占80 号端口 NAS 上可能已被 Web 服务用掉建议把网页端口改到 8080 或 8090踩坑提示80 端口冲突是新手最常见的打不开页面原因改端口前先在 NAS 的端口服务里核对一遍。四步把容器拉起来全程在 Docker 套件里点完即可不需要敲命令行。拉取镜像进入注册表找到 Koodo Reader 官方镜像选master或你信任的稳定标签下载。创建容器在映像里点该镜像启动容器名填koodo-reader勾选开机自启对应restart: unless-stopped重启 NAS 后服务自动回来。配端口默认三个端口按需映射——容器端口用途是否必开80网页阅读器是8080上传 / 同步 API可选7200KOReader 进度同步可选只想要能读就行映射 80 一个端口就够了其余两个先不碰。挂数据卷把上一步准备的共享文件夹容器内路径设为/app/uploads。这是唯一必须挂的目录书和数据库都落在这。环境变量在高级设置 → 环境变量里加第一份最简配置只需登录账号SERVER_USERNAME你的登录用户名SERVER_PASSWORD登录密码记得改掉默认值注意密码不填会回落到默认账号任何拿到地址的人都能进务必显式设置。部署后必做的两件事第一件事验证能打开。浏览器访问http://NAS地址:你改的端口用刚设的账号密码登录。看到书架界面说明容器和端口都通了。此时书架大概率是空的正常——书还在你浏览器里下一步搬过来。第二件事接上云盘让数据安家。登录后进设置 → 数据同步挑一个你常用的网盘OneDrive、Google Drive、WebDAV 都支持完成绑定。之后你在任何设备打开同一个网页、用同一个云盘书库、进度、批注会自动对齐。这一步做完换设备接着读才算真正落地。如果家里人在用 Kindle 生态的 KOReader 掌阅还有更省事的做法打开环境变量ENABLE_KOREADER_SERVERtrue重启容器再把7200 端口映射出去。Koodo Reader 会起一个进度同步服务KOReader 端填上 NAS 地址和账号即可两边翻页进度自动互通实现见 httpserver 同步服务。进阶把书房变得更好用基础能跑之后按需再加对外共享书库设ENABLE_OPDStrue并重启Koodo Reader 会输出标准 OPDS 目录支持 OPDS 的阅读器直接连 NAS 地址就能浏览整库。允许网页上传设ENABLE_HTTP_SERVERtrue映射 8080 端口即可通过接口把书传到/app/uploads。收紧跨域设ALLOWED_ORIGINS为受信任的来源列表避免任何人从任意域名调用你的接口。上 HTTPS用 NAS 的反向代理给这个端口套一层证书外面访问也更安全。这些开关都集中在 Dockerfile 的默认环境变量里能看到全貌改完重启容器即生效不用重新拉镜像。踩过的坑一次说清页面白屏 / 打不开十有八九是 80 端口冲突或被防火墙拦了。换个端口再确认防火墙放行了映射端口。登录后书是空的这不是故障。Web 版的库在浏览器本地先绑云盘或把旧设备的导出文件导入进来。改了环境变量没反应环境变量只在容器创建时读取改动后要重建容器删旧建新/app/uploads卷保留则数据不丢。权限报错把 NAS 共享文件夹的读写权限给到 Docker 运行用户或按提示设置一致的用户 UID/GID。把家书房跑起来拉取镜像、挂一个uploads卷、填一个登录密码Koodo Reader 的网页入口就立在 NAS 上了再绑一个云盘书和进度就有了自己的家。剩下的 OPDS、KOReader 同步、HTTPS都是锦上添花用得上再开。完整的容器编排可以直接参考仓库里的 部署清单照着填上自己的端口和目录就能一键拉起。【免费下载链接】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），仅供参考