hurlenko/aria2-ariang

Aria2 + AriaNg Docker容器

镜像概述

本Docker容器集成了https://github.com/aria2/aria2%E4%B8%8B%E8%BD%BD%E5%B7%A5%E5%85%B7%E4%B8%8Ehttps://github.com/mayswind/AriaNg%E7%BD%91%E9%A1%B5%E7%95%8C%E9%9D%A2%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%B8%80%E7%AB%99%E5%BC%8F%E6%96%87%E4%BB%B6%E4%B8%8B%E8%BD%BD%E7%AE%A1%E7%90%86%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E3%80%82AriaNg%E4%BD%9C%E4%B8%BA%E7%8E%B0%E4%BB%A3Web%E5%89%8D%E7%AB%AF%EF%BC%8C%E9%87%87%E7%94%A8%E7%BA%AFHTML%E5%92%8CJavaScript%E5%BC%80%E5%8F%91%EF%BC%8C%E6%97%A0%E9%9C%80%E9%A2%9D%E5%A4%96%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83%EF%BC%8C%E9%80%9A%E8%BF%87%E5%93%8D%E5%BA%94%E5%BC%8F%E5%B8%83%E5%B1%80%E6%94%AF%E6%8C%81%E6%A1%8C%E9%9D%A2%E4%B8%8E%E7%A7%BB%E5%8A%A8%E8%AE%BE%E5%A4%87%E8%AE%BF%E9%97%AE%EF%BC%8C%E7%AE%80%E5%8C%96Aria2%E7%9A%84%E4%BD%BF%E7%94%A8%E6%B5%81%E7%A8%8B%E3%80%82

核心功能与特性

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

使用场景与适用范围

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

使用方法与配置说明

Docker快速部署

基础运行命令：

bash
docker run -d --name ariang -p 8080:8080 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=自定义密钥 \
    hurlenko/aria2-ariang

docker-compose配置

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

yaml
version: "3"

services:
  ariang:
    image: 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 .