知识与效率

Komga:搭建漫画与电子书阅读库

  • 0 次阅读
  • 0 条评论
文章摘要

Komga 管理自己的漫画与电子书文件,提供网页阅读、系列整理和元数据功能。适合把已有 CBZ、CBR、PDF、EPUB 等资料集中阅读,具体格式兼容性以当前文档为准。 书库扫描把文件组织成系列和书籍,网页阅读器负责翻页,账号权限控制可见范围。元数据能帮助修正排序与封面。 适合个人漫画和电子书集中阅读。先导入短系列,核对顺序再扩大书库。

项目介绍

Komga 管理自己的漫画与电子书文件,提供网页阅读、系列整理和元数据功能。适合把已有 CBZ、CBR、PDF、EPUB 等资料集中阅读,具体格式兼容性以当前文档为准。

书库扫描把文件组织成系列和书籍,网页阅读器负责翻页,账号权限控制可见范围。元数据能帮助修正排序与封面。

适合个人漫画和电子书集中阅读。先导入短系列,核对顺序再扩大书库。

核心功能

功能 作用与使用方式
系列整理 管理章节与卷
封面元数据 修正书籍信息
网页阅读 检查手机与电脑
阅读列表 组织专题内容
用户限制 按书库与规则授权

功能示意

Komga 功能示意图

图 1:自制功能示意图,概括本文的使用要点。

项目信息

项目 说明
类型 Docker
分类 知识与效率
官方入口或文档 直接访问
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 创建 /volume1/docker/komga/config 和书库目录 /volume1/books。为运行账号授予 config 读写、书库只读权限,在 .env 设置实际 UID、GID。
  2. 启动后打开 http://NAS_IP:25600,按首次访问引导创建管理员,添加媒体库时填写容器路径 /data。
  3. 先放入一个短系列测试扫描,检查排序、封面和阅读方向。为家庭成员创建普通账号,按需要限制书库。
  4. 批量导入后检查扫描错误,不要为了纠正识别问题直接更改大量原始文件。

首次使用与操作检查

扫描三册测试漫画,确认封面、卷号和阅读方向,再用普通账号访问。

扫描不到先查容器路径与权限。原书库可只读挂载,应用配置和数据库单独备份。

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。只回退镜像不一定能回退已经迁移过的数据库。

参考资料