mirror of
https://github.com/casjaysdevdocker/aria2
synced 2026-06-23 20:01:01 -04:00
jason
72fe4eb95a
--domainname on the container sets the kernel domainname, which c-ares uses to infer a search domain even when /etc/resolv.conf has no search line. This caused c-ares to query github.com.casjay.work AAAA and get the host's own IPv6 address, routing all outbound HTTPS to the local nginx instead of the real server. Adding 'search .' and 'options ndots:0' explicitly disables search domain inference regardless of the kernel domainname setting. - rootfs/usr/local/etc/resolv.conf: add search . and options ndots:0 rootfs/usr/local/etc/resolv.conf
👋 Welcome to aria2 🚀
A self-contained Docker image running aria2c (multi-protocol download daemon) with the AriaNg web UI served by nginx. Supports HTTP/HTTPS, FTP, BitTorrent, Metalink, and WebSocket RPC.
🚀 Quick start
docker run -d \
--restart always \
--name casjaysdevdocker-aria2 \
--hostname aria2 \
-e TZ=${TIMEZONE:-America/New_York} \
-v /srv/docker/aria2/config:/config:z \
-v /srv/docker/aria2/data:/data:z \
-p 80:80 \
-p 6800:6800 \
-p 6888:6888 \
casjaysdevdocker/aria2:latest
Open http://localhost to access the AriaNg web interface.
🐳 docker-compose
version: "2"
services:
aria2:
image: casjaysdevdocker/aria2:latest
container_name: casjaysdevdocker-aria2
hostname: aria2
restart: always
environment:
- TZ=America/New_York
volumes:
- /srv/docker/aria2/config:/config:z
- /srv/docker/aria2/data:/data:z
ports:
- 80:80 # AriaNg web UI + proxied RPC
- 6800:6800 # aria2c direct JSON-RPC / WebSocket
- 6888:6888 # BitTorrent peer / DHT
🔧 Environment variables
| Variable | Default | Description |
|---|---|---|
TZ |
America/New_York |
Container timezone |
RPC_PORT |
6800 |
aria2c RPC listen port |
RPC_SECRET |
(unset) | aria2c RPC secret token (blank = no auth) |
CUSTOM_TRACKER_URL |
(unset) | URL to fetch fresh BT tracker list (P3TERX format) |
📁 Volumes
| Path | Purpose |
|---|---|
/config |
User-editable config — aria2/aria2.conf, aria2/aria2.session, nginx/nginx.conf, AriaNg client config |
/data |
Downloads at /data/downloads/aria2/; logs at /data/logs/{aria2,nginx}/ |
Seeded on first run from the image defaults. Edit /config/aria2/aria2.conf to tune aria2c; restart the container to apply.
🌐 Ports
| Port | Protocol | Purpose |
|---|---|---|
80 |
TCP | AriaNg web UI (nginx); also proxies /jsonrpc and /rpc to aria2c |
6800 |
TCP | aria2c JSON-RPC / WebSocket (direct, bypasses nginx) |
6888 |
TCP/UDP | BitTorrent peer connections and DHT |
🔨 Build from source
git clone "https://github.com/casjaysdevdocker/aria2" "$HOME/Projects/github/casjaysdevdocker/aria2"
cd "$HOME/Projects/github/casjaysdevdocker/aria2"
# pre-bundle AriaNg (required before buildx — GitHub SSL is blocked inside the sandbox)
mkdir -p rootfs/tmp/ariang-src
curl -fsSL -o rootfs/tmp/ariang-src/AriaNg-1.3.13.zip \
https://github.com/mayswind/AriaNg/releases/download/1.3.13/AriaNg-1.3.13.zip
buildx