auska/docker-aria2 repository overview

⁠Aria2 Docker 镜像

一个基于 Alpine Linux 的轻量级 Aria2 Docker 镜像。

⁠功能特性

• 基于 Alpine Linux，镜像体积小
• 可配置的用户权限（UID/GID）
• 支持 WebUI（latest 版本）
• 自动保存下载会话
• 可自定义 RPC 密钥和端口

⁠镜像版本

• latest：包含 WebUI
• noweb：不包含 WebUI

⁠快速开始

⁠创建容器

docker create --name=aria2 \
  -v <path to downloads>:/downloads \
  -v <path to config>:/config \
  -e PGID=<gid> -e PUID=<uid> \
  -e TZ=<timezone> -e SECRET=<rpc_secret> \
  -e RPC=<rpc_port> -e PORT=<bt_port> \
  -p <rpc_port>:<rpc_port> -p <bt_port>:<bt_port> \
  auska/docker-aria2

⁠启动容器

docker start aria2

⁠使用 Docker Compose

version: '3'
services:
  aria2:
    image: auska/docker-aria2
    container_name: aria2
    volumes:
      - <path to downloads>:/downloads
      - <path to config>:/config
    environment:
      - PGID=<gid>
      - PUID=<uid>
      - TZ=<timezone>
      - SECRET=<rpc_secret>
      - RPC=<rpc_port>
      - PORT=<bt_port>
    ports:
      - <rpc_port>:<rpc_port>
      - <bt_port>:<bt_port>
    restart: unless-stopped

⁠环境变量

⁠端口说明

• 80：WebUI 端口（默认）
• 6800：RPC 端口（默认）
• 16881：BT 监听端口（默认）

⁠卷映射

• /downloads：下载文件存储目录
• /config：配置文件目录

⁠配置文件

首次运行时会自动创建以下配置文件：

• aria2.conf：Aria2 配置文件
• aria2.session：下载会话文件
• dht.dat：DHT 节点数据文件
• dht6.dat：IPv6 DHT 节点数据文件

⁠更新日志

2025-10-18 增加Peer的黑白名单过滤。

2023-12-10 Aria2更新至1.37，webui更新到1.3.7。

2022-03-17 增加屏蔽迅雷等吸血客户端，webui更新到1.2.3。

2022-03-31:升级openssl版本

2022-04-07:升级openssl-3.0.2 zlib-ng-2.0.6

2022-04-23:增加移除wantDigest头变量

2022-05-02:修复屏蔽迅雷

2022-05-18:升级 openssl-3.0.3 libxml2-2.9.14 sqlite-3380500

2022-07-04:升级 openssl-3.0.4 sqlite-3390000 webui更新到1.2.4