Mango 自托管漫画服务器和网页阅读器使用教程

Mango 自托管漫画服务器和网页阅读器使用教程

Mango 项目地址: https://gitcode.com/gh_mirrors/mango23/Mango

1. 项目介绍

Mango 是一个自托管的漫画服务器和网页阅读器，它支持多用户使用，支持 OPDS 协议，并且拥有夜间模式切换功能。Mango 支持多种漫画格式，包括 .cbz、.zip、.cbr 和 .rar。此外，它还支持文件夹嵌套、自动保存阅读进度、生成缩略图，并且可以通过插件从第三方网站下载内容。Mango 的网页阅读器具有响应式设计，适用于移动设备，因此无需单独的移动应用。

2. 项目快速启动

环境准备

确保您的系统中已安装以下软件：

• Docker
• docker-compose

使用 Docker 启动

1. 克隆仓库：

   git clone https://github.com/hkalexling/Mango.git
   cd Mango
   

2. 将 env.example 文件复制为 .env 并填写相应的值：

   cp env.example .env
   

3. 运行 docker-compose：

   docker-compose up
   

4. 启动后，通过浏览器访问 localhost:9000 进行登录。

从源代码构建

1. 确保已安装 Crystal、Shards 和 Yarn，并安装必要的开发库。

2. 克隆仓库：

   git clone https://github.com/hkalexling/Mango.git
   cd Mango
   

3. 构建并安装：

   make && sudo make install
   

4. 启动 Mango：

   mango
   

5. 通过浏览器访问 localhost:9000 进行登录。

3. 应用案例和最佳实践

漫画管理

• 将漫画文件放入库目录，Mango 会自动识别和添加。
• 使用嵌套文件夹来组织漫画，例如按标题或卷号分类。

用户管理

• 通过网页界面添加和管理用户。
• 启用或禁用登录，可以设置默认用户，方便访问。

插件使用

• 添加插件以从第三方网站下载漫画。
• 定期更新插件以保持功能最新。

4. 典型生态项目

• MangaDex: 一个流行的漫画数据库和阅读器，支持多种语言。
• ComiXology: 一个亚马逊旗下的数字漫画平台。
• MyReadingManga: 另一个自托管的漫画服务器和阅读器。

以上是 Mango 的基本使用教程，希望对您有所帮助。更多详细配置和高级使用，请参考项目官方文档。

Mango 项目地址: https://gitcode.com/gh_mirrors/mango23/Mango