Awesome
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 <br>-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