自托管电子书管理工具Koodo Reader部署指南

1. 为什么需要自托管电子书管理工具

纸质书爱好者转向电子阅读时，往往会遇到一个尴尬的问题：收集了几百本电子书后，如何高效管理？系统自带的文件管理器只能按文件夹分类，Calibre这类专业软件又过于臃肿。更麻烦的是，当需要在手机、平板、电脑多端同步阅读进度时，常规方案基本束手无策。

Koodo Reader 这个开源项目正好解决了这些痛点。它提供了：

• 网页版电子书阅读器（支持EPUB/PDF等主流格式）
• 书籍元数据自动抓取（封面、作者、简介）
• 阅读进度多端同步
• 全文搜索与书摘管理
• 完全自托管的数据控制权

我最近将个人800多本电子书迁移到自托管的Koodo Reader实例，整个过程涉及Docker部署、反向代理配置、数据迁移等多个技术环节。下面分享具体实现方案和踩坑经验。

2. 基础环境准备

2.1 硬件配置建议

虽然Koodo Reader对资源要求不高，但根据书籍数量需要合理规划：

• 1000本以内：1核CPU + 1GB内存足够
• 5000本规模：建议2核CPU + 4GB内存
• 存储空间：纯文本电子书平均2MB/本，带插图的PDF约50MB/本

实测数据：我的800本混合格式电子书（含200本PDF）占用磁盘空间约12GB

2.2 软件依赖安装

以Ubuntu 22.04为例，需要先安装基础组件：

bash复制# 更新系统
sudo apt update && sudo apt upgrade -y

# 安装Docker
sudo apt install docker.io docker-compose
sudo systemctl enable --now docker

# 创建专用数据目录
mkdir -p /data/koodo/{library,config}

这里特别说明目录结构设计：

• /data/koodo/library 存放电子书文件
• /data/koodo/config 存储应用配置和数据库

3. Docker部署实战

3.1 容器编排配置

创建docker-compose.yml文件：

yaml复制version: '3'
services:
  koodo:
    image: troyeguo/kood