zyao89/aria2-with-webui

Aria2 集成 AriaNg 前端镜像

该Docker镜像集成了开源下载工具https://github.com/aria2/aria2和https://github.com/mayswind/AriaNg前端界面，提供高效的多协议文件下载管理能力。

镜像概述

本镜像将Aria2的后台服务与AriaNg的可视化前端结合，支持通过Web界面轻松管理下载任务，同时提供灵活的配置选项（如密钥认证、SSL加密等），满足不同场景下的下载需求。

核心功能

1. 支持HTTP、FTP、BT、磁力链接等多种协议下载
2. 提供直观的AriaNg WebUI，方便远程管理下载任务
3. 可配置RPC密钥认证，增强访问安全性
4. 支持SSL/TLS加密传输，保护数据安全
5. 支持自定义用户ID/组ID，确保文件权限正确
6. 支持数据持久化存储，保留下载历史与配置

使用场景

• 个人用户远程管理文件下载任务
• 团队内部共享下载服务，统一管理资源获取
• 需要高效多协议下载的场景（如大文件、批量下载）

配置说明

环境变量

• PGID/PUID: 设置运行容器的用户组ID/用户ID（默认1000）
• SECRET: 设置Aria2 RPC密钥，增强访问安全性
• SECURE: 是否启用SSL/TLS加密（true/false）
• CERTIFICATE/PRIVATEKEY: SSL证书与私钥路径（需挂载对应文件）
• LOGPATH: 日志文件路径
• SEEDRATIO/SEEDTIME: BT种子分享率与分享时间限制

卷挂载

• /data: 持久化存储下载文件与配置（建议挂载）
• /conf: 挂载自定义Aria2配置文件（可选）

快速部署

shell
docker run -d --name aria2-webui \
-p 80:80 -p 6800:6800 \
docker.xuanyuan.run/zyao89/aria2-with-webui

启动后可通过http://<主机IP>访问AriaNg前端，Aria2 RPC服务监听6800端口。

高级配置

shell
docker run -d --name aria2-webui \
-p 80:80 -p 6800:6800 \
-e PGID=1000 \
-e PUID=1000 \
-e SECRET=your_password \
-e SECURE=true \
-e CERTIFICATE=/server/path/to/your_cert \
-e PRIVATEKEY=/server/path/to/your_key \
-e LOGPATH=/logs.log \
-v /path/to/persist/data:/data \
docker.xuanyuan.run/zyao89/aria2-with-webui

通过设置SECRET启用密钥认证，SECURE开启SSL加密，并挂载数据卷保存下载文件。

Docker Compose部署

yaml
version: "3"

services:
  aria2:
    container_name: aria2
    image: docker.xuanyuan.run/zyao89/aria2-with-webui
    restart: always
    ports:
      - "6800:6800"
      - "80:80"
    environment:
      - PGID=${PGID:-1000}
      - PUID=${PUID:-1000}
      - SECRET=your_password
      - SEEDRATIO=2
      - SEEDTIME=0
      - SECURE=true
      - CERTIFICATE=/server/path/to/your_cert
      - PRIVATEKEY=/server/path/to/your_key
      - LOGPATH=/logs.log
    volumes:
      - /path/to/persist/data:/data

使用Compose配置可更方便地管理容器，支持自动重启与环境变量自定义。

致谢

本镜像基于https://hub.docker.com/r/onisuly/aria2-with-webui/镜像开发。