替代Komga的新选择｜Docker部署Smanga漫画浏览器｜自建流媒体漫画阅读器与漫画库管理教程

一句话描述：Smanga 是一款基于 Docker 部署的漫画流媒体阅读工具，灵感来源于 Emby 与 Plex。它旨在解决传统漫画阅读中的痛点：格式复杂、阅读体验割裂、资源管理混乱。通过 Smanga，您可以像管理影视库一样，优雅地管理和浏览海量漫画资源。

为什么选择 Smanga？

在日常阅读漫画时，你是否遇到过这些问题？

📦 格式繁杂：图片、压缩包、PDF 到处都是，解压后的文件不好管理，占用大量空间；
📑 进度丢失：单本漫画动辄上百页，经常忘记上次看到哪里；
🖼️ 阅读体验差：传统阅读器难以适配条漫，图片加载断裂、浏览不流畅；
🎬 缺少流媒体体验：想像 Emby 一样拥有漂亮的漫画墙，却没有合适的工具；
⚙️ 部署复杂：现有的管理软件（如 Calibre-Web）安装步骤繁琐，不够友好。

Smanga 诞生的初衷：让漫画阅读像电影流媒体一样流畅、美观、易管理。

核心功能亮点

💾 多格式支持：支持 zip / cbz / cbr / 7z / rar / pdf 等常见漫画压缩文件；
📚 媒体库管理：自动扫描目录、生成封面墙，快速检索和分类漫画；
📖 多种阅读模式：支持 条漫模式（瀑布流）、翻页模式、双页模式；
🏷️ 书签与历史：随时记录阅读进度，方便继续阅读；
📱 跨平台适配：支持 PC、手机、平板多端访问，响应式设计体验流畅；
⚡ 高效数据库支持：引入 MySQL，提升扫描和检索效率，资源占用更低；
🔑 权限与用户管理：多用户支持，更适合家庭或多人使用；
🎨 流媒体封面墙：自动提取漫画封面，打造精美的视觉体验。

使用场景推荐

漫画收集者：无需手动解压、整理，通过 Smanga 一键导入，即可轻松浏览管理。
家庭共读体验：搭建私家漫画服务器，与家人共享漫画收藏，无广告、安全私密。
自建媒体网红：将漫画库与博客、社交平台结合，打造内容生态新形式。

自建内容生态：结合博客或社交平台，打造漫画内容分发与分享的新模式。

部署教程（飞牛NAS示例）

以下以 飞牛NAS 为例进行演示（其它NAS系统请先安装好 Docker 与 Docker Compose）。

1. 打开 SSH 并切换 root

开启飞牛的 SSH 功能，通过终端软件连接 NAS，并切换到 root 状态。

2. 创建项目目录

点击docker文件夹>右键>详细信息>常规>复制原始路径（演示将所有项目都放在了docker文件夹）：

进入docker文件夹：

# 将 /vol1/1000/docker 换成你自己的实际文件夹

cd /vol1/1000/docker

创建项目文件夹及子目录：
```
mkdir -p smanga/{data,compress,file}
```
进入项目目录：
```
cd smanga
```

3. 编辑 docker-compose.yml

新建并编辑配置文件：
```
vi docker-compose.yml
```

按字母i键进入编辑模式，复制并修改下面的配置文件，粘贴到终端，按Esc键退出编辑模式，输入:wq保存并退出。
（排版太挤的就先粘贴到文本文件内，修改后再使用，灵活应变。）

version: "3"

