Aria2 Next 是一款重新定义下一代 aria2 的跨平台下载工具，完整保留 aria2 的命令行、配置文件、会话文件与 JSON-RPC/XML-RPC 接口，底层由 libcurl、libtorrent、GPAC/FFmpeg 等成熟库驱动，支持 HTTP/HTTPS、SFTP、BitTorrent、ED2K/Kad、Metalink 与 HLS/DASH 协议。本文是一份完整的Aria2 Next 安装指南，覆盖 Linux、Windows、macOS、Android 四大平台，并附带 Docker 部署与源码编译方案，帮你在 5 分钟内跑起自己的下载引擎。

安装前准备：各平台支持一览 💡

Aria2 Next 官方为每个平台提供独立的可执行文件，无需安装运行时依赖，下载即用。各平台对应的 Release 产物如下（版本以<version>占位，请到项目 Release 页面获取最新构建）：

⚠️安全提示：下载后建议用校验和文件核对二进制完整性，例如 Linux/macOS 下执行sha256sum -c aria2-next-<version>-checksums.sha256。

不同平台的依赖边界在 packaging/README.md 中有详细说明：Linux 可使用系统 C 运行时；macOS 只链接 Apple 系统库；Windows 的 HTTPS 走 Schannel、RPC 加密使用静态链接 OpenSSL，只需 Windows 系统自带 DLL；Android 只链接系统运行时库，不要求libc++_shared.so。

Linux 安装步骤

第 1 步：下载并授权执行

从 Release 页面下载对应架构的二进制，然后赋予可执行权限：

chmod +x ./aria2-next-<version>-linux-x86_64 ./aria2-next-<version>-linux-x86_64 --version

第 2 步：加入 PATH（可选）

sudo install -m 755 ./aria2-next-<version>-linux-x86_64 /usr/local/bin/aria2-next

之后任意目录都能直接输入aria2-next使用。

Docker 部署（推荐服务器用户）📦

Linux 还提供官方容器镜像，基于 Ubuntu 22.04 基线构建，支持 x86_64 与 ARM64。镜像定义与启动脚本见 packaging/docker/compose.yml 和 packaging/docker/entrypoint.sh。

docker run -d --name aria2-next \ -p 6800:6800 \ -e PUID="$(id -u)" \ -e PGID="$(id -g)" \ -v "$PWD/downloads:/downloads" \ -v "$PWD/config:/config" \ -v "$PWD/state:/var/lib/aria2-next" \ ghcr.io/aninsomniacy/aria2-next:latest

或一行启动 Compose：

PUID="$(id -u)" PGID="$(id -g)" docker compose -f packaging/docker/compose.yml up -d

⚠️ 启动脚本会校验挂载目录的可写性，PUID/PGID必须为数字且为必填项。将 RPC 暴露到非可信网络前，请加上--rpc-secret=<token>开启密钥认证。

Windows 安装步骤

Windows 版的安装最简单——单文件.exe，无安装向导：

1. 从 Release 页面下载aria2-next-<version>-windows-x86_64.exe（ARM 设备选windows-arm64.exe）；
2. 双击或放入命令行直接运行，无需任何依赖，HTTPS 证书校验由系统 Schannel 完成；
3. 建议将 exe 放入独立目录并加入PATH，方便全局调用：

aria2-next-2.0.0-windows-x86_64.exe https://example.com/file.iso aria2-next-2.0.0-windows-x86_64.exe "magnet:?xt=urn:btih:..."

💡 开启远程 RPC 接口（供前端面板连接）：

aria2-next --enable-rpc --rpc-listen-port=6800

macOS 安装步骤

根据芯片选择对应产物（终端执行uname -m可查看：arm64为 Apple Silicon，x86_64为 Intel）：

# Apple Silicon chmod +x ./aria2-next-<version>-macos-arm64 sudo install ./aria2-next-<version>-macos-arm64 /usr/local/bin/aria2-next # Intel chmod +x ./aria2-next-<version>-macos-x86_64 sudo install ./aria2-next-<version>-macos-x86_64 /usr/local/bin/aria2-next

