auska/aria2

Aria2 Docker镜像文档

镜像概述

本镜像为Aria2下载工具的Docker封装，集成Web管理界面，具备屏蔽迅雷等吸血客户端、自动更新tracker功能，支持群晖、威联通、U-NAS、Free-NAS等主流NAS系统，提供便捷的下载管理解决方案。

核心功能与特性

• 吸血客户端屏蔽：自动屏蔽迅雷等吸血BT客户端，提升下载效率
• Tracker自动更新：定期更新BT tracker列表，优化P2P下载连接
• Web管理界面：自带Web管理界面，支持通过浏览器进行下载管理
• 灵活权限配置：支持自定义用户ID(PUID)和组ID(PGID)，确保文件权限正确
• 时区设置：可配置系统时区，默认使用Asia/Shanghai（上海时区）

使用场景

• 群晖、威联通、U-NAS、Free-NAS等NAS设备的下载服务部署
• 个人服务器或家庭影院系统的后台下载管理
• 需要高效BT/HTTP/HTTPS/FTP下载的场景

使用方法

Docker Run命令示例

bash
docker run -d --name=aria2 \
  -v <本地下载路径>:/mnt \
  -v <本地配置路径>:/config \
  -e PGID=<用户组ID> -e PUID=<用户ID> \
  -e TZ=<时区> -e SECRET=<登录密钥> \
  -e RPC=6800 -e PORT=16881 -e WEB=80 \
  -p 6800:6800 -p 16881:16881 -p 80:80 \
  auska/docker-aria2

Docker Create命令示例

bash
docker create --name=aria2 \
  -v <本地下载路径>:/mnt \
  -v <本地配置路径>:/config \
  -e PGID=<用户组ID> -e PUID=<用户ID> \
  -e TZ=<时区> -e SECRET=<登录密钥> \
  -e RPC=6800 -e PORT=16881 -e WEB=80 \
  -p 6800:6800 -p 16881:16881 -p 80:80 \
  auska/docker-aria2

参数说明

端口映射 (-p)

• -p 80:80：Web管理界面端口，映射后可通过http://<IP>:80访问管理界面
• -p 6800:6800：RPC端口，用于Aria2 RPC通信
• -p 16881:16881：BT软件通讯端口，用于P2P下载连接

数据卷挂载 (-v)

• -v <本地配置路径>:/config：配置文件目录，存储Aria2配置、Web界面设置等
• -v <本地下载路径>:/mnt：下载文件目录，Aria2下载的文件将保存至此

环境变量 (-e)

• PGID：用户组ID，控制容器内进程的组权限，留空默认使用root权限
• PUID：用户ID，控制容器内进程的用户权限，留空默认使用root权限
• SECRET：Web管理界面登录密钥，默认值为admin
• TZ：时区设置，默认值为Asia/Shanghai（上海时区），可根据需要修改为其他时区（如Europe/London）
• RPC：RPC端口设置，默认值为6800
• PORT：BT通讯端口设置，默认值为16881
• WEB：Web管理界面端口设置，默认值为80

版本介绍

• latest：最新稳定版，自带Web管理界面

更新日志

• 2023-12-10：升级Aria2至1.37版本
• 2022-03-31：升级OpenSSL版本，提升安全性
• 2022-03-17：增加屏蔽迅雷等吸血客户端功能，WebUI更新至1.2.3版本