18
19
群晖 + Komga + iPad 看漫画全流程
2026-10-10 14:55:07
1点赞
1收藏
0评论
家里群晖里攒了不少自己购买、扫描整理的 CBZ 漫画，一直想在 iPad 上像看实体书一样翻。折腾了一圈，最后定下来的方案是：群晖跑 Komga 做书库管理，iPad 上用原生 App 连接阅读。下面把完整流程记录一下，给有同样需求的朋友参考。
一、准备工作
群晖 DSM 7.x，已在套件中心安装 Container Manager（DSM 7.2 以前叫 Docker）
一个用来放漫画的共享文件夹，例如
/volume1/comics一个放 Komga 配置的文件夹，例如
/volume1/docker/komga/config
二、用 Container Manager 部署 Komga
打开 Container Manager →「项目」→「新增」，路径选 /volume1/docker/komga，来源选「创建 docker-compose.yml」，粘贴下面的内容：
services:
komga:
image: gotson/komga:latest
container_name: komga
ports:
- "25600:25600"
volumes:
- /volume1/docker/komga/config:/config
- /volume1/comics:/data:ro
environment:
- TZ=Asia/Shanghai
user: "1026:100" # 改成你自己账号的 UID:GID，SSH 里执行 id 查看
restart: unless-stopped
几点说明：
漫画目录以只读（
:ro）挂载，Komga 不会改动你的源文件，更安心；user一定要改成对共享文件夹有读权限的账号，否则扫描时会报权限错误；部署完成后浏览器访问
http://群晖IP:25600，首次打开会让你创建管理员账号。
如果要外网访问，建议用 DSM 自带的反向代理加 HTTPS，或者走 Tailscale / ZeroTier 组网，不要直接把 25600 端口裸露在公网。
三、整理 CBZ 文件夹
Komga 的规则很简单：一个子文件夹 = 一个系列，文件夹里的每个压缩包 = 一本/一话。推荐这样放：
/volume1/comics
├── 系列A
│ ├── 系列A 第01卷.cbz
│ ├── 系列A 第02卷.cbz
│ └── 系列A 第03卷.cbz
└── 系列B
├── 系列B 第001话.cbz
└── 系列B 第002话.cbz
小技巧：
文件名里的序号补零（01、02……），排序不会乱；
封面放在压缩包内第一张图即可；
如果有 ComicInfo.xml，Komga 会自动读取标题、作者、简介等元数据；
扫描版建议统一打包成 CBZ（本质就是 zip），兼容性最好。
四、在 Komga 中创建书库
登录 Komga 网页后台 → 左侧「书库」旁边的「+」→ 填写名称，根目录选 /data（就是容器里映射的漫画目录）→ 保存。Komga 会自动扫描，几千本也就几分钟。之后新增漫画只要丢进对应文件夹，Komga 会定时扫描，也可以手动点「扫描书库」。
建议顺便在「设置 → 用户」里给家人单独建账号，各自的阅读进度互不干扰。
五、在 iPad 上阅读
Komga 网页版本身能看，但在 iPad 上体验一般，所以我用的是原生阅读器 漫阅 ManYue，连接步骤：
App Store 安装漫阅：https://apps.apple.com/app/id6753895889
打开 App，进入 书库 → + → 添加 Komga 服务器（英文界面为 Library → + → Add Komga Server）；
填入地址
http://群晖IP:25600、Komga 的用户名和密码，保存后就能看到全部系列。
Komga 官方文档里也有漫阅连接说明：https://komga.org/docs/guides/manyue/
用下来比较顺手的几点：
iPad 横屏双页：跨页大图能完整显示，接近翻实体书的感觉；
离线下载：出门前把要看的卷下载到本地，地铁、飞机上照样看；
SMB / WebDAV 直连：不想装 Komga 的话，也可以直接连群晖的 SMB 共享文件夹读 CBZ；
iCloud 同步：iPhone 和 iPad 之间阅读进度、收藏自动同步。
需要说明的是：连接 Komga 等服务器书库属于 App 的付费 Ultra 档位，本地文件阅读不需要；App 需要 iOS 15 及以上。
六、常见问题
扫描不到文件：九成是权限问题，检查 compose 里的
user和共享文件夹权限；排序错乱：给文件名序号补零；
外网连不上：确认反代 / 组网配置，App 里填外网地址即可。
以上就是我的完整方案，有问题欢迎在楼下交流。
声明：我是漫阅的开发者，文中提到 App 的部分如有不清楚或想要的功能，欢迎直接提意见。本文只讨论管理和阅读自己合法拥有的漫画文件。
作者声明本文存在利益相关性，请大家尊重作者及分享的内容，友善沟通，理性决策~
