把NAS变成家庭书房：Koodo Reader私有书库Docker部署实录

把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书存在NAS硬盘里换台设备登录就找不到上次读到哪了。把 Koodo Reader 私有书库用 Docker 容器在隔离环境里跑服务的打包方式跑在NAS上手机、平板、电脑打开浏览器就能读同一批书进度和书签都存在服务端。整个过程不用写代码按下面五步走十几分钟就能点通。部署完长什么样Koodo Reader私有书库预览走完这五步浏览器打开NAS的IP就是一个网页版书库EPUB、PDF、MOBI、TXT 这些格式拖进去直接能读阅读进度、书签、笔记都存在容器挂载的目录里换设备登录还是原来的样子。下图是阅读器内置的三套默认阅读背景之一打开任意一本书就是这种观感。五步跑通Docker容器部署拉取项目部署文件仓库里带了现成的 compose描述容器怎么跑的配置文件不用自己写拉下来就能用。git clone https://gitcode.com/GitHub_Trending/koo/koodo-reader cd koodo-reader成功的标准目录里能看到 docker-compose-secret.yml 和 Dockerfile。准备书库挂载目录compose 里把容器内的 /app/uploads 挂到宿主的 /opt/uploads这个目录存你上传的所有书需要先在NAS上建出来。mkdir -p /opt/uploads成功标准ls -ld /opt/uploads 能看到目录。如果NAS习惯用别的存储路径把 compose 里 volumes 那一行的宿主路径改成你的实际路径即可。写入登录密码文件这份 compose 用 secret 文件而不是环境变量存密码避免明文写在配置里被人看到。echo MyKoodoReader2026 my_secret.txt成功标准my_secret.txt 和 compose 文件在同一目录内容只有这一行。密码自己改成好记又复杂的。启动Koodo Reader容器docker compose -f docker-compose-secret.yml up -d成功标准docker ps 里出现 koodo-reader状态是 Up端口 80 和 8080 都已映射。第一次运行会先拉镜像按网络情况多等几分钟。验证网页访问与登录浏览器访问 http://NAS的IP/默认 80 端口不用写用户名是 admin密码就是刚才 my_secret.txt 里那串。成功标准能进书库界面再往 /opt/uploads 里丢一本 EPUB刷新页面就能看到它。这四个坑最容易踩打开NAS IP看到的不是阅读器现象浏览器打开的是NAS系统管理页或者容器起不来报端口冲突。原因80 端口被NAS的Web服务或反向代理占了。修法把 compose 的 ports 改成 8081:80 这类空闲端口重新执行 up -d之后用新端口访问。书放进去了书库里却看不到现象登录正常但放书之后列表一直是空的。原因compose 里 volumes 写的宿主路径和你实际放书的路径对不上或者容器先启动、目录是容器自己新建的空目录。修法核对 volumes 左边的宿主路径把书放进对应的真实目录再刷新网页。启动时报找不到my_secret文件现象docker compose up 直接报错提示 secret 文件不存在。原因my_secret.txt 没建或者建在了别的目录。修法回到 compose 文件所在目录重新执行 echo 密码 my_secret.txt再启动。8080文件服务连不上现象网页能打开但访问 8080 端口没有任何响应。原因compose 默认 ENABLE_HTTP_SERVERfalse8080 的文件上传下载服务没开。修法environment 里加一行 - ENABLE_HTTP_SERVERtrue重建容器。跑通之后还能折腾什么云盘同步与备份接上 OneDrive、Google Drive、WebDAV、SMB 这些服务后书库数据能跨设备同步也可以直接从云盘批量导入书不用先把文件拷到NAS。OPDS目录与KOReader仓库自带的 Go 服务可以把书库发布成 OPDS 目录给其他阅读设备浏览也能和 KOReader 同步阅读进度环境变量在 compose 里打开即可。内置OCRPaddle 和 Tesseract 两个识别引擎都带了扫描版的书可以直接做文字识别。更多环境变量和端口组合在仓库配置里都能翻到README 有一份完整的功能清单照着加配置就行。部署配置示例docker-compose-secret.yml镜像构建说明Dockerfile项目功能与格式清单README.md【免费下载链接】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），仅供参考