Einen 24/7 aria2-Download-Server mit Docker betreiben

Voraussetzungen

• Docker Engine und Compose v2 (docker compose version).
• Ein Host mit einigen GB freiem Speicher – VPS, Mini-PC, Raspberry Pi oder NAS.
• Optional: eine Domain und ein Reverse-Proxy für HTTPS-Fernzugriff.
• Optional, aber empfohlen: einen BitTorrent-Port (TCP+UDP) am Router weiterleiten für gute Peer-Konnektivität.

Warum Docker und was wir bauen

aria2 in einem Container zu betreiben gibt Ihnen einen isolierten, reproduzierbaren, dauerhaft laufenden Downloader, den Sie aktualisieren oder verschieben können, ohne den Host anzufassen. Der Stack besteht aus drei unabhängigen Teilen:

Wir bauen unser eigenes kleines Image aus alpine. Das hält die Anleitung korrekt und portabel – ohne versteckte Umgebungsvariablen eines fremden Images, das Sie nicht einsehen können. (Community-Images sind eine Alternative als Abkürzung; prüfen Sie deren Variablen anhand ihrer eigenen Dokumentation.)

Die drei Dateien

Erstellen Sie einen Ordner (z. B. /opt/aria2) und legen Sie diese drei Dateien nebeneinander ab.

1. aria2.conf

dir=/downloads
continue=true
file-allocation=falloc
max-concurrent-downloads=5
max-connection-per-server=16
min-split-size=10M
split=16

# --- RPC (für jedes WebUI erforderlich) ---
enable-rpc=true
rpc-listen-all=true
rpc-listen-port=6800
rpc-secret=CHANGE_ME_STRONG_SECRET
# für Browser-WebUIs nötig; siehe Sicherheitshinweise
rpc-allow-origin-all=true

# --- BitTorrent ---
bt-max-peers=128
# listen ports must match the ports published in docker-compose.yml
listen-port=6888
dht-listen-port=6888
enable-dht=true
enable-peer-exchange=true
bt-enable-lpd=true
seed-ratio=1.0
disk-cache=64M

# --- Session-Persistenz (übersteht Neustarts) ---
save-session=/config/aria2.session
input-file=/config/aria2.session
save-session-interval=60
log=/config/aria2.log

2. Dockerfile

FROM alpine:3.20
RUN apk add --no-cache aria2 ca-certificates tzdata bash
COPY aria2.conf /etc/aria2/aria2.conf
VOLUME ["/downloads", "/config"]
EXPOSE 6800 6888 6888/udp
# aria2 refuses to start if input-file is missing, so create the session file first
ENTRYPOINT ["sh", "-c", "touch /config/aria2.session && exec aria2c --conf-path=/etc/aria2/aria2.conf"]

3. docker-compose.yml

services:
  aria2:
    build: .
    container_name: aria2
    restart: unless-stopped
    environment:
      - TZ=UTC
    volumes:
      - ./aria2-config:/config
      - ./downloads:/downloads
    ports:
      - "6800:6800"      # JSON-RPC (privat halten!)
      - "6888:6888"      # BitTorrent TCP
      - "6888:6888/udp"  # BitTorrent DHT UDP

Die Engine schreibt aria2.session und aria2.log nach ./aria2-config, sodass beide auf dem Host liegen und Neustarts sowie Image-Rebuilds überstehen.

In 5 Minuten bereitstellen

mkdir -p /opt/aria2/aria2-config /opt/aria2/downloads
cd /opt/aria2
# aria2.conf, Dockerfile und docker-compose.yml hier ablegen

docker compose up -d --build      # einmal bauen, dann starten
docker compose ps                 # prüfen, ob es läuft
docker compose logs -f aria2      # Start beobachten

Bestätigen Sie, dass der RPC-Endpunkt antwortet (Secret ersetzen):

curl -s http://127.0.0.1:6800/jsonrpc \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":"1","method":"aria2.getVersion","params":["token:CHANGE_ME_STRONG_SECRET"]}'

Eine JSON-Antwort mit einem version-Feld bedeutet: Engine und Secret sind korrekt.

Konfigurieren & absichern

Veröffentlichen Sie Port 6800 niemals im Internet. Binden Sie ihn an Host/LAN und erreichen Sie ihn über ein VPN oder einen authentifizierten Reverse-Proxy (siehe unten).

WebUI hinzufügen

Wählen Sie, was zu Ihrem Workflow passt:

