lkw199711/smanga

Smanga 漫画流媒体阅读工具

镜像概述

Smanga 是一款以 Emby、Plex 为灵感开发的漫画流媒体阅读工具，旨在解决漫画资源管理分散、格式繁杂、阅读体验不佳等问题。通过 Docker 容器化部署，提供简单易用的漫画管理与阅读解决方案，支持多种漫画格式解析、媒体库管理、阅读进度记录等功能，适配手机、平板、PC 等多设备使用。

核心功能与特性

• 多格式支持：支持 zip、cbz、cbr、7z、rar 等压缩格式漫画，自动解压转换为图片流
• 媒体库管理：支持创建多个媒体库，支持普通（漫画→章节→图片）和单本（漫画→图片）两种目录结构
• 阅读体验优化：提供条漫（瀑布流）、翻页、双页等多种阅读模式，适配不同设备屏幕
• 进度记录：支持书签功能记录阅读进度，历史记录功能追踪浏览轨迹
• 多设备兼容：针对手机、平板、PC 等不同尺寸设备优化界面，提供一致的使用体验
• 高效检索：引入 MySQL 数据库支持，提升漫画扫描与检索效率，降低资源占用

使用场景与适用范围

• 个人漫画收藏管理，解决本地漫画格式混乱、查找困难问题
• PT 保种用户无需解压即可流媒体阅读漫画资源
• 多设备同步阅读进度，随时随地继续阅读
• 构建个人漫画流媒体库，实现漫画资源集中管理与展示

安装与部署

环境要求

• Docker 1.13+
• 至少 1GB 内存
• 存储设备需有足够空间存放漫画资源及解压缓存

新版本（Node.js 版本）部署

Docker 命令部署

bash
docker run -itd --name smanga \
-p 3333:3306 \
-p 9797:9797 \
-v /mnt:/mnt \
-v /path/to/smanga/data:/data \
docker.xuanyuan.run/lkw199711/smanga-nodejs

参数说明：

• -p 3333:3306：MySQL 数据库端口映射
• -p 9797:9797：Web 服务端口（新版本默认端口）
• -v /mnt:/mnt：挂载系统存储目录，用于访问漫画资源
• -v /path/to/smanga/data:/data：数据目录，存储配置、数据库、缓存等（必须映射）

部署验证

启动容器后，通过 docker logs smanga 查看日志，当出现以下信息时表示服务启动成功：

Server is running on port 9797
[16:35:57.537] INFO (188): started HTTP server on 0.0.0.0:9798

旧版本部署（不推荐，不再更新）

Docker 命令部署

整合映射（推荐）：

bash
docker run -itd --name smanga \
-p 3333:3306 \
-p 9797:80 \
-v /mnt:/mnt \
-v /path/to/smanga/data:/data \
docker.xuanyuan.run/lkw199711/smanga

全目录映射：

bash
docker run -itd --name smanga \
-p 3333:3306 \
-p 9797:80 \
-v /mnt:/mnt \
-v /path/to/compress:/compress \
-v /path/to/poster:/poster \
-v /path/to/mysql:/var/lib/mysql \
-v /path/to/config:/config \
docker.xuanyuan.run/lkw199711/smanga

目录说明：

• /compress：解压缓存目录（存放解压后的图片，可单独映射到大容量存储）
• /poster：封面存储目录（提取漫画封面图片）
• /var/lib/mysql：MySQL 数据目录（必须映射以避免数据丢失）
• /config：配置文件目录

Docker Compose 部署

基础配置示例：

yaml
version: "3"
services:
  smanga:
    image: docker.xuanyuan.run/lkw199711/smanga:alpha
    ports:
      - 9798:80
    volumes:
      - /path/to/smanga/data:/data
      - /path/to/compress:/compress
      - /mnt:/mnt
    environment:
      PUID: 1000    # 运行用户 UID
      PGID: 1000    # 运行用户 GID
      UMASK: 022
      TZ: Asia/Shanghai
    restart: unless-stopped
    container_name: smanga-alpha

Macvlan 网络配置示例：

yaml
version: "3"
services:
  smanga:
    image: docker.xuanyuan.run/lkw199711/smanga
    networks:
      macvlan_1:
        ipv4_address: 192.168.2.21  # 分配固定 IP
    ports:
      - 9798:80
    volumes:
      - /path/to/smanga/data:/data
      - /path/to/compress:/compress
      - /mnt:/mnt
    environment:
      PUID: 1000
      PGID: 1000
      UMASK: 022
      TZ: Asia/Shanghai
    restart: unless-stopped
    container_name: smanga

networks:
  macvlan_1:
    external: true
    driver: macvlan

使用方法

初始登录

• 默认用户名：smanga
• 默认密码：smanga

新增媒体库

1. 登录后进入「媒体库管理」→「新增媒体库」
2. 选择媒体类型：
   • 普通：目录结构为「漫画目录→章节目录→图片」
   • 单本：目录结构为「漫画目录→图片」（无章节层级）
3. 选择「文件夹结构」（可选）：可添加二级目录（如按年份分区）
4. 添加媒体路径：点击「添加路径」，输入漫画资源所在目录（需确保容器可访问）
5. 等待扫描完成，点击 Logo 即可进入媒体库列表

阅读操作

• 书签功能：阅读时点击屏幕上 30% 区域呼出顶栏，点击右侧「添加书签」按钮
• 浏览模式切换：通过顶栏模式选择框切换「条漫」「单页」「双页」模式
• 翻页操作：支持鼠标点击、键盘方向键或触屏滑动翻页

界面交互

阅读界面采用极简设计，除图片外元素可隐藏，最大化屏幕利用率。顶部导航栏包含返回、模式切换、书签等功能按钮，底部显示页码信息。

产品局限性

• 不支持长图条漫：需提前裁切长图（单张图片建议控制在 5MB 以内，避免加载问题）
• PDF 支持：新版本暂未支持 PDF 格式
• 资源消耗：解压大量漫画时会占用较多 CPU 和存储资源

版本说明

• 3.7.0+：Node.js 重构版本，支持 EXE 打包，优化性能
• 3.0.0+：引入 MySQL 数据库，支持多格式解压、书签、历史记录功能
• 2.0：支持 PDF 阅读
• 1.0：基础功能版本，支持基本漫画浏览与分页

交流与反馈

• QQ 交流群：534086782
• *** 交流群：[***]
• 版本发布频道：[***]