webui-aria2

aria2/webui-aria2 Docker Image

aria2

WebUI-Aria2是aria2的最佳Web界面,用于简化与aria2的交互,支持本地文件、在线PWA及NodeJS服务器多种使用方式,提供文件选择下载、DirectURL等功能,且包含测试和ARM生产环境的Docker支持。

下载次数: 0状态:社区镜像维护者:aria2仓库类型:镜像最近更新:

WebUI-Aria2

镜像概述和主要用途

WebUI-Aria2旨在为aria2(一款优秀的文件下载器)创建最佳的交互界面。aria2功能强大但命令行操作复杂,该项目最初作为GSOC计划的一部分创建,在aria2社区的支持和反馈下迅速发展,提供了简单直观的图形化管理方式。

核心功能和特性

  • 简单易用:无需构建脚本或安装脚本,直接可用
  • 多使用方式:支持本地文件打开、在线PWA(支持离线使用)及NodeJS服务器部署
  • 文件选择下载:针对torrent或metalink,可选择具体下载文件
  • DirectURL功能:配置后可直接从WebUI仪表板下载aria2下载的文件
  • Docker支持:提供测试用和ARM32v7平台(如树莓派)的生产就绪版本

使用场景和适用范围

  • 需要图形界面管理aria2下载任务的用户
  • 本地或远程aria2实例的可视化管理
  • ARM架构设备(如树莓派)的生产环境部署
  • 希望通过浏览器便捷管理下载任务的场景

使用方法和配置说明

前提条件

需先安装aria2,安装指南见https://aria2.github.io/。启动aria2 RPC服务:

bash
aria2c --enable-rpc --rpc-listen-all

WebUI使用方式

  1. 本地文件:下载仓库后,打开docs文件夹中的index.html
  2. 在线PWA:访问https://ziahamza.github.io/webui-aria2,支持离线使用
  3. NodeJS服务器:从项目文件夹运行以下命令启动服务器
    bash
    node node-server.js
    

Tips

  • 文件选择下载:对于torrent或metalink,可暂停下载后点击设置按钮旁的列表图标选择文件。若要在开始下载前选择文件,启动aria2时添加--pause-metadata标志,详见https://aria2.github.io/manual/en/html/aria2c.html#cmdoption--pause-metadata

配置

编辑configuration.js进行配置。

DirectURL功能

该功能允许从WebUI仪表板直接下载aria2下载的文件。需设置指向aria2下载目录的HTTP服务器,然后在WebUI配置中指定完整URL(如http://server:port/)。详细说明见directurl.md

依赖

  • aria2
  • Web浏览器

Docker支持

项目提供两个Dockerfile:一个用于测试,另一个是适用于arm32v7平台(含树莓派)的生产就绪版本。

测试用Docker镜像

可在局域网内的Docker沙箱中试用WebUI-Aria2。

构建镜像

bash
sudo docker build -t yourname/webui-aria2 .

运行容器

访问地址:http://localhost:9100

bash
sudo docker run -v /Downloads:/data -p 6800:6800 -p 9100:8080 --name="webui-aria2" yourname/webui-aria2

/Downloads:主机中用于存放下载文件的目录

生产就绪版(ARM平台)

该镜像包含aria2和webui-aria2,适用于arm32v7架构。

构建镜像

(编译aria2可能需要数小时,建议耐心等待)

bash
docker build -f Dockerfile.arm32v7 -t yourname/webui-aria2 .

构建过程将生成三个镜像:

  • 编译aria2和goreman二进制文件的镜像(ARIA2_VERSION变更时需删除)
  • 构建和下载go依赖的镜像
  • 实际使用的aria2容器镜像

准备主机卷

需挂载以下文件到容器:

  • /home/aria/aria2/session.txt(空文件)
  • /home/aria/aria2/aria2.log(空文件)
  • /home/aria/aria2/aria2.conf(aria2配置文件,至少包含enable-rpc=true和rpc-listen-all=true)
  • /data/downloads/(下载文件存放目录)

运行容器

bash
docker run --restart=always \
        -v /home/<USER>/data/aria2/downloads:/data/downloads \
        -v /home/<USER>/data/aria2/.aria2:/home/aria/.aria2 \
        -p 6800:6800 -p 9100:8080 \
        --name="webui-aria2" \
        -d docker.xuanyuan.run/yourname/webui-aria2

其他信息

  • 贡献:参考贡献者指南
  • 部署到Heroku:
  • 支持:通过https://github.com/ziahamza/webui-aria2/issues提交支持请求、功能需求或bug报告
  • 许可证:MIT许可证,详见LICENSE文件

镜像拉取方式

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

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

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

DockerHub 原生拉取命令

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