maxduke/aria2-with-ariang

docker-aria2-with-ariang

镜像概述

docker-aria2-with-ariang是一款集成Aria2下载工具与AriaNG Web管理界面的Docker镜像。Aria2是轻量级多协议下载工具，支持HTTP/HTTPS、FTP、BitTorrent等协议；AriaNG是现代化Web前端，提供直观的下载任务管理界面。该镜像简化了Aria2的部署流程，实现开箱即用的下载解决方案。

核心功能与特性

• 一体化部署：集成Aria2下载引擎与AriaNG Web界面，无需单独配置
• 多协议支持：兼容HTTP/HTTPS、FTP、SFTP、BitTorrent、Metalink等多种下载协议
• Web管理界面：通过AriaNG提供可视化操作界面，支持任务管理、进度监控、参数配置
• 持久化存储：配置文件与下载文件通过卷挂载实现持久化，容器重启后数据不丢失
• 权限控制：支持指定用户ID/组ID运行，避免宿主机器与容器间的权限冲突
• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低

使用场景

• 个人服务器/PC的文件下载管理
• NAS设备中的下载服务部署
• 远程服务器的文件批量下载任务管理
• 需要便捷Web界面控制的下载场景

使用方法

1. 准备配置与下载目录

执行以下命令创建并配置目录权限：

bash
# 创建配置目录
mkdir /storage/aria2/conf

# 获取当前用户的uid和gid（用于权限配置）
id

# 设置配置目录权限（将1001:1002替换为实际uid:gid）
chown -R 1001:1002 /storage/aria2/conf
find /storage/aria2/conf -type d -exec chmod 755 {} +
find /storage/aria2/conf -type f -exec chmod 644 {} +

# 创建下载目录
mkdir /storage/aria2/downloads

# 设置下载目录权限（将1001:1002替换为实际uid:gid）
chown -R 1001:1002 /storage/aria2/downloads
find /storage/aria2/downloads -type d -exec chmod 755 {} +
find /storage/aria2/downloads -type f -exec chmod 644 {} +

2. 配置aria2.conf文件

在配置目录中创建aria2.conf文件，示例内容如下：

ini
save-session=/aria2/conf/aria2.session
input-file=/aria2/conf/aria2.session
save-session-interval=60

dir=/aria2/downloads

file-allocation=prealloc
disk-cache=128M

enable-rpc=true
rpc-listen-port=6800
rpc-allow-origin-all=true
rpc-listen-all=true

rpc-secret=<password>  # 替换为自定义RPC密码

auto-file-renaming=false

max-connection-per-server=16
min-split-size=1M
split=16

3. 启动容器

执行以下命令启动镜像：

bash
# 将1001:1002替换为实际的uid:gid
docker run \
  -d \
  --name aria2 \
  -u=1001:1002 \
  -v /storage/aria2/conf:/aria2/conf \
  -v /storage/aria2/downloads:/aria2/downloads \
  -p 6800:6800 \
  -p 56881:56881 \
  -p 80:80 \
  -p 8080:8080 \
  maxduke/aria2-with-ariang

参数说明

端口映射

• -p 6800:6800：Aria2 RPC服务端口，用于AriaNG与Aria2通信
• -p 56881:56881：BitTorrent DHT网络端口，用于P2P节点发现
• -p 80:80：AriaNG Web管理界面端口，访问http://主机IP打开管理界面
• -p 8080:8080：下载目录HTTP服务端口，访问http://主机IP:8080查看下载文件

卷挂载

• -v /storage/aria2/conf:/aria2/conf：配置目录，存储配置文件、会话数据和日志
• -v /storage/aria2/downloads:/aria2/downloads：下载文件存储目录

用户权限

• -u 1001:1002：指定容器运行用户ID和组ID（格式uid:gid），需与宿主目录所有者ID一致以避免权限问题

用户/组ID说明

使用数据卷时，宿主机器与容器可能出现权限冲突。通过id命令获取当前用户的uid和gid（如uid=1001(用户) gid=1002(组)），并在启动容器时通过-u参数指定，确保容器内进程对挂载目录有正确的读写权限。

注意事项

• 确保下载目录对指定的uid/gid有写入权限，否则可能导致下载失败
• 若配置目录未提供aria2.conf，容器会自动生成默认配置文件
• 详细配置参数可参考https://aria2.github.io/manual/en/html/aria2c.html#aria2-conf