十分钟拥有可检索的私有电子书库：Synology NAS 上 Docker 部署 Koodo Reader

十分钟拥有可检索的私有电子书库Synology NAS 上 Docker 部署 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-reader浏览器一打开书架就在眼前图书可搜索、可分类点开即读。Koodo Reader 是一款跨平台电子书管理器最核心的特性是多设备同步与备份。本文带你走一遍 Synology NAS 的 Docker 部署适合想搭一座私有电子书库的家庭 NAS 用户。部署前自检清单 动手前把 4 项过一遍一共 3 分钟都能在群晖控制面板或命令行里看到。自检项具体阈值查看位置内存容器启动后 NAS 剩余内存 ≥2GB控制面板 - 任务管理器Docker 版本20.10 及以上控制面板 - Docker 套件页端口80、8080 及 7200可选未被占用docker ps查看监听端口存储空间为书库预留 ≥50GB 空闲存储空间管理器十分钟跑通 Docker 部署 ⏱️获取镜像打开群晖 Docker 的「注册表」搜索koodo-reader拉取官方镜像ghcr.io/koodo-reader/koodo-reader:master这是仓库 docker-compose-secret.yml 里使用的标签。设置端口映射两个端口80:80和8080:8080。80 出的是 Web 书架页面8080 是带账号密码认证的加密文件服务。计划同步 KOReader 的话再加一条7200:7200。挂载数据目录在存储配置里把主机的/opt/uploads挂到容器的/app/uploads。之后上传的所有电子书和配置库都存在这里容器重建也不会丢书库。设置凭据并启动环境变量填SERVER_USERNAME、SERVER_PASSWORD和ENABLE_HTTP_SERVERtrue8080 文件服务才会真正生效默认关闭。高级设置勾选「开机自动启动」对应restart: unless-stopped然后启动容器。启动后马上要做的三件事 ✅首次访问地址是http://NAS-IP:80改过宿主端口的就换成你的端口。登录后在设置里添加一个本地目录填入http://NAS-IP:8080之后从网页导入的电子书会逐本存进/app/uploads。改掉默认凭据镜像出厂是admin/securePass123首启必换。给书库设一道库密码支持密码、PIN 等防止家人误入你的书架。值得动手改的配置按需开启8080 文件服务与 7200 同步服务默认都是关闭状态Dockerfile 里ENABLE_HTTP_SERVERfalse、ENABLE_KOREADER_SERVERfalse。用到的才开能省内存也缩小暴露面按需把对应变量置为true。密码存放8080 走 HTTP Basic 认证仓库提供了 Docker secrets 方案——把密码写进my_secret.txt用SERVER_PASSWORD_FILE指向它避免明文环境变量实现见 httpserver/main.go。顺手用ALLOWED_ORIGINS白名单受信来源挡住局域网里的跨域访问。备份整目录全部电子书与 KOReader 进度库koreader.db都落在/app/uploads里备份主机侧的/opt/uploads一个目录就全了。用 Hyper Backup 建一个每周定时任务推到另一块硬盘或移动盘。卡住了看这里 ️容器起不来、日志报端口冲突多半是 80 与 NAS 自带 HTTP 服务打架。把宿主端改一下比如3000:80再用http://NAS-IP:3000访问。访问 8080 报 401 Unauthorized凭据用了默认值或客户端登录信息与容器环境变量不一致。核对 Docker 里设置的SERVER_USERNAME和SERVER_PASSWORD与客户端登录是否一致。导入的书不在 NAS 上本地目录没指向http://NAS-IP:8080或文件服务根本没开数据只落在浏览器里。确认ENABLE_HTTP_SERVERtrue且目录地址正确。KOReader 同步不了进度ENABLE_KOREADER_SERVER没启用或7200端口没映射。置为true并补上端口映射即可。部署完成后的两个进阶玩法共享书架设ENABLE_OPDStrue依赖ENABLE_HTTP_SERVERtruehttp://NAS-IP:8080/opds就是一个标准目录可以直接投喂给 Calibre 或手机端的 OPDS 客户端实现见 httpserver/opds.go。墨水屏同步设ENABLE_KOREADER_SERVERtrue并映射7200:7200KOReader 墨水屏与 NAS 双向同步阅读进度。一台预留 50GB 的 NAS十分钟配置散落的电子书就变成了浏览器一开的书架。后面想扩展时打开 OPDS 让全家共享同一套书架或接上 KOReader把网页上读到一半的进度接着带到墨水屏上。【免费下载链接】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），仅供参考