aria2/webui-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/%E3%80%82%E5%90%AF%E5%8A%A8aria2 RPC服务：

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

WebUI使用方式

1. 本地文件：下载仓库后，打开docs文件夹中的index.html
2. 在线PWA：访问https://ziahamza.github.io/webui-aria2%EF%BC%8C%E6%94%AF%E6%8C%81%E7%A6%BB%E7%BA%BF%E4%BD%BF%E7%94%A8
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://www.herokucdn.com/deploy/button.svg](https://heroku.com/deploy)
• 支持：通过https://github.com/ziahamza/webui-aria2/issues%E6%8F%90%E4%BA%A4%E6%94%AF%E6%8C%81%E8%AF%B7%E6%B1%82%E3%80%81%E5%8A%9F%E8%83%BD%E9%9C%80%E6%B1%82%E6%88%96bug%E6%8A%A5%E5%91%8A
• 许可证：MIT许可证，详见LICENSE文件