在 Olares 上用 Komga 构建数字漫画与电子书图书馆:安装、媒体组织与元数据管理实战
在 Olares 上用 Komga 构建数字漫画与电子书图书馆:安装、媒体组织与元数据管理实战
Komga 是一款专注于漫画、manga、BD(法语漫画)、杂志与电子书收藏的开源媒体服务器,Olares 用户可以通过 Market 一键安装,将个人数字藏书托管在本地。本文以 docs/zh/use-cases/komga.md 为主线,完整演示从安装、初始化管理员账户、组织媒体文件、创建图书馆,到阅读书籍、编辑元数据与触发手动扫描的端到端流程,并补充 Olares 应用数据目录机制与仓库内可交叉验证的细节,让你读完即可上手搭建属于自己的数字图书馆。
Komga 是什么:面向漫画与电子书的专用媒体服务器
与通用的视频媒体服务器不同,Komga 专为"页式阅读"的数字收藏而设计,覆盖的类型包括:
- 漫画(Comics)
- manga(日式漫画)
- Bandes Dessinées(BD,法语漫画)
- 杂志(Magazines)
- 电子书(E-books)
它自带 Webreader(网页阅读器)与元数据编辑器,能够自动扫描指定目录、提取书籍封面与标题,并通过图书馆(Library)的概念将不同类型的藏书分门别类地组织起来。在 Olares 中,Komga 以应用形式安装,其数据落盘在 Olares 统一的文件体系中,与 Files 应用深度打通,因此你既可以像管理普通文件一样上传媒体,也能在浏览器中享受完整的阅读体验。
安装 Komga:从 Olares Market 一键获取
- 打开 Olares Market,搜索 "Komga"。
- 点击 获取(Get),再点击 安装(Install),等待安装完成。
安装完成后,Komga 会出现在 Launchpad(启动器)中,点击图标即可打开。安装过程本身不涉及任何命令行操作,全部在 Market 的图形界面中完成;后续所有数据管理也都围绕 Olares 的文件体系进行,无需进入容器内部。
初始化:创建管理员账户
首次打开 Komga 时必须注册一个账户,该账户即管理员账户,拥有服务器设置、图书馆与用户管理的完全控制权。
- 打开 Komga。
- 输入电子邮件和密码,创建你的主管理员账户。
- (可选)从 翻译(Translation) 列表中选择首选语言。
- (可选)从 主题(Theme) 列表中选择偏好的背景颜色模式。
- 点击 创建用户账户(CREATE USER ACCOUNT)。随后出现的 欢迎使用 Komga(Welcome to Komga) 页面即表示初始化完成。
准备媒体文件:理解 Olares 应用数据目录
Komga 通过扫描 Olares 中的专用目录来填充图书馆,因此媒体文件必须放在约定位置,应用才能检测到它们:
- 从 Launchpad 打开 Files 应用。
- 导航到
Application/Data/komga/data/。 - 将媒体文件上传到此目录,或在该目录下创建子文件夹来分类文件。
这里有一个值得展开的机制:Application/Data/komga/data/ 是 Olares 文件体系中该应用的数据挂载点,它对应 Komga 容器内部的 /data 目录。换句话说,你在 Files 里看到的路径与 Komga 内部扫描的根路径是同一份数据——这正是"在 Files 中上传、在 Komga 中自动出现"的原理。
这一 Application/Data/{应用名}/ 的目录约定在仓库内多处文档中得到印证,例如 docs/zh/use-cases/opencode.md 中同样以 Application/Data/opencode/.config/opencode/ 作为应用配置数据的存放位置。可见"应用数据归入 Application/Data 下各自命名空间"是 Olares 的统一规则,这也让备份、迁移与卸载清理有了明确边界(详见后文"彻底卸载"一节)。
针对 Komga 场景,建议在上传阶段就规划好目录结构,例如:
Application/Data/komga/data/
├── comics/ # 美漫
├── manga/ # 日漫
├── bd/ # 法语漫画
├── magazines/ # 杂志
└── ebooks/ # 电子书
清晰的子文件夹划分,可以让后续创建图书馆时以子目录为单位精准归类,而不必把所有内容混在一个大图书馆里。
创建图书馆:把文件变成可浏览的收藏
上传文件后,需要通过创建图书馆(Library)把它们接入 Komga 界面。图书馆是一组书籍的集合,可以创建多个图书馆来分离不同类型的内容。
- 在 Komga 主屏幕上点击 添加图书馆(ADD LIBRARY),或点击左侧边栏 图书馆(Libraries) 旁的加号图标,打开 添加图书馆(Add Library) 窗口。
- 在 常规(GENERAL) 标签页配置以下设置,然后点击 下一步(NEXT):
- 名称(Name):指定图书馆的名称。
- 根文件夹(Root folder):点击 浏览(BROWSE) 选择文件位置。
- 若希望将所有媒体文件和子文件夹都包含在一个大型图书馆中,选择
/data文件夹。 - 若希望将图书馆内容限制为特定类别,选择对应的子文件夹,如
/data/{子文件夹名称}。
- 若希望将所有媒体文件和子文件夹都包含在一个大型图书馆中,选择
- 在 扫描器(SCANNER) 标签页,配置 Komga 如何识别媒体文件,主要包括扫描间隔与可识别的文件类型。扫描间隔决定 Komga 多久自动巡检一次目录(创建完成后会进入默认的定期扫描节奏),文件类型则限定入库范围;此处的配置直接决定后续"自动发现新文件"的行为。
- 在 选项(OPTIONS) 标签页,设置文件分析与封面图像生成的首选项,例如是否分析文件内容以提取页面信息、是否为书籍生成缩略封面等。
- 在 元数据(METADATA) 标签页,选择要导入的元数据类型,然后点击 添加(ADD)。
添加完成后,Komga 会自动扫描关联目录,并在界面中展示书籍封面与标题:
路径取舍建议:选择 /data 作为根文件夹意味着一个图书馆收纳全部内容,适合藏书量不大、希望统一浏览的场景;选择子文件夹则更适合按体裁或系列拆分多个图书馆,便于后续按类型浏览与授权(见"用户管理与访问控制"一节)。
编辑元数据:让书架更精致
Komga 会自动从媒体文件中提取嵌入的元数据(如摘要、发布日期),但手动完善这些信息能让图书馆外观更整齐、浏览更高效。
操作入口:将鼠标悬停在书籍封面上,点击编辑图标,在 编辑元数据(Edit metadata) 窗口中按需使用以下标签页:
| 标签页 | 功能 |
|---|---|
| 常规(General) | 定义书籍在图书馆列表中的显示方式:
|
| 作者(Authors) | 按角色添加贡献者,如 作者(Writers)、铅笔稿(Pencillers) 与 墨水稿(Inkers),从而可按特定艺术家筛选图书馆。 |
| 标签(Tags) | 创建自定义标签按主题分组书籍,如 "90 年代美学",并支持基于标签搜索。 |
| 链接(Links) | 点击加号图标添加外部 URL,如官方系列网站,便于快速获取书籍的更多信息。 |
| 海报(Poster) | 拖放新图像或选择文件替换默认书籍封面,个性化数字书架的外观。 |
实践建议:对于连载中的长篇系列,优先维护"编号 + 排序编号"两项,可避免因标题或日期差异导致的卷序错乱;对跨系列的主题收藏(如特定年代、特定画风),善用标签比反复建图书馆更灵活。
阅读书籍:使用内置 Webreader
图书馆组织好后,即可用内置 Webreader 开始阅读:
- 找到目标书籍。
- 使用以下任一方式打开:
- 将鼠标悬停在书籍封面上,点击阅读图标(auto_stories)。
- 点击书籍标题进入详情页,再点击 阅读(READ)。
书籍会立即在 Webreader 中打开,无需下载或安装任何额外阅读器,翻页、缩放等阅读操作均在同一浏览器会话内完成。
扫描图书馆文件:让新内容即时出现
默认情况下,Komga 会依据创建图书馆时设置的间隔定期扫描。但如果添加、重命名或移动了媒体文件并希望立刻生效,可以触发手动扫描:
- 从左侧边栏找到目标图书馆。
- 点击其旁的三点菜单(more_vert),选择 扫描图书馆文件(Scan library files)。
图书馆随即刷新,并拉取所有新增或变更的内容。该操作等价于强制执行一次"创建图书馆时的扫描流程",是日常增量更新最快的路径。
进阶:用户管理与访问控制
Komga 支持多用户体系,可用于将图书馆共享给家人或团队成员,并为每个账户分配不同权限。管理员进入 服务器(Server)> 用户(Users) 后,可以添加账户并为其指定角色,常见角色及其权限如下(参考英文原版文档 docs/use-cases/komga.md 中的规划说明):
| 角色 | 权限 |
|---|---|
| 管理员(Administrator) | 拥有服务器设置、图书馆与用户管理的完全控制权 |
| 文件下载(File download) | 允许将媒体文件保存到本地设备,用于离线阅读 |
| 页面流式传输(Page streaming) | 允许通过 Webreader 或兼容应用直接阅读书籍 |
| Kobo Sync | 允许将阅读进度、书签与图书馆同步到 Kobo 设备 |
| KOReader Sync | 允许将阅读进度、书签与图书馆同步到 KOReader 应用 |
添加用户后,还可以通过 编辑限制(Edit restrictions) 进一步细粒度控制:在 共享图书馆(Shared libraries) 标签页勾选该用户可访问的图书馆,在 内容限制(Content restrictions) 标签页按年龄分级或标签限定可访问内容。这套机制与"创建多个图书馆 + 子文件夹归类"的策略配合使用效果最佳——先按内容类型拆分图书馆,再按用户授予不同图书馆的访问权。
常见问题
如何执行彻底卸载?
如果卸载 Komga 并希望删除所有残留数据:
- 打开 Files 应用,前往 应用(Application)> 数据(Data)。
- 删除
komga文件夹。
删除该文件夹会移除全部数据库配置与缓存的元数据。由于 Komga 的数据全部集中在 Application/Data/komga/ 这一命名空间下,卸载清理非常干净,不会留下散落各处的残留文件。
为什么无法使用 Komga 中的"导入"功能?
导入功能(Import)的设计初衷是将图书馆外部位置(如 Downloads 文件夹)的文件移动或复制到既有系列中。但在 Olares 环境中,出于安全与隐私考虑,文件选择器被限制在 /data 目录内。由于你的图书馆本身已经位于该目录,系统检测不到外部文件,因此导入工具不可用。
正确的添加入口是:使用 Files 应用将媒体文件上传到 Application/Data/komga/data/。上传完成后,Komga 会在下一次计划扫描时自动检测到它们,也可以通过 扫描图书馆文件 手动触发即时扫描。
延伸阅读
- 中文版操作指南:docs/zh/use-cases/komga.md
- 英文原版指南(含用户角色与限制的完整规划内容):docs/use-cases/komga.md
- 了解 Olares 应用数据与用户数据的备份策略:docs/zh/manual/feature-overview.md
- 应用数据占用的磁盘空间管理:docs/zh/manual/free-up-disk-space.md