services:
  smanga:
    image: lkw199711/smanga:alpha   # 使用的镜像，alpha 版本

    container_name: smanga-alpha     # 容器名称，相当于 --name 参数
    hostname: smanga-alpha           # 容器的主机名
    restart: unless-stopped          # 容器自动重启策略（除非手动停止）

    deploy:
      resources:
        limits:                      # 容器的资源限制
          cpus: '0.5'                # 限制最多使用 0.5 个 CPU 核心
          memory: 1G                 # 限制最大内存 1GB
        reservations:                # 预留的最小资源
          memory: 16M                # 至少保证 16MB 内存

    ports:
      - 9798:80                      # 映射容器内的 Web 管理界面端口 80 到宿主机的 9798，左侧的 9798 端口可自行更改。
      # - 3306:3306                  # 可选：MySQL 数据库端口，方便外部工具访问

    volumes:
      - ./data:/data                 # 挂载整合目录（包含 compress、config、poster、mysql），与单独映射方式二选一。【可将 ./data 换成完整文件夹路径】
      - ./compress:/compress         # 压缩文件解压目录（挂大容量硬盘，存放 zip/cbz 解压后的漫画）。【可将 ./compress 换成完整文件夹路径】
      - ./file:/file                 # 存放自己的漫画文件目录。【可将./file换成完整文件夹路径】

    environment:
      PUID: 1000                     # 宿主机用户的 UID（运行容器时的用户身份）
      PGID: 1000                     # 宿主机用户的 GID（运行容器时的用户组身份）
      UMASK: 0022                    # 新建文件的权限掩码（默认 755/644）
      TZ: Asia/Shanghai              # 时区设定为上海

4. 授权目录权限

查看当前项目文件夹路径
```
pwd
```
授权该项目文件夹内的读写权限【部分NAS系统需要（如群晖），否则容器无读写权限访问运行，按需执行。】：
```
# 将 /vol1/1000/docker/smanga/ 换成你实际的文件夹路径

chmod -R 777 /vol1/1000/docker/smanga/
```

5. 启动容器

运行以下命令启动：

docker compose up -d

或

docker-compose up -d

查看运行状态：

docker compose ps

或

docker-compose ps

查看容器运行日志，按Ctrl+C中断查看。

docker compose logs -f

或

docker-compose logs -f

6. 上传漫画文件

进入 NAS 内项目文件夹的 file 文件夹，可以按分类建立子目录，然后上传漫画文件。

7. 访问 Smanga

打开浏览器，以NAS的IP+设置的端口号进行访问。
以本机为例：http://192.168.3.240:9798
我们只需要使用它即可，不需要那么复杂的再设置数据库，就直接用默认的。
点击下一步
如果你不想创建新账户，只使用默认的，那么可以直接点击下一步。
初始化完成，等待自动进入或者点击下一步。
使用你设置的或者默认的账户进行登录
初始化向导：

进入后台后，点击 资源管理 → 媒体库管理 → 新增媒体库，设置名称（等于是分类/自定义文件夹），然后下拉到底部点击确定。
点击新创建的媒体库的路径
在新增路径中输入你创建的漫画分类文件夹路径，然后点击旁边的+号，启用自动扫描，然后点击确定。
点击用户设置--服务器设置，勾选自动解压后点击确定。
回到首页的媒体库点击进去即可显示（演示中未显示封面的资源看下一段说明）
随便点击一个进去看看效果

问题说明

在当前版本测试中，发现以下问题：

扫描文件功能不稳定：点击后可能无效，需要手动重启容器才能重新扫描。
部分格式显示异常：如 epub、mobi、azw3、pdf 等，有时不显示封面，需等待优化。
压缩包格式：部分 zip/cbz 文件需要时间解压才能识别。
由于我这边平常不关注漫画，所以没有漫画资源，在编写教程时是随意下载的几个格式的文件，实际部署时客户自行准备的资源是全部识别的。
项目说明中有一段描述是这么说的：
由于开发时间仓促，本产品有着很多缺点，请在使用时注意。
测试工作未能完善，如有bug请提交issues或加群反馈。谢谢！
虽然为条漫开发, 但是并不支持长图条漫(需裁切)
我们使用的是web浏览器，每一条http请求受限于网络原因，是有容量限制的，大家在网上拿资源，经常会拿到长图条漫，也就是整图。1w px的长度，这样的图片容量5m起步，浏览器是不能够正常加载的。
我（作者）当时测试的情况是，内网可以用，外网看不了。

后续建议作者在项目中补充 格式支持说明 并优化扫描逻辑。

文末

👇👇👇