Komga｜漫画/绘本/扫描乐谱管理

用途：管理本地漫画、绘本、画册、扫描版乐谱，支持网页端直接阅读，局域网访问。

1. 核心作用

  1. 扫描NAS指定文件夹内文件，自动识别漫画/乐谱合集、分卷，提取封面、整理系列。
  2. 网页浏览器直接打开阅读，无需下载压缩包到本地；支持左右翻页、阅读进度记忆、放大。
  3. 支持文件格式：CBZ, CBR, ZIP, RAR, PDF, EPUB，扫描版乐谱PDF可以直接网页阅读。
  4. 多用户账号：可以创建多个独立账号，各自保留阅读进度、收藏、阅读列表，账号权限隔离。
  5. 元数据刮削：联网抓取漫画信息；纯本地扫描乐谱画册，关闭刮削不影响使用。

2. 资源占用

  • CPU：空闲几乎无消耗；打开PDF/高清大图、首次批量扫描目录时短时占用CPU。群晖4核足够。
  • 内存：基础常驻约 200~400MB。漫画/乐谱文件越大、同时打开的高清页数越多，内存占用越高。一般4G内存NAS可稳定运行。
  • 磁盘：程序本身很小；占用磁盘主要是你的漫画、PDF乐谱原始文件，Komga不重复拷贝文件，只读取原文件。

3. 前置准备（群晖）

  1. File Station 创建目录
    • /volumeX/docker/komga 存放Komga配置与数据库
    • /volumeX/books 存放漫画、画册、扫描乐谱（自己的媒体库目录）

      volumeX替换为实际卷号

  2. 权限：给komga目录和媒体书籍目录，docker用户组读写权限。

4. docker-compose.yml

services:
  komga:
    image: gotson/komga:latest
    container_name: komga
    restart: unless-stopped
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/config
      - /volumeX/books:/books:ro
    ports:
      - "25600:25600"
    networks:
      - komga_net

networks:
  komga_net:

/volumeX/books:/books:ro 使用只读挂载，保护你的乐谱/漫画原始文件不会被程序误删。

5. Container Manager部署步骤

  1. Container Manager → 项目 → 创建项目，项目名称komga
  2. 来源：上传docker-compose.yml
  3. 勾选自动启动，完成创建，等待镜像拉取启动。

6. 初始化设置

  1. 局域网访问：http://NAS内网IP:25600
  2. 首次打开，创建管理员账号密码。
  3. 媒体库添加：
    • 管理 → 媒体库 → 添加媒体库
    • 媒体库类型选「漫画」，文件夹填写 /books
    • 扫描设置：按需开启/关闭元数据联网刮削（纯本地乐谱建议关闭刮削）
  4. 保存后自动扫描目录，扫描完成即可网页阅读。

7. 备份

Komga的数据库、用户配置、阅读进度全部保存在/volumeX/docker/komga/data。定期备份该目录即可；原始乐谱漫画文件在/volumeX/books，不受Komga影响。

8. 常见问题

  1. 文件不显示：检查目录挂载路径、文件夹权限；容器内路径固定为/books。
  2. PDF扫描乐谱加载慢：高清大图PDF会消耗更多内存，拆分超大PDF可改善。
  3. 忘记管理员密码：删除data目录下数据库文件，重启容器重新初始化账号。
  4. 容器重启后失效：确认compose内restart: unless-stopped，并且媒体目录权限正确。

9. 关键要点

  • Komga不复制、不转存你的漫画/乐谱文件，只是读取、索引、网页预览。
  • 只读挂载:ro是推荐最佳实践，防止误操作修改源文件。
  • 适合PDF扫描乐谱：网页端直接翻阅，记录上次阅读位置，不用本地打开PDF阅读器。