简约但绝不简单的Komga

最新推荐文章于 2025-03-21 18:39:34 发布

杨浦老苏

最新推荐文章于 2025-03-21 18:39:34 发布

阅读量1.3w

点赞数 2

文章标签： docker kotlin vue

本文链接：https://blog.csdn.net/wbsu2004/article/details/119748045

版权

什么是 Komga ？

Komga 是一个免费、开源的漫画服务器，支持 REST API 和 OPDS 。因此 Komga 理论上适用于任何支持 OPDS 协议的阅读器。支持的文件格式包括： CBZ、CBR、PDF 和 epub 格式。

官方提供了演示网站可用于体验：https://demo.komga.org

账号： demo@komga.org
密码： komga-demo

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 komga ，选择第一个 gotson/komga，版本选择 latest。

卷

在 docker 文件夹中，创建一个新文件夹，并将其命名为 komga，并在 komga 中建两个子文件夹，分别命名为 config 和 data

在 config 中创建一个空的 database.sqlite 文件

文件夹	装载路径	说明
`docker/komga/config`	`/config`	存放数据库和设置
`docker/komga/data`	`/data`	存放书架

建议 /data 目录勾选 只读

端口

端口不冲突就行，这里用了 3080

本地端口	容器端口
3080	8080

命令行安装

在 CentOS 安装

# 在komga中创建子目录
mkdir config data

# 创建文件
cd config
touch database.sqlite

# 运行容器
docker run \
  --name=komga \
  --user 1000:1000 \
  -p 3080:8080 \
  -v /usr/komga/config:/config \
  -v /usr/komga/data:/data \
  --restart unless-stopped \
  gotson/komga:latest

运行

在浏览器中输入 http://群晖IP:3080，就能看到主界面了

Translation 中拉到最底部是支持 简体中文 的，所见即所得，不需要重启和刷新

创建用户账号 完成后，底部红色的不用管，直接关闭就可以

进入后台主界面，首先要 添加库

添加库，这个 /data 是容器内的目录，对应了我们前面映射的目录 /docker/komga/data

老苏就建了一个库，所以指向了 /data 根目录，如果你有多个库，可以在 /data 建子目录，然后分别授权

这个时候因为 /data 还是空的，所以会显示

将图书放到 /data 目录中即可，系统会自动刷新

点开一本

进入阅读，速度很快，比老苏之前介绍的 Comics-Reader 起码在速度上快得多，主要因为两者在实现方法上不同。

相关阅读：用Comics-Reader收藏阅读小人书

有阅读进度，能快速切换同目录的其他图书

可以编辑图书信息

接口

Komga 支持 OPDS 协议，并提供了 REST API 接口

OPDS

OPDS 协议 路径：

自建：http://群晖IP:3080/opds/v1.2/catalog
公网：https://demo.komga.org/opds/v1.2/catalog

用 静读天下 做了测试，支持下载阅读（可能官方测试的测试数据是基于免费版的，所以结论是不支持下载）

REST API (RESTful API)

REST API 接口 路径：http://群晖IP:3080/swagger-ui.html，如果您动手能力强，可以自己撸一个移动端

REST API

OPDS

小结

Calibre有一套自己的文件组织规则，脱离了网页或者客户端，你很难找到你要的内容，而 Komga 就不同了，采用了我们日常资源管理器的文件管理习惯，老苏更喜欢 Komga 的文件组织方式。
采用多库管理，这样的好处是可以更精细的管理用户的权限。
因为定期扫描，所以内存消耗略高，看官方文档这个需要创建一个 application.yml，通过配置项来更改，具体的实现请自行研究。

支持 OPDS 协议，使得除了官方的 Tachiyomi（https://tachiyomi.org/），还可以用第三方的阅读器。

参考文档

gotson/komga: Media server for comics/mangas/BDs with API and OPDS support
地址：https://github.com/gotson/komga

What is Komga? | Komga
地址：https://komga.org/guides/#what-media-and-devices-work

Install with Docker | Komga
地址：https://komga.org/installation/docker.html#version-tags