项目介绍
Komga 管理自己的漫画与电子书文件,提供网页阅读、系列整理和元数据功能。适合把已有 CBZ、CBR、PDF、EPUB 等资料集中阅读,具体格式兼容性以当前文档为准。
书库扫描把文件组织成系列和书籍,网页阅读器负责翻页,账号权限控制可见范围。元数据能帮助修正排序与封面。
适合个人漫画和电子书集中阅读。先导入短系列,核对顺序再扩大书库。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 系列整理 | 管理章节与卷 |
| 封面元数据 | 修正书籍信息 |
| 网页阅读 | 检查手机与电脑 |
| 阅读列表 | 组织专题内容 |
| 用户限制 | 按书库与规则授权 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | 知识与效率 |
| 官方入口或文档 | 直接访问 |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 创建
/volume1/docker/komga/config和书库目录/volume1/books。为运行账号授予 config 读写、书库只读权限,在.env设置实际 UID、GID。 - 启动后打开
http://NAS_IP:25600,按首次访问引导创建管理员,添加媒体库时填写容器路径/data。 - 先放入一个短系列测试扫描,检查排序、封面和阅读方向。为家庭成员创建普通账号,按需要限制书库。
- 批量导入后检查扫描错误,不要为了纠正识别问题直接更改大量原始文件。
首次使用与操作检查
扫描三册测试漫画,确认封面、卷号和阅读方向,再用普通账号访问。
扫描不到先查容器路径与权限。原书库可只读挂载,应用配置和数据库单独备份。
Docker Compose
依据 Komga 官方 Docker 安装文档整理;书库改为只读挂载。按下方命令创建目录,示例运行身份已写为 0:0。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/komga/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/books /volume1/docker/komga /volume1/docker/komga/config
cd /volume1/docker/komga
HALO_PREPARE
cd /volume1/docker/komga
本示例使用数值 0 访问挂载目录,无需查询或填写 UID/GID。
services:
komga:
image: gotson/komga:latest
restart: unless-stopped
user: "0:0"
ports:
- "25600:25600"
environment:
TZ: Asia/Shanghai
volumes:
- /volume1/docker/komga/config:/config
- /volume1/books:/data:ro
在项目目录保存为 compose.yaml 后,先检查配置,再启动:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
配置与常见问题
- 示例把书库只读挂载,适合保护原文件;确实需要写回时再单独评估权限。
- 数据库目录需要可写,书库可读并不代表应用配置也有写权限。
- 页面无法打开:先用
docker compose ps检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。 - 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。
更新与备份
备份 config 数据库和原始书籍;只保存缩略图无法恢复书库。
更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。