aria2/README.md at 4b80ec9839cdead89eb5c3416f4024feec26abfa

casjaysdevdocker/aria2

Fork 0

mirror of https://github.com/casjaysdevdocker/aria2 synced 2026-05-19 02:47:48 -04:00

Files

casjay 4b80ec9839

aria2 / release-aria2 (push) Failing after 6m58s

Details

🔧 Update configuration files 🔧

AI.md
CLAUDE.md
Dockerfile
.env.scripts
IDEA.md
README.md
rootfs/root/docker/setup/00-init.sh
rootfs/root/docker/setup/01-system.sh
rootfs/root/docker/setup/02-packages.sh
rootfs/root/docker/setup/03-files.sh
rootfs/root/docker/setup/04-users.sh
rootfs/root/docker/setup/06-post.sh
rootfs/root/docker/setup/07-cleanup.sh
rootfs/usr/local/bin/entrypoint.sh
rootfs/usr/local/etc/docker/functions/entrypoint.sh
rootfs/usr/local/etc/docker/init.d/00-aria2c.sh
TODO.AI.md

2026-05-18 15:38:20 -04:00

2.7 KiB

Raw Blame History

👋 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

👤 Authors

🤖 casjay: Github 🤖 ⛵ casjaysdevdocker: Github Docker ⛵

2.7 KiB Raw Blame History