opengg/aria2

docker-aria2

镜像概述

docker-aria2是基于Alpine Linux构建的Aria2守护进程Docker镜像，用于运行Aria2下载服务。Aria2是一款轻量级多协议命令行下载工具，支持HTTP/HTTPS、FTP、SFTP、BitTorrent和磁力链接等多种下载协议，并提供RPC接口以便远程控制。该镜像提供了便捷的部署方式，支持配置持久化和下载目录映射，适用于个人或家庭环境的下载管理需求。

核心功能与特性

• 多协议支持：兼容HTTP/HTTPS、FTP、SFTP、BitTorrent、磁力链接等多种下载协议
• RPC远程控制：内置RPC接口，可通过第三方客户端（如AriaNg）远程管理下载任务
• 配置持久化：支持配置文件和会话状态持久化存储，重启后可恢复下载任务
• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 权限控制：支持指定用户/组ID运行，避免宿主机文件权限冲突

使用场景

• 个人下载服务器搭建
• 家庭媒体中心的后台下载服务
• 需要远程管理下载任务的场景
• 多协议下载需求的自动化工作流集成

使用方法

1. 准备目录

首先创建配置和下载目录，并设置正确的权限：

bash
# 创建配置目录
mkdir /storage/aria2/config
# 设置目录权限（用户ID 1001，组ID 1002）
chown -R 1001:1002 /storage/aria2/config
find /storage/aria2/config -type d -exec chmod 755 {} +
find /storage/aria2/config -type f -exec chmod 644 {} +

# 创建下载目录
mkdir /storage/aria2/downloads
# 设置目录权限
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文件，示例配置如下：

ini
# 会话管理
save-session=/config/aria2.session
input-file=/config/aria2.session
save-session-interval=60

# 下载目录
dir=/downloads

# 性能优化
file-allocation=prealloc
disk-cache=128M

# RPC设置
enable-rpc=true
rpc-listen-port=6800
rpc-allow-origin-all=true
rpc-listen-all=true

# RPC访问密码（请替换为实际密码）
rpc-secret=<password>

# 文件重命名设置
auto-file-renaming=false

# 下载并发设置
max-connection-per-server=16
min-split-size=1M
split=16

注意：如果配置目录中未找到aria2.conf，容器将自动创建默认配置文件。

3. 启动容器

使用以下命令启动Aria2容器：

bash
docker run \
  -d \
  --name aria2 \
  -u=1001:1002 \
  -v /storage/aria2/config:/config \
  -v /storage/aria2/downloads:/downloads \
  -p 6800:6800 \
  opengg/aria2

参数说明

用户/组标识符

使用数据卷（-v参数）时，可能会出现宿主机与容器之间的权限冲突。通过指定-u参数可以避免此问题，确保宿主机目录的所有者与容器内运行用户一致。

查看当前用户的ID：

bash
id <用户名>
# 示例输出：uid=1001(dockeruser) gid=1002(dockergroup) groups=1002(dockergroup)

将输出中的uid和gid用于-u参数，确保宿主机的配置和下载目录归属于该用户/组。

注意事项

• 确保下载目录对指定的用户ID和组ID具有写权限
• RPC密码（rpc-secret）应设置为强密码，避免未授权访问
• 更多配置参数可参考Aria2官方文档
• 如需进入运行中的容器，可使用命令：docker exec -it aria2 /bin/sh