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 是一款开源电子书管理器。这篇文章讲的是如何把它部署到 Synology NAS 上把散落在手机、平板、电脑里的电子书收敛成一个私有书库支持跨设备阅读阅读进度、书签和笔记在服务端保持同步。面向的读者是只熟悉 Docker 基础概念、打算把家庭书库集中到 NAS 上的普通用户全文按时间线展开每一节都给出可直接照做的操作。部署前准备三项环境确认与获取项目代码部署本身不复杂卡住人的通常是环境。动手前在 Synology 套件中心确认三件事Docker 套件已安装且运行正常。Synology 上的 Container Manager 或 Docker 均可能正常拉取并启动容器即可。可用内存不低于 2GB。书库越大、访问设备越多容器实际占用越高2GB 是下限而不是建议值。存储按书库规模预留。粗略算法电子书文件总量 × 1.2 的安全系数再为系统镜像预留约 1GB。代码获取只需一条命令git clone https://gitcode.com/GitHub_Trending/koo/koodo-reader进入项目目录后根目录下有可直接使用的 docker-compose.yml无需从零编写编排文件。 docker-compose 三个关键配置端口、数据挂载与网络对照 compose 文件真正需要理解的就三处。1. 端口映射宿主机 3000容器端口映射到宿主机 3000部署完成后浏览器访问NAS的IP:3000即为入口。若 3000 已被占用改成任意空闲端口并同步修改访问地址即可。2. 数据持久化/books 与 /config两个目录必须挂载到 NAS 上的固定路径/books存放电子书源文件EPUB、PDF、MOBI 等都落在这里/config存放书库数据库、账号设置与阅读记录。这两个目录就是全部持久化数据后续备份只围绕它们做。3. 网络模式bridge家庭场景推荐 bridge 网络容器在局域网内通过固定端口暴露服务防火墙规则清晰也不会影响 NAS 上其他套件。三项确认后启动容器docker compose up -d用docker ps确认容器状态为 running部署即完成。首次访问与书库初始化从浏览器登录到第一本书打开浏览器输入NAS的IP:3000使用初始账号登录首次进入会提示修改密码。导入电子书有两条路在网页上手动上传或者直接把文件放进挂载的 /books 目录由书库自动识别。批量导入时目录里放几百本 EPUB 也没有压力。开启自动获取元数据导入后按书名自动补齐封面、作者、简介省去逐本手填。试读一本 PDF 或 EPUB确认翻页、字号调节、添加笔记在浏览器中正常。走到这一步私有书库的最小闭环已经成立书在 NAS 上入口在浏览器里。NAS 部署权限避坑指南UID/GID、挂载权限与文件系统NAS 环境和普通服务器最大的差别在权限模型三个高频问题按出现频率排序问上传文件失败或容器读不到 /books 里的书查用户身份。在容器高级设置中将运行用户的 UID/GID 配置为与 NAS 上归属用户一致再确认挂载目录本身对该用户有读写权限。两边只要有一边不匹配表现就是权限不足。问书库扫描慢导入大文件卡顿查存储介质。优先把 /books 放在 SSD 卷上文件系统格式ext4、Btrfs 等也要与 NAS 实际卷格式一致避免跨格式挂载时权限位丢失。问几千本书时页面加载变慢这属于性能问题而非权限问题给容器设置合理的内存上限避免与套件中心的备份任务抢内存同时定期清理 /config 里的数据库文件保持索引精简。这三类坑处理完大书库的浏览和检索才能稳定在可接受的响应速度内。 长期运维备份策略、元数据完善与多端同步部署完成不是终点长期维护只需盯住三件事备份/config 和 /books 是唯二需要备份的目录。用 Synology 任务计划器配一条定时任务每周把两个目录打包一份到另一个卷或外部存储恢复时按原路径挂回即可。元数据完善批量导入的书难免缺封面、缺简介隔一段时间在书库里筛出元数据不完整的条目批量补齐检索命中率和书架观感都会明显好转。多端同步手机、平板、电脑分别登录同一个地址阅读进度、书签、笔记都以服务端书库为准换设备时直接从上次位置继续。插件生态与官方参考资料Koodo Reader 的插件机制让私有书库不止于存和读OCR 插件识别扫描版 PDF 中的图片文字旧书电子化之后也能全文检索翻译插件阅读时实时划词翻译读外语书不必切窗口自定义主题调整字体、配色与排版让阅读界面贴合个人习惯。参考资料官方部署文档docs/deployment.md参数说明比本文更完整容器编排入口docker-compose.yml。把书收敛到 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），仅供参考 Koodo Reader NAS 部署指南：用 Docker 三步搭建私有电子书库
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 是一款开源电子书管理器。这篇文章讲的是如何把它部署到 Synology NAS 上把散落在手机、平板、电脑里的电子书收敛成一个私有书库支持跨设备阅读阅读进度、书签和笔记在服务端保持同步。面向的读者是只熟悉 Docker 基础概念、打算把家庭书库集中到 NAS 上的普通用户全文按时间线展开每一节都给出可直接照做的操作。部署前准备三项环境确认与获取项目代码部署本身不复杂卡住人的通常是环境。动手前在 Synology 套件中心确认三件事Docker 套件已安装且运行正常。Synology 上的 Container Manager 或 Docker 均可能正常拉取并启动容器即可。可用内存不低于 2GB。书库越大、访问设备越多容器实际占用越高2GB 是下限而不是建议值。存储按书库规模预留。粗略算法电子书文件总量 × 1.2 的安全系数再为系统镜像预留约 1GB。代码获取只需一条命令git clone https://gitcode.com/GitHub_Trending/koo/koodo-reader进入项目目录后根目录下有可直接使用的 docker-compose.yml无需从零编写编排文件。 docker-compose 三个关键配置端口、数据挂载与网络对照 compose 文件真正需要理解的就三处。1. 端口映射宿主机 3000容器端口映射到宿主机 3000部署完成后浏览器访问NAS的IP:3000即为入口。若 3000 已被占用改成任意空闲端口并同步修改访问地址即可。2. 数据持久化/books 与 /config两个目录必须挂载到 NAS 上的固定路径/books存放电子书源文件EPUB、PDF、MOBI 等都落在这里/config存放书库数据库、账号设置与阅读记录。这两个目录就是全部持久化数据后续备份只围绕它们做。3. 网络模式bridge家庭场景推荐 bridge 网络容器在局域网内通过固定端口暴露服务防火墙规则清晰也不会影响 NAS 上其他套件。三项确认后启动容器docker compose up -d用docker ps确认容器状态为 running部署即完成。首次访问与书库初始化从浏览器登录到第一本书打开浏览器输入NAS的IP:3000使用初始账号登录首次进入会提示修改密码。导入电子书有两条路在网页上手动上传或者直接把文件放进挂载的 /books 目录由书库自动识别。批量导入时目录里放几百本 EPUB 也没有压力。开启自动获取元数据导入后按书名自动补齐封面、作者、简介省去逐本手填。试读一本 PDF 或 EPUB确认翻页、字号调节、添加笔记在浏览器中正常。走到这一步私有书库的最小闭环已经成立书在 NAS 上入口在浏览器里。NAS 部署权限避坑指南UID/GID、挂载权限与文件系统NAS 环境和普通服务器最大的差别在权限模型三个高频问题按出现频率排序问上传文件失败或容器读不到 /books 里的书查用户身份。在容器高级设置中将运行用户的 UID/GID 配置为与 NAS 上归属用户一致再确认挂载目录本身对该用户有读写权限。两边只要有一边不匹配表现就是权限不足。问书库扫描慢导入大文件卡顿查存储介质。优先把 /books 放在 SSD 卷上文件系统格式ext4、Btrfs 等也要与 NAS 实际卷格式一致避免跨格式挂载时权限位丢失。问几千本书时页面加载变慢这属于性能问题而非权限问题给容器设置合理的内存上限避免与套件中心的备份任务抢内存同时定期清理 /config 里的数据库文件保持索引精简。这三类坑处理完大书库的浏览和检索才能稳定在可接受的响应速度内。 长期运维备份策略、元数据完善与多端同步部署完成不是终点长期维护只需盯住三件事备份/config 和 /books 是唯二需要备份的目录。用 Synology 任务计划器配一条定时任务每周把两个目录打包一份到另一个卷或外部存储恢复时按原路径挂回即可。元数据完善批量导入的书难免缺封面、缺简介隔一段时间在书库里筛出元数据不完整的条目批量补齐检索命中率和书架观感都会明显好转。多端同步手机、平板、电脑分别登录同一个地址阅读进度、书签、笔记都以服务端书库为准换设备时直接从上次位置继续。插件生态与官方参考资料Koodo Reader 的插件机制让私有书库不止于存和读OCR 插件识别扫描版 PDF 中的图片文字旧书电子化之后也能全文检索翻译插件阅读时实时划词翻译读外语书不必切窗口自定义主题调整字体、配色与排版让阅读界面贴合个人习惯。参考资料官方部署文档docs/deployment.md参数说明比本文更完整容器编排入口docker-compose.yml。把书收敛到 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），仅供参考