配置指南

本页面详细说明了如何配置 Web-DL-Manager，您可以通过 Web UI 进行大部分配置，也可以通过环境变量在部署时进行设置。

💻 Web UI 配置

系统启动后，您可以访问 http://<您的IP>:5492 登录管理界面，进入"设置"页面进行详细配置。

1. 系统设置

登录域名：用于登录页面的自定义域名。
头像 URL：登录界面和侧边栏显示的头像链接。
隐私模式：启用后将执行更严格的身份验证与访问控制。
调试模式：启用详细日志记录和错误调试信息，用于排查问题。
GitHub 令牌：可选。配置后可避免检查更新时触发 GitHub API 速率限制。
启用网页终端：允许管理员直接在浏览器中访问服务器 Shell（高风险功能，请谨慎开启）。
Cloudflared 令牌：用于通过 Cloudflare Tunnel 将本地服务发布到公网。

2. MEGA 设置

MEGA 邮箱
MEGA 密码
MEGA 两步验证码：如果启用了两步验证，请输入验证码。

3. 上传服务配置

支持多种云存储上传，需根据所选服务填写对应凭证。

WebDAV：URL、用户名、密码。
S3 兼容：提供商（如 AWS）、访问密钥 ID、秘密访问密钥、区域、端点 URL。
Backblaze B2：账户 ID 或应用程序密钥 ID、应用程序密钥。
gofile.io：API 令牌、文件夹 ID。

4. 备份与同步

Rclone 配置 (Base64)：用于备份本地配置到云端。
备份远程路径：备份的目标远程路径。

5. 定时同步任务管理 (Rclone)

配置 Rclone 任务以实现文件自动同步。

6. 登录验证 (Captcha)

为了增强登录安全性，您可以配置验证码。

验证方式：无、本地算术验证、极验 (GeeTest)、Google reCAPTCHA v2、Cloudflare Turnstile。
根据选择的验证方式，需要填写 站点密钥 (Site Key)、通信密钥 (Secret Key)、极验 CAPTCHA ID 等。

环境变量配置

除了 Web UI，许多核心设置也可以通过环境变量进行配置，特别是在 Docker 部署时。详细列表请参考环境变量页面。

常用环境变量快速参考：

变量	说明	默认值
`APP_USERNAME`	初始管理员用户名	`Jyf0214`
`APP_PASSWORD`	初始管理员密码	(空)
`DATABASE_URL`	数据库连接字符串	`sqlite:////data/webdl-manager.db`
`DEBUG_MODE`	调试模式	`false`
`TUNNEL_TOKEN`	Cloudflare Tunnel 令牌	(未设置)
`REDIS_URL`	Redis 连接字符串	(未设置)

更多环境变量请查看完整列表。

🔄 清理与维护

在"设置"页面底部，您可以找到系统清理与维护功能：

清理系统缓存：手动清理配置、用户和任务状态的内存缓存。
清理数据库：清理当前版本应用程序不再使用的废弃表和配置项。此操作是安全的，有助于保持数据库整洁。

📊 Gallery-dl 配置

Gallery-dl 是一个功能强大的下载工具，支持数百个图片和视频站点。

基础配置

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

常见站点配置示例

json

{
  "extractor": {
    "pixiv": {
      "username": "your_email@example.com",
      "password": "your_password"
    },
    "twitter": {
      "username": "your_username",
      "password": "your_password"
    }
  }
}

详见 Gallery-dl 官方文档。

⚠️ 重要提示

密码安全：请务必设置强密码。
终端功能：网页终端提供了对服务器 Shell 的直接访问权限。请仅在您完全了解风险的情况下开启此功能。
数据备份：定期备份您的 /data 目录以防数据丢失。
法律合规：在配置和使用本工具时，请遵守当地法律法规和目标网站的服务条款。

📢 开源协议

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

协议要点

✅ 自由使用：任何人都可以自由使用、修改和分发本软件。
✅ 源代码公开：修改后的版本必须公开源代码。
✅ 衍生物开源：基于本项目开发的衍生作品必须采用相同许可证。
❌ 商业保证：本软件不提供任何商业保证或担保。
❌ 专利许可：不授予专利许可。

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

配置指南 ​

💻 Web UI 配置 ​

1. 系统设置 ​

2. MEGA 设置 ​

3. 上传服务配置 ​

4. 备份与同步 ​

5. 定时同步任务管理 (Rclone) ​

6. 登录验证 (Captcha) ​

环境变量配置 ​

🔄 清理与维护 ​

📊 Gallery-dl 配置 ​

基础配置 ​

常见站点配置示例 ​

⚠️ 重要提示 ​

📢 开源协议 ​

协议要点 ​