flyersweb/aria2

docker-aria2

镜像概述和主要用途

docker-aria2是Aria2下载工具的Docker化实现。Aria2是一款轻量级、多协议、多源的命令行下载工具，支持HTTP/HTTPS、FTP、BitTorrent、Metalink等协议，通过多线程加速下载。本镜像提供便捷的容器化部署，简化配置和运行流程，适用于个人或服务器环境的高效文件下载需求。

核心功能和特性

• 多协议支持：兼容HTTP/HTTPS、FTP、BitTorrent、Metalink等多种下载协议
• 容器化部署：通过Docker实现快速部署，避免系统环境依赖问题
• 灵活配置：支持挂载本地配置文件自定义Aria2参数
• 持久化存储：下载文件和配置可通过卷挂载实现持久化，防止容器重启数据丢失
• 权限控制：通过环境变量设置下载文件的所有者ID，确保文件权限正确

使用场景和适用范围

• 个人电脑或服务器的日常文件下载任务
• 需要多协议支持的批量下载场景
• 希望隔离下载环境，避免影响主机系统配置的场景
• 需通过RPC接口远程控制下载的应用场景

使用方法和配置说明

构建镜像

如需自定义构建镜像，执行以下命令：

bash
docker build -t aria2:lastest --no-cache -f Dockerfile .

测试下载功能

构建或拉取镜像后，可通过以下命令测试下载功能：

bash
docker run -it docker.xuanyuan.run/aria2:lastest aria2c --conf-path="/etc/aria2/aria2.conf" http://websitetips.com/articles/copy/lorem/ipsum.txt

该命令使用默认配置下载测试文件，验证Aria2是否正常工作。

Docker Compose配置示例

推荐使用Docker Compose部署，完整配置如下：

yaml
aria2:
  # Docker Hub镜像名称
  image: docker.xuanyuan.run/flyersweb/aria2
  # 容器名称
  container_name: aria2
  # 错误时自动重启
  restart: always
  # 环境变量配置
  environment:
    - FUID=1003  # 下载文件的用户ID
    - FGID=1003  # 下载文件的组ID
  # 卷挂载配置
  volumes:
    - /tmp/Download:/dataComplete  # 已完成下载文件存储路径
    - /tmp/OnDownload:/data  # 进行中下载文件存储路径
    - ./config/aria2:/etc/aria2  # 本地配置文件挂载路径（覆盖默认配置）
  # 端口映射（RPC通信端口）
  ports:
    - "6800:6800"

配置参数说明

• 环境变量：

  • FUID：设置下载文件的用户ID，确保容器内文件所有者与主机一致
  • FGID：设置下载文件的组ID，配合FUID控制文件权限

• 卷挂载：

  • /dataComplete：存储已完成的下载文件，建议挂载到主机目录实现持久化
  • /data：存储进行中的下载文件和临时文件
  • /etc/aria2：挂载本地Aria2配置文件目录，可自定义aria2.conf等配置

• 端口映射：

  • 6800:6800：Aria2 RPC通信端口，用于远程控制下载（如通过Web UI）

启动容器

配置完成后，通过以下命令启动容器：

bash
docker-compose up -d