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

• Docker templates for UNRAID
• Docker Tutorial for Synology DSM (Chinese)

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

• aria2
• P3TERX/aria2.conf
• P3TERX/Aria2-Pro-Core
• just-containers/s6-overlay
• XIU2/TrackersListCollection

License

MIT © P3TERX