Smanga流媒体漫画阅读器完整使用指南

Smanga是一款简单易用的Docker直装漫画流媒体阅读工具，灵感来源于emby和plex等流媒体平台，专门为解决漫画阅读需求而开发。

产品简介

Smanga是一个开源漫画流媒体阅读平台，旨在为用户提供类似Netflix的漫画管理和阅读体验。无论您是漫画收藏家还是普通读者，Smanga都能为您提供专业的漫画管理解决方案。

核心功能特性

多种格式支持

Smanga支持多种漫画文件格式：

• 压缩格式：ZIP、CBZ、CBR、RAR、7Z
• 文档格式：PDF（部分版本支持）
• 图片格式：JPG、PNG、WEBP等常见图片格式

智能媒体库管理

Smanga提供智能媒体库管理系统，支持自动分类和封面生成功能，让您的漫画资源井井有条。

多样化阅读模式

• 条漫模式：专为手机条漫画优化设计
• 翻页模式：传统书籍阅读体验
• 双页模式：完美显示双页漫画内容
• 自适应布局：自动适配手机、平板、PC等各种设备

智能阅读管理

• 自动记录最后阅读位置
• 完整的阅读历史时间线
• 个人书签和收藏列表管理

安装部署指南

Docker快速部署

使用Docker是部署Smanga最简单的方式：

docker run -itd --name smanga \
-p 9797:9797 \
-v /your/comics:/mnt \
-v /your/smanga-data:/data \
lkw199711/smanga-nodejs

Windows版本使用

对于Windows用户，可以直接下载可执行文件版本：

1. 访问发布页面下载最新版本
2. 解压文件即可使用
3. 数据迁移：将旧版本的data目录复制到新版本目录下

Docker Compose专业部署

创建docker-compose.yml文件进行更专业的部署：

version: "3"
services:
  smanga:
    image: lkw199711/smanga-nodejs
    ports:
      - "9797:9797"
    volumes:
      - ./data:/data
      - /path/to/comics:/mnt
    restart: unless-stopped

数据目录结构说明

Smanga使用以下目录结构来管理数据：

bookmark    # 书签封面存储目录
cache       # 封面压缩缓存目录
compress    # 压缩包解压目录
config      # 配置文件目录
db          # 数据库目录(sqlite)
file        # apk等文件存放目录
logs        # nginx等服务日志目录
poster      # 媒体库、漫画、章节封面存放目录

使用教程

初始设置

默认用户名和密码均为：smanga

首次登录后需要进行媒体库配置：

1. 进入"媒体库管理" -> "新增媒体库"
2. 选择媒体类型：普通（漫画目录=>章节目录=>图片）或单本（漫画目录=>图片）
3. 添加媒体路径，支持多条路径添加
4. 系统开始自动扫描漫画资源

阅读界面操作

Smanga采用最大化屏幕利用的设计理念：

• 点击屏幕靠上30%区域呼出控制栏
• 右侧添加书签按钮方便记录阅读进度
• 顶栏提供浏览模式切换功能

书签管理

在阅读过程中，可以通过顶栏的书签功能记录特定页面，之后在书签管理界面可以查看和管理所有书签。

性能优化建议

存储配置优化

• 为compress目录单独挂载大容量硬盘
• 设置合理的自动扫描时间间隔
• 启用图片缓存功能加速加载速度

系统配置

• 推荐内存配置：1GB以上
• CPU配置：0.5核以上
• 网络带宽：建议100Mbps以上以获得最佳体验

故障排除

常见问题解决

1. 服务无法启动：检查端口9797是否被占用
2. 漫画扫描失败：确认文件权限设置正确
3. 图片加载缓慢：优化网络配置或启用缓存功能

日志查看方法

docker logs smanga

正常启动时会显示：

Server is running on port 9797
[时间] INFO: started HTTP server on 0.0.0.0:9798

版本更新轨迹

Smanga持续进行功能更新和性能优化：

• v3.0：引入数据库支持，性能大幅提升
• v3.5：自动封面提取和缓存优化
• v3.7：Windows版本发布，使用更便捷
• 后续版本持续优化阅读体验和系统稳定性

使用技巧和建议

最佳实践

1. 按年份或类型创建多个媒体库进行分类管理
2. 定期清理compress缓存目录释放存储空间
3. 充分利用书签功能管理阅读进度
4. 根据不同设备选择合适的阅读模式

性能数据

根据用户实际使用反馈：

• 支持管理10万+漫画文件
• 平均扫描速度：1000文件/分钟
• 典型配置内存占用：<512MB

技术特点

• 完全开源：基于MIT许可证，代码完全开放
• 跨平台支持：支持Docker部署和Windows原生运行
• 高度可定制：支持多种配置选项和主题设置
• 响应式设计：完美适配各种屏幕尺寸和设备类型

结语

Smanga不仅仅是一个漫画阅读器，它是一个完整的漫画流媒体解决方案。无论您是拥有大量漫画资源的收藏家，还是希望获得更好阅读体验的普通用户，Smanga都能满足您的需求。

其强大的功能、简洁的界面和持续的更新维护，使其成为当前最优秀的漫画流媒体平台之一。立即尝试Smanga，开启全新的漫画阅读体验！

官方文档：docs/official.md
最新版本：查看发布页面获取最新版本

提示：遇到问题时，建议先查看常见问题解答文档或加入用户社区讨论获取帮助。