快速开始

欢迎使用 Web-DL-Manager！本指南将帮助您快速了解和上手使用本系统。

什么是 Web-DL-Manager?

Web-DL-Manager 是一款专为私有化部署设计的自动化下载与云端分发管理系统。

核心价值

在资源获取日益碎片化的今天，我们往往需要手动进行"下载 → 压缩 → 上传"的重复性劳动。Web-DL-Manager 的出现旨在将这一流程完全自动化。

省时：一次配置，全程自动执行。
安全：严格的身份验证与权限管理机制。
灵活：支持多种数据库后端和云存储。

技术架构

系统采用 Python (FastAPI) 作为后端核心，结合 Bootstrap 5 提供现代的 Web UI。底层集成 gallery-dl, yt-dlp, kemono-dl, megatools, rclone, zstd 等成熟的开源工具，确保了极高的稳定性和处理效率。

🚀 5 分钟快速开始

第 1 步：启动容器

最简单的方式是使用 Docker 运行：

bash

docker run -d \
  --name web-dl-manager \
  -p 5492:5492 \
  -v ./data:/data \
  -e APP_USERNAME="admin" \
  -e APP_PASSWORD="your_password" \
  ghcr.io/jyf0214/web-dl-manager:main

💡 提示：
-p 5492:5492 映射端口（Web 访问入口）
-v ./data:/data 挂载数据目录（用于存储下载和压缩的文件）
-e APP_USERNAME 和 -e APP_PASSWORD 设置初始管理员账户

第 2 步：访问 Web 界面

容器启动后，打开浏览器访问：

http://localhost:5492

您将看到部署说明页面。点击"管理后台"或直接访问 /login 进行登录。

第 3 步：登录

输入您在启动时设置的用户名和密码：

用户名：admin
密码：your_password

第 4 步：进行首次配置

登录后，前往设置页面进行配置：

系统设置：修改用户头像、启用隐私模式等。
下载工具配置：配置 gallery-dl、MEGA 账户等。
上传服务：配置您的云存储（Google Drive、OneDrive、S3 等）。
备份与同步：配置 Rclone 备份以保护配置数据。

第 5 步：开始下载

返回主页面，点击"新建任务"开始您的第一个下载：

输入下载链接（支持数百个站点）
选择下载工具和配置
配置压缩和上传选项
提交任务

系统会自动处理下载 → 压缩 → 上传的全流程！

📋 核心功能概览

1. 多站点下载支持

通过集成多个下载工具，支持数百个站点：

Gallery-dl：DeviantArt, Pixiv, Twitter, Flickr 等图片站点
yt-dlp：YouTube, Twitch, Bilibili 等视频平台
kemono-dl：Kemono.party 等付费内容站点
megatools：Mega.nz 公开链接下载

2. 智能压缩

使用 Zstandard (zstd) 算法进行超高速压缩
支持自动分卷，适配云存储限制
可配置压缩级别和分卷大小

3. 多云端支持

通过 Rclone 集成，支持上传至：

Google Drive
OneDrive / Sharepoint
AWS S3
阿里云 OSS
企业网盘（WebDAV）
以及 30+ 其他云存储服务

4. 自动备份

配置 Rclone 备份，自动备份系统配置到云端，确保配置数据安全。

5. 任务管理

任务队列管理
实时进度监控
历史记录查看
失败任务重试

🔧 常见配置

配置 Gallery-dl

前往 设置 → Gallery-dl 配置
上传或编辑 gallery-dl 配置文件
配置特定站点的账户和偏好设置

配置 MEGA

前往 设置 → MEGA 设置
输入 MEGA 邮箱和密码
如果启用了两步验证，输入验证码

配置云存储上传

前往 设置 → 上传服务配置，选择您的目标云存储：

WebDAV：输入 URL、用户名、密码
S3 兼容：输入访问密钥等信息
Backblaze B2：输入账户 ID 和密钥
gofile.io：输入 API 令牌

启用配置自动备份

在本地配置 Rclone：rclone config

获取配置的 Base64 编码：

bash

cat ~/.config/rclone/rclone.conf | base64 -w 0

前往 设置 → 备份与同步 → Rclone 配置
粘贴 Base64 编码的配置

📖 更多文档

部署指南：详细的部署方式和配置示例
配置指南：完整的配置选项说明
环境变量配置：所有环境变量的参考

⚠️ 重要提示

法律声明

本工具仅供学习与研究使用。用户在使用本程序下载互联网资源时，需严格遵守当地法律法规以及目标网站的《服务条款》。开发者不对用户因使用本工具而产生的任何版权纠纷、法律后果或数据丢失承担责任。

使用前必读

在使用 Web-DL-Manager 前，请确保：

✅ 您有权访问目标网站和内容
✅ 您了解目标网站的《服务条款》和使用政策
✅ 您的使用行为符合当地法律法规
✅ 您理解下载内容的版权限制

安全建议

🔐 设置强密码
🛡️ 启用隐私模式以限制访问
💾 定期备份 /data 目录
📋 使用 Rclone 自动备份配置

🆘 获取帮助

遇到问题？您可以：

📖 查看配置指南了解更多配置选项
🔍 检查应用日志：docker logs web-dl-manager

📢 开源协议

本项目采用 GNU General Public License v3.0 (GPLv3) 开源协议。

详见 LICENSE 了解完整协议条款。

快速开始 ​

什么是 Web-DL-Manager? ​

核心价值 ​

技术架构 ​

🚀 5 分钟快速开始 ​

第 1 步：启动容器 ​

第 2 步：访问 Web 界面 ​

第 3 步：登录 ​

第 4 步：进行首次配置 ​

第 5 步：开始下载 ​

📋 核心功能概览 ​

1. 多站点下载支持 ​

2. 智能压缩 ​

3. 多云端支持 ​

4. 自动备份 ​

5. 任务管理 ​

🔧 常见配置 ​

配置 Gallery-dl ​

配置 MEGA ​

配置云存储上传 ​

启用配置自动备份 ​

📖 更多文档 ​

⚠️ 重要提示 ​

法律声明 ​

使用前必读 ​

安全建议 ​

🆘 获取帮助 ​

📢 开源协议 ​