mirror of
https://github.com/casjaysdevdocker/aria2
synced 2026-06-23 20:01:01 -04:00
jason
fdc794b6cb
Hosts with a search domain cause containers to inherit it. When the zone has a wildcard AAAA record, public hostnames resolve to the host's own IPv6 address instead of the real server, breaking all outbound HTTPS and DNS from inside the container. The entrypoint already has a hook: if /usr/local/etc/resolv.conf exists it replaces /etc/resolv.conf at container startup. Ship a clean resolv.conf with Cloudflare + Google DNS and no search domain so container DNS is always correct regardless of host configuration. - rootfs/usr/local/etc/resolv.conf: new file — clean DNS, no search domain 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