faintghost/aria2-ariang-ui

Aria2 + AriaNg UI Docker镜像

镜像概述

本镜像集成了Aria2下载工具和AriaNg Web管理界面，提供一站式的下载服务解决方案。Aria2是一款轻量级多协议命令行下载工具，支持HTTP/HTTPS、FTP、BitTorrent等多种协议；AriaNg是一个直观易用的Web前端界面，可通过浏览器方便地管理Aria2下载任务。

核心功能与特性

• 多协议支持：Aria2支持HTTP/HTTPS、FTP、SFTP、BitTorrent、Metalink等多种下载协议
• Web界面管理：集成AriaNg提供直观的Web管理界面，支持任务创建、暂停、继续、删除等操作
• 安全保护：通过RPC密钥验证保护Aria2 RPC接口，防止未授权访问
• 数据持久化：支持下载文件和配置文件的持久化存储
• 灵活配置：可通过环境变量自定义时区、RPC密钥等参数

使用场景

• 个人或家庭网络中搭建私有下载服务
• 服务器环境中需要后台下载文件的场景
• 需要通过Web界面远程管理下载任务的场景

使用方法

1. 快速启动（docker run）

替换命令中的/DOWNLOAD_DIR（本地下载目录）、/CONFIG_DIR（本地配置目录）和YOUR_RPC_SECRET（自定义RPC密钥），执行以下命令：

bash
sudo docker run -d \
--name aria2 \
-p 6800:6800 \  # Aria2 RPC端口
-p 6801:80 \    # AriaNg Web界面端口
-v /DOWNLOAD_DIR:/downloads \  # 下载文件存储目录
-v /CONFIG_DIR:/config \       # 配置文件存储目录
-e RPC_SECRET=YOUR_RPC_SECRET \  # RPC访问密钥
faintghost/aria2-ariang-ui

2. Docker Compose配置（推荐）

创建docker-compose.yml文件，内容如下（可根据需要调整参数）：

yaml
version: '3'
services:
  aria2:
    image: docker.xuanyuan.run/faintghost/aria2-ariang-ui
    container_name: aria2
    restart: always
    ports:
      - 6800:6800    # Aria2 RPC端口
      - 6801:80      # AriaNg Web界面端口
      - 6888:6888    # BT监听端口(TCP)
      - 6888:6888/udp  # BT监听端口(UDP)
    volumes:
      - ./config:/config     # 配置文件存储目录（当前目录下的config文件夹）
      - /volume1/downloads:/downloads  # 下载文件存储目录（示例路径）
    environment:
      - TZ=Europe/Berlin     # 时区设置（如Asia/Shanghai）
      - RPC_SECRET=009812    # RPC访问密钥（自定义）
    labels:
      - com.centurylinklabs.watchtower.enable=true  # 允许watchtower自动更新

  # 可选：自动更新镜像服务
  utility.watchtower:
    image: docker.xuanyuan.run/containrrr/watchtower:latest
    container_name: watchtower
    network_mode: host
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 访问Docker守护进程
    environment:
      - TZ=Europe/Berlin     # 时区设置
      - WATCHTOWER_CLEANUP=true  # 更新后清理旧镜像
      - WATCHTOWER_POLL_INTERVAL=30  # 检查更新间隔（秒）
      - WATCHTOWER_LABEL_ENABLE=true  # 仅更新带有指定标签的容器

启动服务：

bash
docker-compose up -d

3. 访问Web界面

容器启动后，通过浏览器访问 http://服务器IP:6801/ 即可打开AriaNg管理界面。首次使用时，如提示连接Aria2 RPC，需输入配置的RPC密钥（RPC_SECRET的值）。

构建镜像

如需自定义构建镜像，执行以下命令：

bash
sudo docker build -f Dockerfile -t faintghost/aria2-ariang-ui

相关链接

• Aria2官方仓库：https://github.com/aria2/aria2
• AriaNg官方仓库：https://github.com/mayswind/AriaNg