beginor/aria2

docker-aria2 镜像文档

镜像概述

docker-aria2是一个集成了aria2下载工具和busybox httpd web服务的Docker镜像。该镜像允许用户灵活搭配任意aria2 Web UI，通过网页界面便捷管理下载任务，适用于需要轻量级、可定制化下载解决方案的场景。

核心功能和特性

• aria2下载核心：内置aria2下载工具，支持HTTP/HTTPS、FTP、BitTorrent等多种协议
• Web服务支持：集成busybox httpd，提供Web UI访问能力
• 灵活UI选择：可搭配任意aria2 Web UI（如webui-aria2、AriaNg等）
• 数据持久化：支持下载文件和配置文件的持久化存储
• 简单部署：通过docker-compose快速部署，配置灵活

使用场景和适用范围

• 个人电脑或服务器的下载任务管理
• 家庭网络中的集中式下载服务
• 需要通过网页远程管理下载的场景
• 对下载工具界面有个性化需求的用户

使用方法和配置说明

1. 获取镜像

从Docker Hub拉取

sh
docker pull beginor/aria2:1.35.0

或本地构建

sh
git clone https://github.com/beginor/docker-aria2.git aria2
cd aria2
./build.sh

2. 准备Web UI

下载你喜欢的aria2 Web UI（已测试支持https://github.com/ziahamza/webui-aria2%E5%92%8Chttps://github.com/mayswind/AriaNg%EF%BC%89%EF%BC%8C%E5%B9%B6%E5%B0%86%E5%85%B6%E8%A7%A3%E5%8E%8B%E5%88%B0%E6%9C%AC%E5%9C%B0%60webui%60%E6%96%87%E4%BB%B6%E5%A4%B9%E3%80%82

3. 配置docker-compose.yml

创建docker-compose.yml文件，根据需求调整配置：

yml
version: "3"
services:
  aria2:
    image: beginor/aria2:1.35.0
    container_name: aria2
    ports:
      - 6800:6800  # aria2 RPC端口，用于Web UI通信
      - 6880:6880  # Web服务端口，用于访问Web UI
    volumes:
      # 可选：挂载自定义aria2配置文件
      # - ./aria2.conf:/aria2/aria2.conf
      # 可选：挂载自定义httpd配置文件
      # - ./httpd.conf:/aria2/httpd.conf
      - ./webui:/aria2/webui  # Web UI文件目录
      - ~/Downloads:/aria2/downloads  # 下载文件存储目录

4. 启动服务

执行以下命令启动容器：

sh
docker-compose up -d

5. 访问Web UI

在浏览器中访问 http://localhost:6880/ 即可打开aria2 Web UI，开始管理下载任务。

配置说明

端口映射

• 6800: aria2 RPC端口，Web UI通过此端口与aria2通信
• 6880: httpd服务端口，用于访问Web UI界面

卷挂载

• ./webui:/aria2/webui: 本地Web UI文件目录，需提前放置Web UI文件
• ~/Downloads:/aria2/downloads: 下载文件存储目录，建议使用本地绝对路径
• 可选配置文件挂载：如需自定义aria2或httpd配置，可取消注释对应行并提供本地配置文件

注意事项

• 确保Web UI文件正确放置在webui目录中，否则可能无法访问界面
• 首次使用时，Web UI可能需要配置RPC地址（通常默认指向localhost:6800）
• 如需修改默认端口，需同时调整docker-compose中的端口映射和Web UI配置