abcminiuser/docker-aria2-with-webui

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

镜像概述和主要用途

本镜像源自 XUJINKAI/aria2-with-webui 的分支版本，解决了原镜像在特定场景下的适配问题。它基于最新 Alpine Linux 构建，包含最新稳定版 Aria2 客户端，以及前沿版本的 Aria2-WebUI 或最新发布版 Aria2-NG 前端。由于 WebUI 实际稳定性较高，出现故障的概率极低。镜像构建由 Alpine 容器更新触发，因此能随 Alpine/Aria2 新版本发布自动保持更新。

核心功能和特性

• 基础环境：基于最新 Alpine Linux，确保系统组件和 Aria2 保持最新
• 双前端支持：提供 Aria2-WebUI 和 Aria2-NG 两种前端界面，满足不同使用习惯
• 灵活配置：支持默认配置或自定义配置，适应多样化需求
• 权限控制：通过 PGID/PUID 环境变量解决宿主与容器间的权限问题

标签说明

• latest：与 latest-webui 标签相同
• latest-webui：最新版 Aria2，集成 https://github.com/timonier/webui-aria2 前端
• latest-ng：最新版 Aria2，集成 https://github.com/mayswind/AriaNg 前端

使用方法和配置说明

默认配置运行

若无需自定义配置，可直接使用以下命令启动容器：

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

参数说明：

• -p 6800:6800：Aria2 RPC 端口映射
• -p 6880:80：WebUI 访问端口映射（宿主机 6880 端口）
• -v /DOWNLOAD_DIR:/data：挂载宿主机下载目录到容器内 /data（请替换 /DOWNLOAD_DIR 为实际路径）
• -e SECRET=YOUR_SECRET_CODE：设置 Aria2 访问密钥（请替换为自定义密钥）
• -e PGID=100：指定运行容器的组 ID
• -e PUID=1001：指定运行容器的用户 ID

启动后，Aria2 可通过 6800 端口访问，WebUI 可通过 http://宿主机IP:6880 访问。

自定义配置运行

如需使用自定义配置，挂载包含 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: abcminiuser/docker-aria2-with-webui:latest
  network_mode: "bridge"
  ports:
    - 6800:6800
    - 6880:80
  volumes:
    - /volume1/Download/complete:/data  # 宿主机下载目录
    - /volume1/docker/Aria2:/conf       # 宿主机配置目录（含 aria2.conf）
  environment:
    - PGID=100    # 组 ID
    - PUID=1001   # 用户 ID
  restart: unless-stopped

用户/组标识符（PGID/PUID）

使用数据卷（-v 标志）时，宿主 OS 与容器间可能出现权限问题。通过指定用户 PUID 和组 PGID，可确保宿主数据卷目录与容器内权限一致，避免此类问题。

查看当前用户的 PUID/PGID：

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

（将 <用户名> 替换为实际用户名，输出中的 uid 即为 PUID，gid 即为 PGID）

鸣谢

本镜像基于 XUJINKAI/aria2-with-webui 进行少量修改，感谢原作者的贡献。
用户/组标识符部分说明参考自 LinuxServer.io 的优秀容器文档。