• Nichts zu installieren: Öffnen Sie das Online-WebUI in einem beliebigen Browser und verbinden Sie sich mit dem RPC Ihres Servers (Host, Port 6800, Ihr Secret).
• Selbst gehostetes AriaNg: Stellen Sie die statischen AriaNg-Dateien mit nginx bereit und richten Sie sie auf den RPC aus. Fügen Sie diesen Dienst zur Compose-Datei hinzu, nachdem Sie ein AriaNg-Release nach ./ariang geladen haben:

  ariang:
    image: nginx:alpine
    container_name: ariang
    restart: unless-stopped
    volumes:
      - ./ariang:/usr/share/nginx/html:ro
    ports:
      - "6880:80"

Stellen Sie in den AriaNg-Einstellungen den RPC-Host auf Ihren Server, Port 6800, und fügen Sie das rpc-secret ein.

NAS & Plattformhinweise

Sicherer Fernzugriff (HTTPS-Reverse-Proxy)

Um das WebUI über das Internet zu erreichen, setzen Sie einen authentifizierten HTTPS-Proxy davor und legen Sie 6800 niemals offen. Moderne Browser blockieren zudem unverschlüsselten RPC von einer HTTPS-Seite (Mixed Content), daher brauchen Sie TLS + WebSocket-Weiterleitung.

server {
    listen 443 ssl;
    server_name aria2.example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    auth_basic "aria2";
    auth_basic_user_file /etc/nginx/.htpasswd;

    location / {
        proxy_pass http://127.0.0.1:6880;      # AriaNg
        proxy_set_header Host $host;
    }

    location /jsonrpc {
        proxy_pass http://127.0.0.1:6800/jsonrpc;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_read_timeout 86400;              # WebSocket am Leben halten
    }
}

Sicherheit schichten: HTTPS, eine Auth-Schicht (Basic Auth oder ein Identity-Proxy), ein starkes rpc-secret und eine Firewall. Ein VPN (WireGuard/Tailscale) ist der einfachste Weg, den Dienst gar nicht erst offenzulegen.

Automatisierung nach dem Download

aria2 führt nach Abschluss eines Downloads einen Befehl aus, gesteuert über on-download-complete. Fügen Sie ihn zu aria2.conf hinzu und binden Sie das Skript ein:

# in aria2.conf
on-download-complete=/config/on-complete.sh
on-download-error=/config/on-error.sh

# /config/on-complete.sh  (chmod +x)
#!/bin/bash
GID="$1"; NUM_FILES="$2"; TARGET_PATH="$3"   # $3 ist der Pfad der ersten Datei
logger "aria2 fertig: $TARGET_PATH"
# Beispiele:
#   rclone move "$(dirname "$TARGET_PATH")" remote:downloads/
#   unzip -o "$TARGET_PATH" -d "$(dirname "$TARGET_PATH")"
#   curl -s "https://ntfy.sh/mytopic" -d "Download fertig: $(basename "$TARGET_PATH")"

$1 = GID, $2 = Anzahl der Dateien, $3 = Pfad der ersten Datei. Halten Sie Hooks schnell und nicht blockierend; erledigen Sie die schwere Arbeit im Hintergrund.

Health & Monitoring

• Logs: docker compose logs -f aria2 (aria2 schreibt auch /config/aria2.log).
• Lebt es? Rufen Sie aria2.getVersion per JSON-RPC auf (siehe Deploy) oder prüfen Sie docker compose ps.
• Healthcheck hinzufügen zum Compose-Dienst, damit Docker eine hängende Engine neu starten kann:

    healthcheck:
      test: ["CMD-SHELL", "aria2c --version >/dev/null && wget -qO- http://127.0.0.1:6800/jsonrpc --post-data='{\"jsonrpc\":\"2.0\",\"id\":\"h\",\"method\":\"aria2.getVersion\",\"params\":[\"token:CHANGE_ME_STRONG_SECRET\"]}' >/dev/null"]
      interval: 60s
      timeout: 10s
      retries: 3

Fehlerbehebung

FAQ

Weiterführende Ressourcen

• Online-WebUI – diesen Server aus jedem Browser steuern
• BitTorrent-Tracker – Swarms gesund halten
• Optionsreferenz – jeder hier verwendete aria2.conf-Schlüssel
• Fehlerbehebung – häufige aria2-Fehler mit konkreten Lösungen
• Vollständige aria2-Dokumentation