hurlenko/aria2-ariang

Aria2 + AriaNg Docker容器

镜像概述

本Docker容器集成了https://github.com/aria2/aria2下载工具与https://github.com/mayswind/AriaNg网页界面，提供一站式文件下载管理解决方案。AriaNg作为现代Web前端，采用纯HTML和JavaScript开发，无需额外运行环境，通过响应式布局支持桌面与移动设备访问，简化Aria2的使用流程。

核心功能与特性

• 便捷配置：通过环境变量灵活配置容器参数
• 权限管理：支持PUID/PGID用户组映射，解决宿主与容器间文件权限问题
• 多架构支持：已在amd64（Ubuntu 18.04）、arm64（Rock64）和arm32（树莓派）架构验证运行

使用场景与适用范围

适用于需要高效管理下载任务的个人用户或小型团队，尤其适合在多种硬件平台（如PC、服务器、开发板）上部署，提供跨设备的下载管理能力。

使用方法与配置说明

Docker快速部署

基础运行命令：

bash
docker run -d --name ariang -p 8080:8080 docker.xuanyuan.run/hurlenko/aria2-ariang

自定义用户与卷映射：

bash
docker run -d \
    --name aria2-ui \
    -p 8080:8080 \
    -v /本地下载目录:/aria2/data \
    -v /本地配置目录:/aria2/conf \
    -e PUID=1000 \
    -e PGID=1000 \
    -e ARIA2RPCPORT=443 \
    -e RPC_SECRET=自定义密钥 \
    docker.xuanyuan.run/hurlenko/aria2-ariang

docker-compose配置

最小化docker-compose.yml配置示例：

yaml
version: "3"

services:
  ariang:
    image: docker.xuanyuan.run/hurlenko/aria2-ariang
    ports:
      - 443:8080
    volumes:
      - /本地下载目录:/aria2/data
      - /本地配置目录:/aria2/conf
    environment:
      - PUID=1000
      - PGID=1000
      - RPC_SECRET=secret
      - ARIA2RPCPORT=443
    restart: always

启动命令：

bash
docker-compose up

Nginx代理配置

若需通过Nginx反向代理访问，可使用以下配置：

nginx
location / {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    # proxy_set_header X-Forwarded-Proto https;  # 启用HTTPS时取消注释
    proxy_pass http://127.0.0.1:5002;  # 替换为容器实际IP和端口

    # 支持WebSocket
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";

    proxy_read_timeout 999999999;
}

环境变量说明

卷说明

用户/组标识符

使用卷映射时，宿主与容器可能出现权限问题。通过指定PUID和PGID可解决：

• 查看当前用户ID：id username（示例输出：uid=1000(user) gid=1000(group)）
• 将PUID和PGID设置为上述输出的uid和gid，确保卷目录权限匹配

构建镜像

bash
git clone https://github.com/hurlenko/aria2-ariang-docker
cd aria2-ariang-docker
docker build -t hurlenko/aria2-ariang .