aria2

beginor/aria2 Docker 镜像

自动构建

集成aria2下载工具和Web UI的Docker镜像,支持通过网页界面管理下载任务,可灵活搭配不同Web UI(如webui-aria2、AriaNg),适用于个人或家庭网络下载管理。

5 次收藏下载次数: 0状态:自动构建维护者:beginor仓库类型:镜像最近更新:
下载命令
点击查看

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 docker.xuanyuan.run/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和https://github.com/mayswind/AriaNg),并将其解压到本地`webui`文件夹。

3. 配置docker-compose.yml

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

yml
version: "3"
services:
  aria2:
    image: docker.xuanyuan.run/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配置

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 aria2 镜像标签

docker pull docker.xuanyuan.run/beginor/aria2:<标签>

DockerHub 原生拉取命令

docker pull beginor/aria2:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告