yaoa/docker-aria2-with-webui

Aria2 容器（集成Aria2-WebUI和Aria2-NG前端）

镜像概述和主要用途

本镜像为Aria2下载工具的Docker容器，集成了Aria2-WebUI和Aria2-NG两种Web前端界面。基于最新Alpine Linux构建，使用Alpine软件仓库中的最新稳定版Aria2客户端，以及前沿版本的Aria2-WebUI或最新发布版的Aria2-NG前端。容器构建会随Alpine容器更新自动触发，确保Aria2和系统组件保持最新。

核心功能和特性

• 基于Alpine Linux，轻量高效
• 集成Aria2-WebUI和Aria2-NG两种Web管理界面
• 自动随Alpine更新保持Aria2版本最新
• 支持默认配置和自定义配置两种运行模式
• 可通过环境变量设置用户/组ID，避免权限问题

标签说明

• latest: 与latest-webui标签相同
• latest-webui: 包含最新Aria2和https://github.com/timonier/webui-aria2%E5%89%8D%E7%AB%AF
• latest-ng: 包含最新Aria2和https://github.com/mayswind/AriaNg%E5%89%8D%E7%AB%AF

使用方法和配置说明

基本运行（默认配置）

无需自定义配置时，使用以下命令启动：

bash
sudo docker run -d \
--name aria2-with-webui \
-p 6800:6800 \
-p 6880:80 \
-v /DOWNLOAD_DIR:/data \
-e SECRET=YOUR_SECRET_CODE \
-e PGID=100 \
-e PUID=1001 \
abcminiuser/docker-aria2-with-webui

• Aria2服务端口：6800
• WebUI访问端口：6880
• 下载目录：/DOWNLOAD_DIR（需替换为实际目录）
• SECRET：可选，用于远程访问Aria2守护进程的认证令牌（未设置时WebUI仍可本地使用）
• PGID/PUID：用户组ID和用户ID，用于解决权限问题

自定义配置

如需使用自定义aria2.conf配置文件，挂载/conf卷：

bash
sudo docker run -d \
--name aria2-with-webui \
-p 6800:6800 \
-p 6880:80 \
-v /DOWNLOAD_DIR:/data \
-v /CONFIG_DIR:/conf \
-e PGID=100 \
-e PUID=1001 \
abcminiuser/docker-aria2-with-webui

注意：WebUI本身不提供认证功能，如需认证，建议使用NGINX反向代理实现。

Docker Compose配置示例

yaml
aria2:
  container_name: Aria2
  image: docker.xuanyuan.run/abcminiuser/docker-aria2-with-webui:latest
  network_mode: "bridge"
  ports:
    - 6800:6800
    - 6880:80
  volumes:
    - /volume1/Download/complete:/data
    - /volume1/docker/Aria2:/conf
  environment:
    - PGID=100
    - PUID=1001
  restart: unless-stopped

用户/组ID说明

使用数据卷（-v）时，主机与容器可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID）可避免此问题。确保主机数据卷目录的所有者与指定的ID一致即可正常工作。

查看当前用户的ID：

bash
$ id <用户名>
  uid=1001(用户名) gid=1001(组名) groups=1001(组名)

credits

本镜像基于XUJINKAI/aria2-with-webui容器修改，核心功能归功于原作者。