VanManga - 漫画抓取应用

VanManga 是一款轻量化的，功能丰富的漫画抓取应用。该应用可以抓取、管理漫画资源，以此为漫画阅读、资源备份等提供服务。

Readme - English Version

VanManga有什么功能？

1. 🔍 漫画搜索 - 通过在搜索框中输入漫画名称，你可以获取前十个最相关的搜索结果，并选择你喜欢的漫画进行下载。
2. ⚠️ 漫画管理 - 为保证本地资源精简不重复，应用会在提交下载任务时自动检查已下载漫画中是否有相似资源，并返回结果以供用户参考。
3. 📋 下载队列 - 漫画会根据下载任务提交顺序进入队列等待，并依序下载。
4. 🔄 每日自动更新 - 应用会每日定时扫描所有已下载漫画，检查并自动下载最新的更新内容。
5. 🖥️ 下载管理面板 - 在管理面板中，你可以检视所有的已下载资源。并且可以通过WebSocket返回的信息实时跟踪当前下载任务的进度和漫画下载状态。
6. 🗃️ 重新打包漫画文件 - 有外部资源？抑或是本地资源文件结构有问题？没关系，可以使用本地重新打包功能对资源文件夹下的所有漫画文件进行重新打包。
7. 🔧 重新下载指定内容 - 想要对下载可能失败的单章漫画进行修复？没问题，使用单章重新下载的功能你可以自由的选择任意漫画的任何章节进行重下。
8. 也许在未来我们会添加更多新功能！

如何安装？

目前，本应用可以通过 Docker Hub 上的打包镜像来进行本地部署。同时，你也可以自定义本地 VanManga 的 HTTP 服务端口。

1. 请确保你的系统中已经安装了Docker。在 Windows 和 MacOS 系统下，我们推荐安装Docker Desktop的 GUI 界面来更轻松的进行部署。如果你正在使用 Linux 系统，请使用命令行来完成部署。
2. 安装 Docker 后，请使用如下命令来从 Docker Hub 获取最新版本的 VanManga 镜像：

   docker pull wzl778633/vanislord_manga:latest
   

3. 为了确保你的 Docker 容器可以正常运行，请按照如下介绍设置 环境变量 \ 文件路径映射 \ 端口:
   • 环境变量

     PYTHONUNBUFFERED: 用于使 Docker container 可以输出应用的日志记录，默认值是 1
     MANGA_BASE_URL: 你用于连接后端的 URL，默认值是 http://localhost:5000. 如果你正在你的 Docker 中使用 bridge，你需要把'localhost'改成你的 bridge 的内部 IP。
     MANGA_BASE_WEBSOCKET_URL: 你对外暴露的服务器 URL, 主要用于 WebSocket 服务, 默认值是 http://localhost:5000.

   • 文件路径映射

     { 你的主机上想要设置为漫画下载库的物理地址 } <==> /downloaded
     { 你的主机上想要设置为漫画 config 文件夹的物理地址 } <==> /vanmanga/eng_config

   • 端口

     5000:5000 /_ 你也可以映射任何你想映射的端口 _/ 你可以直接复制并使用如下命令，或者在 Docker Desktop 的 GUI 中直接设置相关参数:

   docker run --name /*你的容器名称*/ \
   -e PYTHONUNBUFFERED=1 \
   -e MANGA_BASE_URL=http://localhost:5000  \
   -e MANGA_BASE_WEBSOCKET_URL=http://localhost:5000  \
   --mount type=bind,source=/*你的主机上想要设置为漫画下载库的物理地址*/,target=/downloaded \
   --mount type=bind,source=/*你的主机上想要设置为漫画config文件夹的物理地址*/,target=/vanmanga/eng_config \
   -p 5000:5000
   wzl778633/vanislord_manga:latest
   

4. 当容器开始运行后，服务器会自动进行初始化。你可以在 Docker container 的日志记录中查看服务器初始化的状态。
   • 初始化的目的在于，扫描 config 文件夹下的manga_library.json，将所有的已经存在的漫画记录都添加到服务器中，同时检查每部漫画是否有更新。

如何使用？

1. 搜索漫画
   目前我们使用DogeManga来作为漫画源。
   在搜索框中输入想搜索的漫画名称，它会返回前十个最相关的结果。请注意： 我们会在用户提交下载任务时自动检查已存在资源中是否有可能的类似漫画，如果存在，我们会返回相关信息方便用户确认。
   
   

2. 下载漫画
   从搜索结果中选择希望下载的对象，并提交下载任务。目前，应用会下载目标漫画下可下载的所有内容(包括但不限于：单行本、连载章节、番外、特殊内容等)。
   

3. 漫画库管理界面
   你下载的所有漫画都可以在此仪表板中找到。你可以查看每部漫画的当前状态（例如：下载中/排队中/已完成...）。目前，仪表板仅显示了你已下载的每部漫画的最新章节名称，以便你跟踪每部漫画的状态。

4. 重新下载
   对于每一部漫画，如果在阅读过程中发现任何（包括但不限于：单行本、连载章节、番外）内容出现错误，您可以简单地请求重新下载该特定（包括但不限于：单行本、连载章节、番外）的内容。

5. 阅读漫画
   目前，本应用的文件结构主要支持Kavita。我们也强烈建议你使用 Kavita 来作为漫画库服务器。您可以通过其 Web 界面轻松管理您的漫画文件，并使用其阅读器进行阅读。它同样支持在 IOS 设备上使用Paperback以及在 Android 设备上使用Mihon进行阅读。下面是一些有关服务器部署及设置的相关链接：

   • Kavita: https://wiki.kavitareader.com/
   • Paperback: https://wiki.kavitareader.com/guides/3rdparty/paperback
   • Mihon: https://wiki.kavitareader.com/guides/3rdparty/tachi-like

   当然，如果你喜欢使用除 Kavita 外的其他的漫画服务器，请随意使用～

Demo

当前上线的版本为私人社群服务版本，不公开展示，非常抱歉。

贡献

贡献者

目前，有两位主要贡献者在为这个项目开发。 Tom "Van" Wang & Kun "Alen" Qi

我们非常欢迎你对我们的项目做出任何贡献～

License

MIT