onisuly/aria2-with-webui

集成AriaNg前端的Aria2 Docker镜像

镜像概述和主要用途

该Docker镜像包含https://github.com/aria2/aria2下载工具及其https://github.com/mayswind/AriaNg Web前端，提供一站式下载管理解决方案。通过Web界面可直观监控和控制下载任务，支持多种协议（HTTP/HTTPS、FTP、BitTorrent等），适合个人或家庭环境搭建轻量级下载服务器。

核心功能和特性

• 集成aria2后端与AriaNg前端，无需额外配置即可使用
• 支持RPC密码保护，增强安全性
• 可启用SSL/TLS加密传输
• 自定义文件分配方式（none、prealloc、trunc或falloc）
• 支持IPv6网络
• 可通过环境变量灵活配置参数
• 数据持久化存储

使用场景和适用范围

• 个人下载服务器搭建
• 家庭媒体中心的下载管理
• 需要Web界面监控下载进度的场景
• 对下载安全性有要求的环境

详细使用方法和配置说明

快速启动

通过以下命令快速部署，默认Web界面端口80，aria2 RPC端口6800：

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

高级配置

可通过环境变量和卷挂载进行自定义配置：

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 \
-v /path/to/persist/data:/data \
docker.xuanyuan.run/onisuly/aria2-with-webui

环境变量说明

卷挂载说明

• /data：用于持久化存储下载文件和配置数据，建议挂载本地目录

自定义配置文件

如需使用自定义aria2配置文件，需将/conf目录挂载到卷：

shell
-v /path/to/your/conf:/conf

Docker Compose配置

推荐使用Docker Compose进行部署，便于管理：

yaml
version: "3"

services:
  aria2:
    container_name: aria2
    image: docker.xuanyuan.run/onisuly/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
      - FILE_ALLOCATION=falloc
      - IPV6=true
    volumes:
      - /path/to/persist/data:/data

致谢

该Docker镜像基于https://hub.docker.com/r/abcminiuser/docker-aria2-with-webui/和https://hub.docker.com/r/xujinkai/aria2-with-webui/的镜像开发。