zyao89/aria2-with-webui

Aria2 集成 AriaNg 前端镜像

该Docker镜像集成了开源下载工具https://github.com/aria2/aria2%E5%92%8Chttps://github.com/mayswind/AriaNg%E5%89%8D%E7%AB%AF%E7%95%8C%E9%9D%A2%EF%BC%8C%E6%8F%90%E4%BE%9B%E9%AB%98%E6%95%88%E7%9A%84%E5%A4%9A%E5%8D%8F%E8%AE%AE%E6%96%87%E4%BB%B6%E4%B8%8B%E8%BD%BD%E7%AE%A1%E7%90%86%E8%83%BD%E5%8A%9B%E3%80%82

镜像概述

本镜像将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 \
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 \
zyao89/aria2-with-webui

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

Docker Compose部署

yaml
version: "3"

services:
  aria2:
    container_name: aria2
    image: 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/%E9%95%9C%E5%83%8F%E5%BC%80%E5%8F%91%E3%80%82