【Docker部署】一键搭建Koodo Reader，打造个人电子书管理神器！

【Docker部署】一键搭建Koodo Reader，打造个人电子书管理神器！

• 1.1 Koodo Reader简介

• 1.2 Koodo Reader主要特点

• 2.1 本地环境规划

• 2.2 本次实践介绍

• 3.1 检查Docker服务状态

• 3.2 检查Docker版本

• 3.3 检查docker compose 版本

• 5.1 创建部署目录

• 5.2 编辑部署文件

• 5.3 创建Koodo Reader容器

• 5.4 查看Koodo Reader容器状态

• 5.5 检查容器运行日志

• 6.1 访问Koodo Reader首页

• 6.2 导入图书

• 6.3 客户端下载

一、Koodo Reader介绍

1.1 Koodo Reader简介

Koodo Reader是一款现代开源电子书管理与阅读软件，支持跨平台同步与备份，兼容多种主流电子书格式，提供AI翻译、摘要、文本转语音等智能功能，适用于 Windows、macOS、Linux、Android、iOS 及 Web 端，帮助用户在任何设备上流畅阅读和管理个人图书库。

1.2 Koodo Reader主要特点

• 多格式支持：完整支持 EPUB、PDF、MOBI、AZW3、FB2、CBR/CBZ 等主流电子书格式。

• 跨平台兼容：可在 Windows、macOS、Linux、Android、iOS 以及网页端无缝使用。

• 云同步与备份：通过 OneDrive、Google Drive、MEGA、WebDAV 等云服务实现数据自动同步与备份。

• 便捷图书导入：直接从云盘或远程服务器批量导入电子书，无需本地中转。

• AI 智能翻译：集成 AI 翻译功能，实现整段或划词即时翻译，提升外文阅读体验。

• AI 词典查询：支持 AI 驱动的智能词典，提供精准释义与例句。

• AI 内容摘要：自动提取章节或全文核心内容，快速掌握书籍要点。

• 多种阅读布局：提供单栏、双栏与连续滚动三种阅读模式，适应不同书籍类型。

• 文本转语音：内置 TTS 功能，可将文字朗读出来，支持离线与在线发音引擎。

• 触屏友好设计：优化触控操作，支持手势翻页与触摸高亮，适合平板与触屏设备。

• 批量子目录导入：可一次性导入整个文件夹中的书籍，自动分类整理。

• 笔记与标注：支持添加书签、高亮、下划线及文本笔记，便于知识管理。

• 个性化排版设置：自由调整字体、字号、行距、段距、页边距与背景/文字颜色。

• 夜间模式与主题色：提供夜间阅读模式及多种主题颜色切换，保护视力。

• 富文本标注样式：支持对文本进行加粗、斜体、阴影等样式高亮标记。

• 开源免费：完全开源且永久免费，无广告、无追踪，保障用户隐私与自由。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎； 2.在Docker环境下部署Koodo Reader电子书阅读器。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven:~# systemctl status docker ● docker.service - Docker Application Container Engine Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled) Active: active (running) since Mon 2025-08-04 10:10:52 UTC; 30min ago TriggeredBy: ● docker.socket Main PID: 860 (dockerd) Tasks: 10 Memory: 97.2M (peak: 98.4M) CPU: 606ms CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

root@jeven:~# docker -v Docker version 28.3.3, build 980b856

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven:~# docker -v Docker version 28.3.3, build 980b856

四、拉取Koodo Reader镜像

下载Koodo Reader容器镜像，如下所示

docker pull ghcr.io/koodo-reader/koodo-reader:master

五、部署Koodo Reader服务

5.1 创建部署目录

• 创建部署目录

mkdir -p /data/koodo/uploads && cd /data/koodo/

• 目录授权

chmod -R 755 /data/koodo/

5.2 编辑部署文件

使用docker-cli方式部署，可参考以下命令：

docker run -d --name koodo-reader -p 8022:80 -p 8023:8080 -e ENABLE_HTTP_SERVER=false -e SERVER_USERNAME=admin -e SERVER_PASSWORD=admin123 -v /data/koodo/uploads:/app/uploads ghcr.io/koodo-reader/koodo-reader:master

在部署目录下，创建docker-compose.yaml文件，内容如下所示：

vim docker-compose.yaml

version: '3.9' services: koodo-reader: image: 'ghcr.io/koodo-reader/koodo-reader:master' volumes: - '/data/koodo/uploads:/app/uploads' environment: - SERVER_PASSWORD=admin123 - SERVER_USERNAME=admin - ENABLE_HTTP_SERVER=false ports: - '8023:8080' - '8022:80' container_name: koodo-reader

📦 Koodo Reader Docker 配置说明

🔧 环境变量（Environment Variables）

💡 提示：若要使用“Docker 数据源”功能（即从容器中读取书籍），必须将 ENABLE_HTTP_SERVER 设置为 true，并确保用户名和密码安全。

🌐 端口映射（Ports）

⚠️ 注意：

• 默认情况下，数据源使用 8080，Web 前端使用 80。

• 如果你想更改数据源端口（如改为 8090），应修改为：- '8090:8080'。

• 若要切换 Web 端口，修改 - '8022:80' 中的主机端口即可（如改为 8080:80）。

📁 挂载目录（Volumes）

✅ 建议：

• 将 /data/koodo/uploads 替换为你实际希望存储书籍的本地路径，例如：/home/user/koodo-data:/app/uploads。

• 确保该目录有读写权限，否则可能导致导入失败或同步异常。

5.3 创建Koodo Reader容器

执行以下命令，创建Koodo Reader容器。

docker compose up -d

5.4 查看Koodo Reader容器状态

检查Koodo Reader容器运行状态，确保Koodo Reader容器正常启动。

root@jeven:/data/koodo# docker compose ps WARN[0000] /data/koodo/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS koodo-reader ghcr.io/koodo-reader/koodo-reader:master "/start.sh" koodo-reader 11 minutes ago Up 11 minutes 443/tcp, 2019/tcp, 443/udp, 0.0.0.0:8022->80/tcp, [::]:8022->80/tcp, 0.0.0.0:8023->8080/tcp, [::]:8023->8080/tcp

5.5 检查容器运行日志

检查容器运行日志，确保Koodo Reader服务正常运行。

docker compose logs

六、访问Koodo Reader服务

6.1 访问Koodo Reader首页

浏览器地址： http://<个人的服务器IP>:8022，访问Koodo Reader的初始安装页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

6.2 导入图书

点击“导入图书”选项，上传本地资料，如下所示：

在线浏览图书，效果如下：

6.3 客户端下载

官方Android 版本和IOS 版本等版本下载地址如下：

• Github地址：https://github.com/koodo-reader/koodo-reader/releases/

• 官网地址：https://koodoreader.com/zh

七、总结

通过本次实践，我们成功使用Docker部署了Koodo Reader电子书阅读器，搭建起一个支持多格式、跨平台的本地化阅读环境。该服务运行稳定，界面简洁，开发版本已具备完善的图书管理与阅读功能，个人使用完全够用。通过自托管方式部署，既能保护隐私，又能灵活管理电子书库，是个人数字阅读的理想解决方案。

作者声明本文无利益相关，欢迎值友理性交流，和谐讨论～