P3TERX/Aria2-Pro-Docker

Dockerfilehub.docker.com/r/p3terx/aria2-pro

Aria2 Pro | A perfect Aria2 Docker image | 更好用的 Aria2 Docker 容器镜像

aria2aria2cdockerdocker-imagedockerfiledocker-aria2magnetmagnet-linkbtbittorrentdownloaddownloader

关键指标

Star 增长趋势

Star

3.7k

Forks

402

周增长

—

Issues

1k2k3k

2020年1月2021年2月2022年3月2023年4月2024年5月2025年6月2026年7月

README

English | 中文

Aria2 Pro Docker

A perfect Aria2 Docker image. Out of the box, just add download tasks and don't need to think about anything else.

Features

Supported platforms: amd64, i386, arm64, arm/v7, arm/v6
Full Function: Async DNS, BitTorrent, Firefox3 Cookie, GZip, HTTPS, Message Digest, Metalink, XML-RPC, SFTP
max-connection-per-server unlimited.
retry on slow speed (lowest-speed-limit) and connection close
High BT download rate and speed
Get BitTorrent tracker automatically
Download error automatically delete files
Download cancel automatically delete files
Automatically clear .aria2 suffix files
Automatically clear .torrent suffix files
No lost task progress, no repeated downloads
And more powerful features

Usage

Docker CLI

No matter what architecture platform is used, just use the following command to start the container ( Just need to replace the <TOKEN> field ):

docker run -d \
    --name aria2-pro \
    --restart unless-stopped \
    --log-opt max-size=1m \
    -e PUID=$UID \
    -e PGID=$GID \
    -e UMASK_SET=022 \
    -e RPC_SECRET=<TOKEN> \
    -e RPC_PORT=6800 \
    -p 6800:6800 \
    -e LISTEN_PORT=6888 \
    -p 6888:6888 \
    -p 6888:6888/udp \
    -v $PWD/aria2-config:/config \
    -v $PWD/aria2-downloads:/downloads \
    p3terx/aria2-pro

Then you need a WebUI for control, such as AriaNg. This link is provided by the developer and can be used directly. Or use Docker to deploy it yourself:

docker run -d \
    --name ariang \
    --log-opt max-size=1m \
    --restart unless-stopped \
    -p 6880:6880 \
    p3terx/ariang

TIPS: It is important for the firewall to open ports.

Docker Compose

Download Compose file

wget git.io/aria2-pro.yml

Edit Compose file

vim aria2-pro.yml

Compose up

docker-compose -f aria2-pro.yml up -d

Other

Parameters

Parameter	Function
`-e PUID=$UID` `-e PGID=$GID`	Bind UID and GID to the container, which means you can use a non-root user to manage downloaded files.
`-e UMASK_SET=022`	For umask setting of Aria2, optional , default if left unset is `022`
`-e RPC_SECRET=<TOKEN>`	Set RPC secret authorization token. Default: `P3TERX`
`-e RPC_PORT=6800`	Set RPC listen port.
`-p 6800:6800`	bind RPC listen port.
`-e LISTEN_PORT=6888`	Set TCP/UDP port number for BitTorrent/DHT listen.
`-p 6888:6888`	Bind BT listen port (TCP).
`-p 6888:6888/udp`	Bind DHT lisen port (UDP).
`-v <PATH>:/config`	Contains all relevant configuration files.
`-v <PATH>:/downloads`	Location of downloads on disk.
`-e DISK_CACHE=<SIZE>`	Set up disk cache. SIZE can include `K` or `M` (1K = 1024, 1M = 1024K), e.g `64M`.
`-e IPV6_MODE=<BOOLEAN>`	Whether to enable IPv6 support for Aria2. Optional: `true` or `false`. Set the options `disable-ipv6=false` and `enable-dht6=true` in the configuration file(aria2.conf).
`-e UPDATE_TRACKERS=<BOOLEAN>`	Whether to update BT Trackers List automatically. Optional: `true` or `flase`, default if left unset is `true`
`-e CUSTOM_TRACKER_URL=<URL>`	Custom BT Trackers List URL. If not set, it will be get from https://trackerslist.com/all_aria2.txt.
`-e TZ=Asia/Shanghai`	Specify a timezone to use e.g. `Asia/Shanghai`

Advanced

I am working hard on my English, so this part may be explained in detail later. If you can read Chinese, read the details in my blog.

Credits

License

MIT © P3TERX