wiserain/aria2

docker-aria2

镜像概述和主要用途

docker-aria2是基于lsiobase/alpine:latest的Docker镜像，用于运行aria2下载工具并集成Web UI。该镜像支持非root用户运行，提供权限管理功能，允许选择不同Web UI界面，并通过反向代理提供JSON-RPC服务，方便远程管理下载任务。

核心功能和特性

• 基础镜像：基于lsiobase/alpine:latest，轻量高效
• 权限处理：通过PUID和PGID环境变量控制运行权限，支持非root用户运行
• Web UI选择：提供两种Web UI选项
  • https://github.com/mayswind/AriaNg
  • https://github.com/ziahamza/webui-aria2
• 反向代理RPC：支持JSON-RPC和XML-RPC，方便远程控制

使用场景和适用范围

适用于需要便捷管理下载任务的个人用户或家庭环境，尤其适合通过Web界面监控和控制下载进度的场景，支持远程访问和权限管理，确保下载文件的访问安全。

使用方法和配置说明

Docker Compose配置示例

yaml
version: '3'

services:
  aria2:
    container_name: aria2
    image: wiserain/aria2:latest
    restart: always
    network_mode: "bridge"
    ports:
      - ${SERVICE_PORT}:80
    volumes:
      - ${DOCKER_ROOT}/aria2/config:/config
      - ${DOWNLOAD_ROOT}:/download
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=Asia/Seoul
      - WEBUI=webui-aria2
      - RPC_SECRET=${YOUR_RPC_SECRET}
      - USER_OPTS=${ADDITIONAL_ARGS}

运行命令说明

容器启动后执行以下aria2c命令：

bash
aria2c \
    --conf-path=/config/aria2.conf \
    --disable-ipv6=true \
    --enable-rpc \
    --rpc-listen-all \
    --rpc-allow-origin-all \
    --rpc-listen-port=6800 \
    -d /download \
    ${RPC_SECRET:+ --rpc-secret=$RPC_SECRET} \
    ${USER_OPTS[@]}

可通过RPC_SECRET设置RPC密钥，通过USER_OPTS添加aria2c额外命令行参数（除固定参数外）。

服务访问地址

环境变量说明