Koodo Reader NAS 部署完整指南用 Docker 三步搭好私有书库【免费下载链接】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 等格式。本文教你在 NAS 上用 Docker 完成部署让私有书库在浏览器里随时打开。为什么把书库放进 NAS电子书文件散落在手机、电脑、平板里进度和备份都很麻烦。放到 NAS 上书集中存放任何设备用同一个地址访问。Koodo Reader 的容器把 Web 界面和一个 Go 写的 HTTP 服务打包在一起后者还能把书库以 OPDS 目录的形式暴露给其他阅读设备。部署完成后浏览器打开http://NAS的IP用你设置的账号登录看到的就是和电脑上完全一致的书库。部署完能做什么在浏览器里打开和管理 EPUB、PDF、MOBI、AZW3、TXT、FB2、漫画 CBZ 等格式笔记与高亮可导出为 Markdown、CSV 等格式书库快照与版本管理误删可找回先选部署方式仓库里给了两份 Compose 配置对应两种用法docker-compose.yml从源码构建适合想改代码的场景docker-compose-secret.yml直接拉取官方镜像密码通过 Docker Secret 注入不暴露在环境变量里镜像还是构建不打算改代码就用镜像方式拉取稳定、启动快。想改代码时再考虑构建仓库的 Dockerfile 依赖 CI 预先编译好的产物本地从零构建要先跑完整构建流程。构建前需要先拉取代码git clone https://gitcode.com/GitHub_Trending/koo/koodo-reader三步启动服务配置挂载与端口把 Compose 文件放到 NAS 的部署目录然后改两处。把挂载路径/opt/uploads改成 NAS 上真实存在的书库目录。这个目录存放上传的书籍和数据必须落到持久化路径上否则容器一重建书库就空了。改环境里的SERVER_USERNAME和SERVER_PASSWORD为自己的账号密码。不设置会使用默认密码日志里会一直有警告。把ENABLE_HTTP_SERVER从false改成true默认值下 HTTP 服务不会启动。端口映射是80:80和8080:8080分别对应 Web 界面和 API 服务。80 端口被占的话把宿主机一侧改成8081:80这类写法即可。启动并验证docker compose up -d浏览器打开http://NAS的IP:8080登录后能进书库页面就算成功。把书籍文件放进挂载目录刷新页面即可看到。常见报错与处理访问 502 或拒绝连接基本就两个原因一是ENABLE_HTTP_SERVER还是false服务没起二是端口冲突。用docker compose logs -f看日志确认容器里的服务是否监听冲突就换宿主机端口。重建容器后书不见了uploads 目录没挂到持久化路径或者 NAS 挂载用户对目录没有读写权限。检查 Compose 里的挂载项指向的路径是否存在并确认该目录权限。进阶OPDS 与多端同步输出 OPDS 目录想让第三方阅读 App 直接读你的书库把ENABLE_OPDStrue加进环境变量再重启容器。OPDS 接口实现在 httpserver/ 模块里开启后 OPDS 客户端填入服务器地址就能浏览目录并下载书籍。与 KOReader 同步进度常用墨水屏设备的话再加ENABLE_KOREADER_SERVERtrue容器会额外暴露 KOReader 同步端口两端可以同步阅读进度。对外提供服务的用户建议同时设置ALLOWED_ORIGINS环境变量限制可信来源。完整的可配环境变量默认值都写在 Dockerfile 里部署入口看仓库根目录的 docker-compose.yml。把 Web 端口在路由器上做一下映射出门用手机浏览器也能打开这个书库。【免费下载链接】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），仅供参考
