库
你可以将内容分到不同的书库中;每个书库由一组书籍组成。 还可以将书库的访问权限限制给特定用户。
每个书库都有一个根文件夹,任意两个书库的路径都不能有重叠部分。
例如,如果已有书库的根路径为 /books/mangas,就不能再创建根路径为 /books 的书库,因为两条根路径会发生重叠。 不过,你可以创建根路径为 /books/comics 的书库。
创建库
在网页界面中:
- 点击侧栏中 库 旁边的 + 图标

- 为书库设置一个 名称
- 点击 浏览 按钮,并选择包含书籍的根文件夹
- 点击 添加
你还可以配置其他选项。
扫描器
每次扫描后自动清空回收站
请参阅清空书库回收站。
强制设置目录修改时间
此选项会将目录的最后修改时间强制设为该目录自身与其中所有书籍的最后修改时间中的最新值。 仅当文件系统不会在目录内的文件发生更改时更新目录的最后修改时间(例如 Google Drive)才应启用此选项。
启动时扫描
启用后,Komga 启动时会扫描该书库。
扫描间隔
选择按固定时间间隔扫描所有书库。 从下拉列表中选择要使用的扫描间隔。 可用频率:
- 禁用
- 每小时
- 每隔 6 小时
- 每隔 12 小时
- 每日
- 每周
扫描间隔从 Komga 启动或你更改该书库设置的时间开始计算。 例如,如果设置为“每隔 6 小时”,并在 12:35 启动服务器,则会在 18:35 左右开始扫描。
单篇作品目录
请参阅单篇作品。
扫描以下文件类型
此选项会将扫描器配置为仅查找具有指定扩展名的文件。 可用类型:
- 漫画压缩包:
cbz、zip、cbr、rar - PDF:
pdf - EPUB:
epub
排除目录
你可以指定任意模式,在扫描时排除匹配的目录子树。
完整路径中包含任一已配置模式的目录都会在扫描时被忽略。
模式会与目录路径的任意部分进行匹配:
#recycle可以匹配:/data/books/Comics/#recycle/data/books/Comics/My weirdly named #recycle comic
若只想匹配名称以指定字符串开头的目录,请在模式前加上 /,例如 /#recycle
选项
分析
计算文件哈希值
Komga 会为文件计算哈希值。 “从回收站恢复”功能和重复文件检测需要使用此哈希值。
在大型书库或性能较低的硬件上,此功能可能消耗大量资源。
计算页面哈希值
Komga 会为每本书最前和最后的 3 个页面计算哈希值(仅限 cbz)。 这些哈希值用于检测重复页面。
在大型书库或性能较低的硬件上,此功能可能消耗大量资源。
为 KOReader 计算文件哈希值
Komga 会为文件计算 KOReader 哈希值。 必须启用此功能才能使用 KOReader 同步。
在大型书库或性能较低的硬件上,此功能可能消耗大量资源。
分析页面尺寸
Komga 会获取每个页面的尺寸(宽度和高度)。 此功能可用于:
- 在网页阅读器中使用双页模式时正确显示横向页面
- 在“导入”对话框中比较页面尺寸
在大型书库或性能较低的硬件上,此功能可能消耗大量资源。
文件管理
自动修复不正确的文件扩展名
扩展名不正确的文件会在后台自动重命名。 例如,扩展名为 .cbr 的 zip 文件会被重命名为 .cbz。
自动转换为 CBZ 格式
rar/cbr 格式的书籍会在后台自动转换为 cbz。 zip 文件使用 DEFLATE 方法创建,但不进行压缩。
系列封面
选择要用作系列封面的书籍封面。
元数据
请参阅刷新元数据一节,了解这些选项的作用。
编辑书库
要编辑书库,请找到操作菜单图标
,然后点击_编辑_。
如果更改书库的根文件夹,并且__新路径与原路径没有任何重叠部分__,你将丢失该书库中的所有系列、书籍和阅读进度。
如果将路径改为__当前路径的父目录__,则不会丢失内容。
如果将路径改为__当前路径的子目录__,则会丢失部分内容。
删除书库
要删除书库,请找到操作菜单图标
,然后点击_删除_。
删除书库会移除其中包含的所有系列和书籍。 这些书籍的所有阅读进度也会被删除。
媒体文件不会受到影响。
此操作无法撤销。