前言
在数字阅读日益普及的今天，越来越多的人选择将漫画、杂志和电子书收藏在本地硬盘中。然而，随着收藏的不断扩大，如何高效地管理这些资源、并在不同设备上随时随地阅读，成为了许多读者关心的问题。Komga 就是在这种需求下诞生的一款开源自建漫画服务器。它不仅能够帮助用户对庞大的漫画库进行分类、整理和元数据管理，还提供了友好的 Web 界面与多用户支持，让漫画阅读体验更加轻松便捷。
1. 项目
Komga 是一款开源的漫画与电子书媒体服务器，主要面向漫画、杂志、轻小说、图像小说等数字阅读内容的收藏与管理。项目由社区驱动开发，采用 MIT 开源许可协议，任何人都可以自由使用与二次开发。
1.1 项目特点
跨平台支持
- 采用 Java/Kotlin 开发，可运行在 Windows、Linux、macOS 等主流系统上。
- 支持 Docker 部署，方便快速上手和维护。
直观的 Web 界面
- 自带响应式 Web UI，支持电脑、平板和手机浏览器访问。
- 提供系列、合集、阅读列表等多种展示方式。
强大的阅读体验
- 支持分页预览、阅读进度保存、自动书签等功能。
- 与 KOReader、Kobo 等阅读器同步，支持 OPDS v1/v2 协议。
灵活的元数据管理
- 自动导入漫画文件内嵌的元数据。
- 支持手动编辑标题、作者、出版社、标签等信息。
高效的资源管理
- 提供重复检测功能（文件和页面级别）。
- 支持批量下载系列、合集和单本漫画。
多用户与权限控制
- 可以创建多个用户，分配不同的资料库访问权限。
- 提供年龄分级和标签限制，保障阅读安全。
开放的 API 支持
- 提供 REST API，方便与其他应用或自动化工具集成。
- 适合二次开发和个性化扩展。
1.2 项目展示
2.相关地址
gitHub开源项目：https://github.com/gotson/komga
3.搭建环境
- 服务器：这里为了方便搭建项目使用的是莱卡云的境外香港云服务器。(国内用户连接建议使用国内的服务器(需备案域名或者IP+端口)延迟会更低)
- 莱卡云服务器促销活动性价比会更高。查看官网购买链接：https://www.lcayun.com
- 资源配置：2核2G 30G硬盘
由于国内服务器访问海外源较慢，这边为了方便演示直接使用海外服务器搭建。 - 服务器系统：Debian-12
- 【必需】安装Docker：安装好 Docker、Docker-compose
- 【非必需】域名一枚，可用于解析到服务器上使用域名访问
4.搭建视频
哔哩哔哩：https://www.bilibili.com/video/BV1junqzeEfK/
5.搭建方式
5.1 安装docker和docker-compose
安装教程：服务器上安装docker和docker-compose教程
5.2 创建docker文件
#在opt目录下创建Komga文件夹
mkdir /opt/Komga#打开Komga文件
cd /opt/Komga所有后续文件、数据卷都放在这个目录里。
#编辑docker-compose.yml文件
vi docker-compose.yml5.3 安装Komga镜像
services:
komga:
image: gotson/komga # 使用官方 Komga 镜像
container_name: komga # 设置容器名称为 komga，方便管理
environment:
- TZ=Asia/Shanghai # 设置容器时区为上海（保证日志和时间显示正确）
volumes:
- type: bind
source: ./config # 宿主机目录 ./config，保存 Komga 的配置文件、数据库等持久化数据
target: /config # 容器内的配置目录
- type: bind
source: ./data # 宿主机目录 ./data，用于存放漫画、电子书资源
target: /data # 容器内的数据目录
ports:
- 25600:25600 # 将宿主机的 25600 端口映射到容器的 25600 端口
# 访问方式：http://<宿主机IP>:25600
# 外部端口可修改为其他端口避免冲突
user: "0:0" # 指定容器运行的用户 (UID:GID)，此处为 root:root
# 建议改为宿主机的普通用户 UID:GID，提升安全性
restart: always # 设置容器自动重启策略：
# - always：无论任何情况容器退出都会重启
# - unless-stopped：手动停止除外，推荐用于生产环境填完按esc键 输入 :wq 保存退出
5.4 运行Komga的docker镜像
我们先启动docker
# 启动docker
docker compose up -d
# 重启docker
docker compose stop
docker compose start
# 升级docker
docker compose down
docker compose pull
docker compose up -d5.5 访问 Komga
部署完成后，在浏览器输入：
http://<你的服务器IP>:25600下方可以修改语言，自行创建一个用户帐户
官方安装文档：https://komga.org/docs/category/installation
6. 结尾
Komga 作为一款开源、跨平台的漫画媒体服务器，为用户提供了一个功能完善、体验友好的解决方案。无论是个人独享，还是与家人朋友共享书库，Komga 都能带来更便捷的阅读体验。
