Aria2 是一个轻量级、多协议、多源的命令行下载实用工具。它支持 HTTP/HTTPS、FTP、SFTP、BitTorrent 和 Metalink。
这里推荐使用 Aria2 Pro 镜像,它是由 P3TERX 制作的增强版,包含以下特点:
- 完美支持 BT 和磁力链接下载,自动更新 Tracker 列表。
- 经过优化的配置文件,下载速度更快。
- 包含自动删除、自动移动等实用脚本。
- 极低的资源占用。
为了方便管理,通常配合 Web 前端 AriaNg 一起使用。
安装说明
前提依赖
- Docker
- Docker Compose
安装配置
以下是一个包含 Aria2 Pro 和 AriaNg 的 docker-compose.yml 示例:
version: "3.8"
services:
aria2-pro:
container_name: aria2-pro
image: p3terx/aria2-pro
environment:
- PUID=1000
- PGID=1000
- UMASK_SET=022
- RPC_SECRET=YourSecretToken # 务必修改此处的 RPC 密钥
- RPC_PORT=6800
- LISTEN_PORT=6888
- DISK_CACHE=64M
- IPV6_MODE=false
- UPDATE_TRACKERS=true
- CUSTOM_TRACKER_URL=
- TZ=Asia/Shanghai
volumes:
- ./aria2-config:/config
- ./downloads:/downloads
ports:
- 6800:6800
- 6888:6888
- 6888:6888/udp
restart: unless-stopped
logging:
driver: json-file
options:
max-size: 1m
ariang:
container_name: ariang
image: p3terx/ariang
ports:
- 6880:6880
restart: unless-stopped
logging:
driver: json-file
options:
max-size: 1m
注意事项:
- RPC_SECRET:请务必将
YourSecretToken修改为一个复杂的密码,用于连接验证。 - 卷挂载:
./aria2-config:存放配置文件的目录。./downloads:默认下载目录,请根据实际情况修改宿主机路径。
- 端口:
6800:RPC 通讯端口。6888:BT 下载监听端口(TCP/UDP),需要在路由器做端口转发以获得更好的连接性。6880:AriaNg Web 访问端口。
使用说明
- 访问 WebUI:浏览器访问
http://NAS_IP:6880打开 AriaNg 界面。 - 配置连接:
- 打开 AriaNg 设置 -> "Aria2 RPC"。
- Aria2 RPC 地址:填写 NAS 的 IP 地址(如果是在本机访问可填 localhost,远程访问需填公网或局域网 IP)。
- Aria2 RPC 密钥:填写在
docker-compose.yml中设置的RPC_SECRET。 - 刷新页面,左侧状态显示 "已连接" 即表示配置成功。
- 开始下载:点击 "新建" 按钮,输入下载链接或上传种子文件即可开始下载。

开源信息
- Aria2 Pro GitHub: https://github.com/P3TERX/Aria2-Pro-Docker
- Aria2 Pro 说明文档: https://p3terx.com/archives/docker-aria2-pro.html
- AriaNg GitHub: https://github.com/mayswind/AriaNg