10分钟在NAS上部署私有电子书库Koodo Reader 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-reader你收藏的 EPUB、下载的 PDF、手机里没读完的小说散落在三台设备上。Koodo Reader 是一款支持同步与备份的跨平台电子书阅读器用 Docker 把它部署到 NAS 上就是一个常驻家里的私有阅读器——浏览器打开就能读。这篇指南带你从拉镜像、挂目录到开启 OPDS 分享把整个流程跑通并解释每个配置为什么这么写。拆开镜像看看容器里到底跑着什么先搞清楚容器里有什么出问题时你才不慌。官方镜像很精简里面其实跑了三个东西Caddy 网页服务镜像内 80 端口承载网页版书架也就是你用浏览器看到的那个界面Go 写的 HTTP 服务镜像内 8080 端口负责图书上传、下载接口和可选功能httpserver/ 目录下就是它的源码KOReader 同步服务镜像内 7200 端口默认关闭后文再讲怎么开。真正重要的目录只有一个/app/uploads。你在网页里上传的每一本书都存在这里把 NAS 上的真实目录挂给它是数据持久化的关键——容器删了重建书还在。拉取镜像把挂载写对在群晖 Docker 套件的「注册表」里搜索 koodo-reader选官方镜像的最新标签。创建容器时核心配置就两条端口映射和目录挂载。docker run -d --name koodo-reader -p 3000:80 -p 8080:8080 -v /volume1/docker/koodo:/app/uploads -e SERVER_PASSWORD改成你的强密码 koodo-reader:latest几个容易踩的点3000 是宿主端口映射到容器内的 80也就是网页书架的入口8080 必须同时映射。网页跑在 80但上传、下载图书的接口在 8080漏掉它你会遇到能打开页面却传不进书的怪事SERVER_PASSWORD换成你自己的强密码。项目自带的 docker-compose.yml 思路一样环境变量传账号密码卷传数据。打开 3000 端口验证能不能读浏览器访问http://NAS-IP:3000应该能看到登录页默认用户名是admin。验证走两步别跳过第二步登录成功书架页面正常渲染上传一本任意 EPUB刷新书架封面和书名都出现。第二步才是真验证——很多部署看起来成功其实是第 8080 端口没通书架一直空着。完全打不开时的排查顺序先看 3000 是否被别的容器占了换个空闲端口重新映射再看 NAS 防火墙有没有放行。开启 OPDS把书架推出去能看书只算跑通了一半Koodo Reader 的进阶玩法都藏在环境变量里默认全关。OPDS 目录加上-e ENABLE_HTTP_SERVERtrue -e ENABLE_OPDStrue重启容器后/opds路径就会输出标准 OPDS 目录流Calibre-Web、KOReader 这类客户端可以直接订阅你的书架实现NAS 存书到处借阅。逻辑在 httpserver/opds.go 里带搜索接口。KOReader 进度同步加上-e ENABLE_KOREADER_SERVERtrue同时把宿主的 7200 也映射出去。刷了 KOReader 的 Kindle 就能和网页端同步阅读进度。公网开放前收紧这两处只在家庭内网用的话默认配置够用打算放行公网或局域网共享先做两件事看日志确认密码生效。没设密码时启动日志会打印Using default password的警告说明书架用的是公开已知的默认密码 ⚠️必须立即改掉填上ALLOWED_ORIGINS。这个变量留空时任何网站的脚本都能跨域调用你的书架接口。只写你信任的域名用英文逗号分隔。再加一层反代就更稳前面挂 Nginx 或 Caddy配好 HTTPS以后用域名访问密码和书籍流走加密通道。处理三类最常见故障页面能开但传不了书90% 是 8080 没映射。80 只负责页面上传接口在 8080删了重建容器书没了/app/uploads没挂卷书写进了容器内部盘容器一删就清零KOReader 连不上7200 端口没开。该服务默认关闭要同时加环境变量和端口映射。三处都确认后把手机里那批 EPUB 拷进 NAS 的/app/uploads对应目录刷新一下书架——从今晚开始全家都从这台 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考