aria2
中文
安装 · Linux

在 Linux 上安装 aria2

各主流发行版都打包了 aria2，一条命令即可安装。较旧的发行版版本提供的是较旧的 aria2；下表列出了具体版本。

最后更新: 已用 aria2 1.37.0 测试

一条命令安装

选择你的发行版，在终端中运行对应的那一行。

sudo apt install aria2

也适用于 Linux Mint、Pop!_OS 和 Raspberry Pi OS。

确认安装aria2c --versionaria2 version 1.37.0

你的发行版提供哪个版本？

于 2026-10-27 从各发行版的软件包仓库读取。1.37.0 是 aria2 的当前版本。

发行版发行版本aria2
Ubuntu24.04 LTS 及更新版本1.37.0
Ubuntu22.04 LTS1.36.0
Debian13 trixie1.37.0
Debian12 bookworm1.36.0
Fedora当前版本1.37.0
RHEL, Rocky, AlmaLinux (EPEL)101.37.0
RHEL, Rocky, AlmaLinux (EPEL)91.36.0
openSUSETumbleweed1.37.0
Arch Linux滚动更新1.37.0
Alpineedge1.37.0
conda-forge任意发行版1.37.0

从源码编译当前版本

只有当你的发行版提供的是旧版本，而你需要 1.37.0 中的某些改进时才需要。以下是 aria2 README 中针对 Debian 和 Ubuntu 的步骤。

  1. 安装编译工具和库

    软件包名称适用于 Debian 和 Ubuntu；其他发行版也有这些库，名称相近。

    sudo apt install build-essential pkg-config libssl-dev libssh2-1-dev libc-ares-dev libxml2-dev zlib1g-dev libsqlite3-dev

  2. 下载并解压发布包

    发布的 tarball 中已经包含 configure 脚本。

    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. 编译并安装

    configure 会打印它找到了哪些功能；检查 HTTPS、BitTorrent 和 Metalink 是否显示 yes。程序会安装到 /usr/local/bin。

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

Linux 上 aria2.conf 的位置

aria2 读取 ~/.aria2/aria2.conf；如果它不存在，则读取 $XDG_CONFIG_HOME/aria2/aria2.conf。创建文件夹、一个空的会话文件和配置文件：

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

配置生成器 →

把 aria2 作为服务运行

systemd 用户服务会在登录时启动 aria2，并在它停止时重新启动。把下面的内容保存为 ~/.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

然后运行 systemctl --user enable --now aria2。要在注销后继续运行，还需运行 loginctl enable-linger $USER。在服务器或 NAS 上，Docker 指南提供了经过测试的容器。

更新与卸载

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
源码编译
在源码文件夹中运行 sudo make uninstall

Linux 上的常见问题

error while loading shared libraries

从别处复制来的 aria2c 需要你的系统缺少的库。请改用包管理器安装 aria2，它会带上正确的库。

精简系统上的 SSL 证书错误

容器和最小化安装的系统可能缺少 CA 证书包。请安装 ca-certificates（在 Alpine 上运行 apk add ca-certificates）。

守护进程把文件保存到了错误的位置

使用 -D 时，aria2 的工作目录是 /，所以相对路径最终都落在 / 下。dir 和会话文件请使用绝对路径。

常见问题

如何在树莓派上安装 aria2？
Raspberry Pi OS 基于 Debian，所以 sudo apt install aria2 即可。版本跟随 Debian：基于 bookworm 的版本是 1.36.0，基于 trixie 的版本是 1.37.0。
没有 root 权限能安装 aria2 吗？
可以：在你的主目录中用 conda 或 mamba 从 conda-forge 安装，或者用 ./configure --prefix=$HOME/.local 从源码编译。
能用 pip 安装 aria2 吗？
官方程序不能。pip install aria2p 安装的是一个 Python 客户端，它通过 RPC 控制正在运行的 aria2。确实有一个名为 aria2 的 pip 包，但它是处于测试阶段的非官方封装（0.0.1b0）。
Ubuntu 22.04 中的 1.36.0 够用吗？
日常下载够用。1.37.0 主要是修复；如果你遇到了新版本已解决的问题，再升级。

装好了？从这里开始