superng6/aria2

Docker Aria2最佳实践镜像

镜像概述

superng6/aria2是针对Aria2下载工具的Docker化优化镜像，集成AriaNG WebUI，解决传统镜像在权限管理、任务处理、端口开放等痛点，支持x86-64/arm64/armhf多架构，体积仅约10MB，配置灵活，适合NAS、个人服务器场景。

核心功能

• 多平台适配：统一tag支持主流架构；
• 权限控制：设置PUID/PGID避免文件权限问题；
• 吸血客户端屏蔽：a2b版本可拦截迅雷、QQ旋风等吸血工具；
• 智能任务管理：自动删除.aria2文件、回收站、重复任务检测、暂停任务处理；
• 种子优化：磁力转种子并更名、自动备份；
• 性能增强：开放BT/DHT端口、每日更新trackers、解除线程限制；
• 灵活配置：通过环境变量或setting.conf快速调整功能。

使用场景

• NAS下载：搭配SSD临时盘，完成后自动转移到HDD；
• 远程管理：通过WebUI在多设备上控制下载任务；
• 跨平台部署：在不同架构设备上统一使用。

配置说明

挂载路径

• /config：存储配置文件（aria2.conf、setting.conf等）；
• /downloads：下载文件目录。

关键环境变量

setting.conf示例

位于/config/setting.conf，无需重启生效：

remove-task=rmaria  # 删除任务仅删.aria2文件
move-task=false     # 下载完成是否移动文件
content-filter=false # 是否过滤无用文件

部署示例

Docker Run命令

bash
docker run -d \
  --name=aria2 \
  -e PUID=1026 \
  -e PGID=100 \
  -e TZ=Asia/Shanghai \
  -e SECRET=your_token \
  -e CACHE=512M \
  -p 6800:6800 \
  -p 32516:32516/tcp \
  -p 32516:32516/udp \
  -p 8080:8080 \
  -v ./config:/config \
  -v ./downloads:/downloads \
  --restart unless-stopped \
  docker.xuanyuan.run/superng6/aria2:latest

Docker Compose（a2b版本）

yaml
version: "3.1"
services:
  aria2:
    image: superng6/aria2:a2b-latest
    container_name: aria2
    cap_add: [NET_ADMIN]
    environment:
      - PUID=1026
      - PGID=100
      - SECRET=your_token
      - A2B=true
    volumes:
      - ./config:/config
      - ./downloads:/downloads
      - /lib/modules:/lib/modules
    restart: unless-stopped