企业官网建设流程全解析

Synology NAS × Koodo Reader Docker 部署：3 步跑通你的私有电子书架

【免费下载链接】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 里，没索引、不同步，想找本读了一半的书得全盘翻一遍。把书架搬上 NAS、任何设备开浏览器就能读，是最省事的解法。Koodo Reader 是一个带同步和备份能力的现代电子书管理器兼阅读器，把它以 Docker 容器跑在 Synology NAS 上，是我见过最稳妥的私有书架方案。

前置条件不多，先自查一遍：

• NAS 已装 Docker 套件，会建容器、看日志
• 内存 2GB 以上，书库预留 50GB 左右空间
• 知道 NAS 的局域网 IP，防火墙能改

🐳 拉镜像建容器：搜、选、开端口

做什么：在 Docker 套件的注册表里搜koodo-reader，挑官方镜像的latest标签版本。

怎么配：创建容器时，内部端口保持默认，宿主端口填3000或8080这类常用端口——具体以镜像实际暴露的端口为准（可看仓库里的 Dockerfile），然后在防火墙放行这个端口。

为什么：latest标签能直接吃功能更新和安全补丁；宿主端口选常用的，好记、不易和其他服务打架。防火墙这一步别省，容器状态显示正常、浏览器却死活连不上，九成是这里漏了。

网络模式选 bridge 就够，隔离性和外网访问都兼顾。再进容器高级设置，把 UID/GID 配成和 NAS 系统用户一致——容器往挂载目录写的文件才归对人，以后用群晖其他功能管理这些文件不会遇到权限报错。

📁 两个挂载目录：漏一个就丢数据

做什么：把 NAS 上两个目录挂进容器，/books放电子书，/config存应用配置。

怎么配：创建容器时指好路径，确认两个目录都有读写权限。

为什么：容器随便删了重建，书和你的设置都还在 NAS 上，数据不落地进容器才是持久化。漏挂/config是这套 Koodo Reader Docker 部署里最容易翻车的地方——容器一重建，阅读进度和全部设置清零，书本身没事，但白配一场。

🔍 首次启动：访问地址、设密码与翻车自查

部署完，浏览器打开http://NAS-IP:端口号进入 Koodo Reader 界面，首次登录把默认账号密码改掉。系统会自动扫描/books目录建索引，书架慢慢就长出来了。

没起来就按顺序查三样，基本能覆盖所有事故：

1. 容器日志：错误信息一般写得明明白白
2. 端口冲突：这个宿主端口是不是被别的服务占了
3. 目录权限：容器对/books和/config能不能读写

跑起来之后嫌慢，多数不是软件问题：把容器内存限制调大一点；NAS 有 SSD 缓存的话，把这两个目录放 SSD 上；缓存和临时文件定期清一清。

跑起来之后值得做的两件事

• 给/config加个定时备份：它是唯一存着你设置和进度的地方，群晖任务计划里挂个定期复制就行，出事了能整包还原
• 顺手定制一下阅读背景：阅读器内置了几张壁纸，上图就是其中一张，小事，但翻书的时候舒服很多

后续动作两个：先把一本 EPUB 丢进/books，看书架是不是自动长出新书；再把容器加进开机自启，让书架跟 NAS 一起常驻。参数细节懒得翻的话，看仓库里的 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