Installation · Linux

aria2 unter Linux installieren

Jede große Distribution bietet aria2 als Paket an, daher installiert es ein einziger Befehl. Ältere Releases liefern ältere Versionen; die Tabelle zeigt, welche.

Zuletzt aktualisiert: Getestet mit aria2 1.37.0

Mit einem Befehl installieren

Wählen Sie Ihre Distribution und führen Sie die Zeile in einem Terminal aus.

sudo apt install aria2

Auch Linux Mint, Pop!_OS und Raspberry Pi OS.

Installation prüfenaria2c --versionaria2 version 1.37.0

Welche Version liefert Ihre Distribution?

Am 2026-10-27 aus dem Paketarchiv jeder Distribution ausgelesen. 1.37.0 ist das aktuelle Release von aria2.

DistributionReleasearia2
Ubuntu24.04 LTS und neuer1.37.0
Ubuntu22.04 LTS1.36.0
Debian13 trixie1.37.0
Debian12 bookworm1.36.0
Fedoraaktuell1.37.0
RHEL, Rocky, AlmaLinux (EPEL)101.37.0
RHEL, Rocky, AlmaLinux (EPEL)91.36.0
openSUSETumbleweed1.37.0
Arch LinuxRolling Release1.37.0
Alpineedge1.37.0
conda-forgejede Distribution1.37.0

Das aktuelle Release aus dem Quellcode bauen

Nur nötig, wenn Ihre Distribution eine ältere Version liefert und Sie etwas aus 1.37.0 brauchen. Dies sind die Schritte aus dem aria2-README für Debian und Ubuntu.

  1. Build-Werkzeuge und Bibliotheken installieren

    Die Paketnamen gelten für Debian und Ubuntu; andere Distributionen haben dieselben Bibliotheken unter ähnlichen Namen.

    sudo apt install build-essential pkg-config libssl-dev libssh2-1-dev libc-ares-dev libxml2-dev zlib1g-dev libsqlite3-dev
  2. Das Release herunterladen und entpacken

    Der Release-Tarball enthält das configure-Skript bereits.

    curl -LO https://github.com/aria2/aria2/releases/download/release-1.37.0/aria2-1.37.0.tar.xztar xf aria2-1.37.0.tar.xz && cd aria2-1.37.0
  3. Bauen und installieren

    configure gibt aus, welche Funktionen es gefunden hat; prüfen Sie, dass bei HTTPS, BitTorrent und Metalink yes steht. Das Programm landet in /usr/local/bin.

    ./configuremake -j"$(nproc)"sudo make install

Wo aria2.conf unter Linux liegt

aria2 liest ~/.aria2/aria2.conf oder, falls diese nicht existiert, $XDG_CONFIG_HOME/aria2/aria2.conf. Legen Sie den Ordner, eine leere Sitzungsdatei und die Konfigurationsdatei an:

mkdir -p ~/.aria2 && touch ~/.aria2/aria2.sessionnano ~/.aria2/aria2.conf

Konfigurator →

aria2 als Dienst ausführen

Ein systemd-Benutzerdienst startet aria2 bei der Anmeldung und startet es neu, wenn es sich beendet. Speichern Sie dies als ~/.config/systemd/user/aria2.service:

~/.config/systemd/user/aria2.service
[Unit]
Description=aria2 download server
After=network-online.target

[Service]
ExecStart=/usr/bin/aria2c --conf-path=%h/.aria2/aria2.conf
Restart=on-failure

[Install]
WantedBy=default.target

Führen Sie dann systemctl --user enable --now aria2 aus. Damit der Dienst nach dem Abmelden weiterläuft, führen Sie zusätzlich loginctl enable-linger $USER aus. Für einen Server oder ein NAS enthält der Docker-Leitfaden einen getesteten Container.

Aktualisieren und deinstallieren

apt
sudo apt upgrade aria2 · sudo apt remove aria2
dnf
sudo dnf upgrade aria2 · sudo dnf remove aria2
pacman
sudo pacman -Syu · sudo pacman -R aria2
Eigener Build
Im Quellcode-Ordner: sudo make uninstall

Häufige Probleme unter Linux

error while loading shared libraries

Ein von anderswo kopiertes aria2c braucht Bibliotheken, die Ihrem System fehlen. Installieren Sie aria2 stattdessen über Ihren Paketmanager; er bringt die richtigen Bibliotheken mit.

SSL-Zertifikatsfehler auf minimalen Systemen

Containern und Minimalinstallationen fehlt möglicherweise das CA-Bundle. Installieren Sie ca-certificates (apk add ca-certificates unter Alpine).

Ein Daemon speichert Dateien am falschen Ort

Mit -D arbeitet aria2 von / aus, sodass relative Pfade unter / landen. Verwenden Sie absolute Pfade für dir und die Sitzungsdatei.

Häufige Fragen

Wie installiere ich aria2 auf dem Raspberry Pi?
Raspberry Pi OS basiert auf Debian, daher funktioniert sudo apt install aria2. Die Version folgt Debian: 1.36.0 bei Releases auf Basis von bookworm, 1.37.0 bei solchen auf Basis von trixie.
Kann ich aria2 ohne root installieren?
Ja, mit conda oder mamba aus conda-forge in Ihrem Home-Ordner oder durch einen eigenen Build aus dem Quellcode mit ./configure --prefix=$HOME/.local.
Kann ich aria2 mit pip installieren?
Nicht das offizielle Programm. pip install aria2p installiert einen Python-Client, der ein laufendes aria2 über RPC steuert. Ein pip-Paket namens aria2 existiert, ist aber ein inoffizieller Wrapper im Beta-Stadium (0.0.1b0).
Reicht 1.36.0 aus Ubuntu 22.04 aus?
Für alltägliche Downloads ja. 1.37.0 bringt vor allem Fehlerkorrekturen; aktualisieren Sie, wenn Sie auf ein Problem stoßen, das die neuere Version behoben hat.

Installiert? Hier geht es weiter