ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

如何在群晖NAS上用Docker搭好私有书库:Koodo Reader部署指南

如何在群晖NAS上用Docker搭好私有书库:Koodo Reader部署指南 如何在群晖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 部署到群晖 NAS 上用 Docker 跑一个 7×24 在线的私有书库你读过的每本书、每条笔记都能跨设备取回。 先说清楚它到底帮你解决什么换设备接着读书、进度、标注都存在 NAS 上换手机还是换电脑打开就是上次的页码。格式不用再挑EPUB、PDF、MOBI/AZW3、TXT、FB2、漫画压缩包CBR/CBZ、MD/DOCX 都能放一个库全收。书是自己的私有化部署、无追踪书库不经过任何第三方服务器心里踏实。全家共用一份一个库服务全家还能加密码、PIN 甚至生物识别锁住书架。能对接你已有的工具KOReader 进度同步、OPDS 协议、笔记同步到 Notion/Obsidian 都支持具体能力清单见 README.md。✅ 动手前对照这张清单自检内存 ≥ 2GBCPU 能正常跑 Docker已安装并保持最新版 Docker 套件预留 50GB 以上空间按你的书库规模加减建好一个专门放电子书的共享文件夹记下 NAS 的内网 IP待会儿浏览器要用想好用哪个宿主机端口下文以 8080 为例️ 部署实战四步点亮私有书库第一步先拿到 Koodo Reader 镜像打开群晖 DSM → Docker → 注册表搜索koodo-reader选官方镜像的 latest 标签下载。⚠️ 本步最易踩的坑只看到同名镜像就下。确认来源是官方发布并选最新稳定标签。第二步再创建容器先勾两件保命设置镜像里点启动创建容器命名为koodo-reader并勾选启用自动重启——NAS 重启后服务能自己回来省得半夜爬起来手动拉起。第三步网络和端口一次配齐进入网络标签按 bridge 模式做映射容器端口宿主机端口用途808080或 3000 等空闲端口网页访问书库8080按需OPDS / 内置 HTTP 服务7200不用可留空KOReader 进度同步镜像本身暴露的端口定义见 Dockerfile。⚠️ 本步最易踩的坑80 端口常被 DSM 的 Web 服务占用映射失败时优先换宿主机端口并顺手确认防火墙放行了它。第四步最后挂卷 改默认账号在卷标签添加文件夹把你的共享文件夹挂载到容器内/app/uploads—— 这是网页上传书籍的落盘目录仓库示例挂载为/opt/uploads:/app/uploads见 docker-compose.yml。在环境变量里改掉默认凭据SERVER_USERNAME和SERVER_PASSWORD。在权限标签把 UID/GID 设为与 NAS 一致避免文件读写权限问题。⚠️ 本步最易踩的坑挂载路径写错上传的书丢了默认密码不关等于把书库钥匙挂在门口。部署完成后浏览器访问http://NAS-IP:8080登录就是你刚设的账号。 部署后必做的三件事按优先级数据安全最优先默认账号admin / securePass123必须立即改掉环境变量里设。在书库设置里加密码 / PIN 保护家人共用也不乱。把/app/uploads目录纳入群晖定时备份任务——书丢了可以重传进度和笔记丢了就没了。性能次优先NAS 有 SSD 缓存的话把 uploads 目录放进去大 PDF 翻页会明显跟手。书库上千本时给容器单独调高内存上限别让 Docker 默认值卡住索引。访问体验锦上添花群晖反向代理上 HTTPS走域名访问外面也能放心读。不需要的端口比如暂不用的 7200干脆别映射少暴露一分少一分风险。 上手玩法从导入第一本书开始导入第一本网页端直接把 EPUB/PDF 拖进上传区文件会落到/app/uploads元数据封面、作者、简介大多能自动补全不用手动填。按使用频率排功能日常最高频的是阅读 进度同步其次是书架分类和搜索按标题、作者、标签筛。容易被忽略的技巧一笔记与高亮支持导出 CSV/Markdown/HTML/TXT/PDF也能推到 Readwise、Notion、Obsidian——你随手划的重点最后变成了自己的知识库。容易被忽略的技巧二外接云盘导入。OneDrive、Google Drive、WebDAV、SMB、FTP 等来源的书可以直接拉进库不用先下载到电脑上倒手一遍。进阶开启 KOReader 进度同步需映射 7200 端口、OPDS 把整个书架变成可订阅源、阅读统计看月度阅读量遇到扫描版旧书内置 Paddle / Tesseract OCR 还能直接识别文字。 排障速查现象最可能原因一个动作解决浏览器打不开页面端口映射错或宿主机端口被占用netstat -tlnp \| grep 8080查占用换个端口重映射上传的书看不到卷没挂到/app/uploads进容器卷标签核对挂载路径重启容器登录一直失败环境变量里的用户名/密码写错对照环境变量检查SERVER_PASSWORD拼写容器起不来端口冲突或内存不足在 Docker 日志里看报错先释放被占端口大 PDF 翻页卡内存分配偏低容器设置里调高内存上限目录内文件按系列分文件夹 最后今晚起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),仅供参考
返回列表