shenshangshang/komga-cn repository overview

⁠Komga-CN MySQL 版

基于 Komga 1.25.0 的 MySQL 8.4 适配版，新增智能页面预加载功能。

⁠功能特性

• MySQL 8.4 数据库支持（主库+任务库双数据库架构）
• 智能页面预加载（翻页延迟从 50-200ms 降至 <5ms）
• Caffeine 本地缓存（500 页缓存池，10 分钟过期）
• 环境变量配置，无需修改配置文件
• 内置健康检查

⁠快速部署

⁠1. 准备 MySQL 数据库

CREATE DATABASE komga CHARACTER SET utf8mb4; CREATE DATABASE komga_tasks CHARACTER SET utf8mb4; CREATE USER 'komga'@'%' IDENTIFIED BY 'password'; GRANT ALL ON komga.* TO 'komga'@'%'; GRANT ALL ON komga_tasks.* TO 'komga'@'%';

⁠2. 使用 Docker CLI 部署

docker run -d --name komga-cn -p 25600:25600
-v /data/comics:/comics
-v /data/config:/config
-e DATABASE_URL="jdbc:mysql://host:3306/komga?serverTimezone=UTC&characterEncoding=utf8mb4"
-e DATABASE_USERNAME="komga"
-e DATABASE_PASSWORD="password"
-e TASKS_DATABASE_URL="jdbc:mysql://host:3306/komga_tasks?serverTimezone=UTC&characterEncoding=utf8mb4"
-e TASKS_DATABASE_USERNAME="komga"
-e TASKS_DATABASE_PASSWORD="password"
-e PREFETCH_PAGES=3
shenshangshang/komga-cn:latest

⁠3. 访问服务

浏览器打开: http://服务器IP:25600⁠

⁠环境变量配置

⁠必填变量

• DATABASE_URL: 主数据库 JDBC 连接
• DATABASE_USERNAME: 数据库用户名
• DATABASE_PASSWORD: 数据库密码
• TASKS_DATABASE_URL: 任务数据库连接
• TASKS_DATABASE_USERNAME: 任务库用户名
• TASKS_DATABASE_PASSWORD: 任务库密码

⁠可选变量

• PREFETCH_PAGES: 预加载页数 (默认3, 范围0-10)
• SERVER_PORT: 服务端口 (默认25600)
• TZ: 时区 (如 Asia/Shanghai)

⁠数据库 URL 格式

jdbc:mysql://主机:端口/数据库名?serverTimezone=UTC&characterEncoding=utf8mb4

示例:

• 本地: jdbc:mysql://localhost:3306/komga?...
• Docker: jdbc:mysql://mysql:3306/komga?...
• 远程: jdbc:mysql://192.168.1.100:3306/komga?...

⁠预加载功能说明

• 原理: 访问第N页时，后台异步预加载第N+1到N+3页
• 效果: 顺序翻页几乎无延迟（<5ms）
• 配置: 通过 PREFETCH_PAGES 环境变量调整（0-10）

⁠技术信息

• 基础镜像: eclipse-temurin:21-jre-alpine
• 镜像大小: 323MB
• 架构: linux/amd64
• 版本: Komga 1.25.0 (MySQL Edition)

⁠许可证

基于原 Komga 项目的 MIT 许可证