⚠️ 若下载过程中可执行位被清除，务必先执行chmod +x，否则会报Permission denied。macOS 二进制仅链接 Apple 系统库，不会拖入额外依赖。

证书校验走系统 SecTrust，也可用--ca-certificate指定自定义 CA 文件。

Android 安装步骤

Android 版为 ARM64 原生二进制，要求Android 7.0+，只链接 Android 系统运行时库，不依赖libc++_shared.so：

1. 将aria2-next-<version>-android-arm64通过 Termux、MT Manager 等工具放入有执行权限的目录（如 Termux 主目录）；
2. 赋予执行权限并验证：

chmod +x ./aria2-next-<version>-android-arm64 ./aria2-next-<version>-android-arm64 --version

3. 创建软链接方便调用：

ln -s $PWD/aria2-next-<version>-android-arm64 $PREFIX/bin/aria2-next

从源码编译（进阶）

如果你想要完全自主可控的构建，Aria2 Next 的 superbuild 会从仓库内置的 third_party/ 目录离线编译全部依赖，无需联网拉取库。

git clone https://gitcode.com/gh_mirrors/ar/aria2-next cd aria2-next cmake --preset default cmake --build --preset default ctest --preset default build/default/aria2-next --version

环境要求：CMake 3.25+、Ninja、POSIX shell、Make、Perl 与 C11/C++20 工具链；Windows 下由 MSYS2 提供 shell、Make 和 Perl，编译使用原生目标工具链。预设定义见 CMakePresets.json，构建选项包括ARIA2_ENABLE_WERROR、ARIA2_RELEASE_SIZE_OPTIMIZED、ARIA2_RELEASE_LTO，构建矩阵由 tools/build_test.sh 覆盖。

安装后的第一步：快速验证 ✅

三组命令快速确认安装成功：

# 1. 查看版本 aria2-next --version # 2. 下载一个文件 aria2-next https://example.com/file.iso # 3. 开启 RPC 接口（默认端口 6800） aria2-next --enable-rpc --rpc-listen-port=6800

常用参数速查：

• -d/--dir：下载目录；
• -j：并行任务数（默认 5）；
• -s/--split、-x：单任务连接数（默认各 16）；
• -c：断点续传；
• --help=#all：查看全部参数说明。

完整参数参考已生成在项目内，见 docs/options.md，配置文件的默认路径为$XDG_CONFIG_HOME/aria2/aria2.conf。进度信息保存在--state-dir下，任务崩溃后自动从最近检查点恢复，重启后暂停任务也能继续。

常见问题 FAQ 🙋

Q：Linux 下运行报 glibc 版本过低怎么办？A：官方二进制基线为 Ubuntu 22.04（glibc 2.35+）。老系统可以升级发行版、改用 Docker 镜像，或走源码编译路线。

Q：Aria2 Next 能兼容原有 aria2 的用法吗？A：可以。命令行选项、key=value配置文件、aria2 input-file 格式的会话文件、JSON-RPC/XML-RPC 接口全部保留；已废弃的选项会自动映射到替代项并给出一条警告。不支持 FTP、Metalink 3 和 JSONP。

Q：能下载 HLS/DASH 流媒体吗？A：可以，基于 GPAC 和 FFmpeg 实现选轨、直播录制与可续传分段，输出 MP4/Matroska 且无需转码，详见 docs/media-downloads.md。

Q：RPC 扩展接口有哪些？A：在标准 aria2 RPC 之外，还提供 ED2K、BitTorrent 与媒体相关的扩展方法，说明见 docs/rpc-extensions.md。

写在最后

至此，Aria2 Next 在 Linux、Windows、macOS 与 Android 四大平台的安装流程已全部覆盖。它既保留了你熟悉的 aria2 操作习惯，又用现代库重写了下载引擎内核，无论是日常命令行下载、服务器 Docker 部署，还是前端面板集成，都能开箱即用。更多架构细节可查阅 README.md 与 docs/architecture.md，祝下载愉快！🚀