快速轻量的
下载管理器。
aria2是支持HTTP、FTP、BitTorrent和Metalink的免费开源命令行工具。每个下载最多开启16个并行连接，内存占用不足9 MiB，支持Windows、macOS和Linux。
下载并安装 aria2
aria2 支持所有主流操作系统。在下方选择你的平台，5 分钟内快速上手：
通过 Windows 包管理器 (Winget) 安装
在 CMD 或 PowerShell 中运行（无需管理员权限）：
在终端中验证
在终端中检查版本号以确认程序已成功加入环境变量 PATH：
通过 Scoop 安装
在用户空间安装 aria2 并自动配置 PATH 环境变量：
通过 Chocolatey 安装
在以管理员身份运行的 PowerShell 窗口中执行：
解压至 C:\aria2
将 aria2c.exe 解压到一个固定目录，例如 C:\aria2。
添加至 Windows 环境变量 PATH
将 C:\aria2 添加到用户或系统的环境变量 (Path)中。
验证安装
在 CMD 或 PowerShell 中运行 aria2c --version 检查。
Homebrew
确保你的 Mac 已安装 Homebrew 包管理器。
安装
打开 macOS 终端并运行：brew install aria2
验证安装
运行 aria2c --version 验证版本号。
Ubuntu / Debian
通过 APT 安装官方软件包。
sudo apt install aria2
Fedora
使用 DNF 包管理器安装。
sudo dnf install aria2
Arch Linux
从 Arch Linux 官方社区仓库安装。
sudo pacman -S aria2
CentOS / RHEL
aria2 位于 EPEL 软件源：先启用 EPEL，再用 DNF 安装。
sudo dnf install epel-release && sudo dnf install aria2
为什么 aria2 速度极快？核心架构解析
aria2 采用多源并行传输架构实现超强下载速度。与单连接工具不同，它将每个文件切分为多个分块，并同时从多个镜像服务器或 BitTorrent 节点抓取，彻底突破单连接速率限制。
多连接与多源分块下载
aria2 能够同时从多个不同的 HTTP/FTP 服务器或 BitTorrent 节点并发下载同一个文件的不同区块，显著提升下载速度并彻底榨干带宽。
极致轻量与低内存占用
极致轻量级资源占用。物理内存占用通常仅为 4MiB 至 9MiB。即使在后台以 2.8MiB/s 的速度进行 BT 下载，CPU 占用率也仅约 6%。
全功能 BitTorrent / 磁力客户端
全功能命令行 BitTorrent 客户端。完整支持 DHT、PEX 对等节点交换、数据加密传输、磁力链接 (Magnet URI)、Web-Seeding 与本地节点发现。
JSON-RPC 远程控制与开放接口
轻松将 aria2 接入你的应用程序。提供功能强大的 XML-RPC 和 JSON-RPC 接口，社区已有数十款基于此接口开发的 WebUI 与桌面图形客户端。
aria2 vs wget vs curl：横向速度与特性全方位对比
对于大文件下载，aria2 的速度远超 wget 和 curl。 wget 和 curl 仅使用单连接顺序下载，而 aria2 可同时开启高达 16 条并行连接拉满带宽。此外，aria2 还独家支持 BitTorrent、Metalink 和 JSON-RPC 远程控制，这些是 wget 和 curl 完全不具备的。
| 核心特性 / 指标 | aria2 | wget | curl |
|---|---|---|---|
| Multi-Connection (Chunking) | |||
| BitTorrent 与 DHT 网络支持 | |||
| 后台守护进程 / JSON-RPC 模式 | |||
| HTTP / HTTPS / FTP 多协议支持 |
常用 CLI 命令速查手册
日常下载中最常用的核心 aria2 命令行代码片段，即拷即用。
基础单文件下载
最基础的单文件 HTTP/HTTPS 或 FTP 下载方式。
16 线程极速下载 (多连接并发)
通过将文件切分为 16 条并发连接，彻底跑满带宽物理速率。
$aria2c -x 16 -s 16 https://example.com/file.zip
BitTorrent 种子文件下载
原生解析并下载本地 .torrent 种子文件并自动连接做种节点。
$aria2c file.torrent
磁力链接 (Magnet URI) 下载
直接通过磁力哈希链接从 DHT 网络获取元数据并开启高速下载。
$aria2c "magnet:?xt=urn:btih:..."
断点续传恢复下载
使用 -c 参数从上次中断的数据块位置无缝继续下载。
$aria2c -c https://example.com/file.zip
限制全局下载速度
限制最大下载速率，避免挤占局域网其他业务带宽。
$aria2c --max-download-limit=1M https://...
批量 URL 列表读取下载
使用 -i 参数批量读取文本文件中的下载链接并依次/并行抓取。
$aria2c -i urls.txt
指定文件下载输出目录
自定义目标保存路径，将下载文件直接写入指定目录。
$aria2c -d /home/user/Downloads https://...
交互式 aria2.conf 配置文件生成器
定制你的极速后台下载引擎。通过下方开关调节参数，一键复制生成的配置至 ~/.aria2/aria2.conf。
如何将 aria2 与 yt-dlp、Docker 及 Python 深度集成
aria2 可原生作为 yt-dlp、Docker 容器、Python/Node 脚本及 systemd 服务的下载加速引擎。在 yt-dlp 中传入 --external-downloader aria2c 即可让每个文件通过多连接并行下载。通过 6800 端口的 JSON-RPC 接口轻松实现代码级远程调用与自动化控制。
使用 aria2 加速 yt-dlp 视频下载
突破视频站点单线程限速 — 将 aria2 作为 yt-dlp 外部下载引擎，通过多连接并发下载：
yt-dlp --external-downloader aria2c --external-downloader-args "-x 16 -s 16" ...
Aria2 Pro 与群晖 / 威联通 NAS 部署
在群晖 Container Manager、威联通 Container Station 或 Unraid 上部署支持自动更新 Tracker 的 p3terx/aria2-pro 高性能镜像：
ports: ["6800:6800", "6888:6888"]
OpenWrt 路由器与 AriaNg 搭配
通过 opkg 包管理器将 OpenWrt 软路由打造为 24 小时全天候静音离线下载机：
树莓派 (Raspberry Pi) 低功耗下载机
在树莓派 3/4/5 (Raspberry Pi OS) 上搭建超低功耗、全天候高速离线下载盒：
Google Drive 与网盘大文件加速
结合浏览器 Cookie 与 16 连接分块加速，高速下载 Google Drive 大文件：
HTTP 代理转发
让 HTTP、HTTPS 和 FTP 下载经由 HTTP 代理。aria2 不支持 SOCKS 代理——如需走 SOCKS5 隧道，请在前面加一个 HTTP 转 SOCKS 的桥接工具（如 privoxy 或 gost）。BitTorrent 的 Peer 连接和 DHT 流量不会经过代理。
WebSocket 与 JSON-RPC 远程调用
启用基于 WebSocket (ws://127.0.0.1:6800/jsonrpc) 的 JSON-RPC 服务，畅享毫秒级 WebUI 实时同步：
浏览器自动拦截与下载接管
自动拦截浏览器所有网页下载，完整传递登录态 Cookie 与 Referer 来源保护：
aria2c --enable-rpc --rpc-allow-origin-all=true --rpc-secret=YOUR_SECRET
BitTorrent 节点与速度调优
消除机械硬盘 IOPS 瓶颈，开启内存写入缓存，并发连接数百个活跃做种节点：
.aria2 二进制控制文件解析与修复
深入理解 .aria2 文件二进制协议规范，拯救卡死任务并实时恢复断点：
常见错误排查与解决方案
整理运行 aria2 时最常见报错的快速修复对策。
提示缺少依赖：error while loading shared libraries: libxml2.so.2 / libsqlite3.so.0
说明系统环境中缺少动态依赖库。在 Debian/Ubuntu 上运行 sudo apt install libxml2 libsqlite3-0；在 RHEL/CentOS 上使用 sudo yum install libxml2 sqlite 安装即可。
$sudo apt install libxml2 libsqlite3-0 zlib1g
在 Windows 上，请确保 .exe 与其自带的 DLL 文件一起保留在解压后的文件夹中。
SSL 证书验证失败：unable to verify certificate
通常是由于旧系统中的 CA 根证书过期导致的。可以通过更新根证书解决：sudo apt install ca-certificates，或在临时调试时追加 --check-certificate=false。
aria2c --check-certificate=false https://...
要彻底解决，请更新系统证书：sudo apt install ca-certificates。
aria2 下载速度缓慢 — 如何彻底提速跑满带宽？
默认情况下，aria2 较为保守，以避免被服务器封禁。若要跑满带宽，请强制使用并行连接与分片：
提示：如果使用 HDD，请添加 --file-allocation=falloc 以防止磁盘碎片导致降速。
目录权限拒绝报错：errorCode=16 Failed to open the file …, cause: Permission denied
运行 aria2 的系统用户对下载保存目录没有写入权限。使用 ls -ld /path/to/dir 检查权限，并通过 chmod 755 /path/to/dir 或 chown -R user:user /path/to/dir 赋予权限。
aria2c -d ~/Downloads https://...
磁力链接无法启动或提示 "Command Not Found"
这通常是因为磁力链接中包含 & 或 ? 等特殊字符，被命令行终端 (Bash/Zsh/CMD) 截断解析。请务必将磁力链接用双引号包裹：
端口绑定失败：Failed to bind socket (6800 端口已被占用)
后台已有另一个 aria2 进程或其它程序占用了 6800 端口。在任务管理器中结束对应进程，或指定备用端口：aria2c --rpc-listen-port=6801。
aria2c --rpc-listen-port=6801
BitTorrent 下载没有 Peers 节点或速度显示 0 KB/s
防火墙或路由器可能阻断了默认 BT 端口。请确保放行 6881-6999 端口，开启 enable-dht=true，并从我们的 BT Tracker 节点中心 导入最新活跃节点。
aria2c --enable-dht=true --bt-enable-lpd=true mytorrent.torrent
常见问题
快速解答、常见问题与核心概念，尽在一处。
什么是 aria2？
aria2 是一款采用高性能 C++ 编写的免费开源命令行下载管理器。支持 HTTP、HTTPS、FTP、SFTP、BitTorrent 和 Metalink，物理内存占用仅需 4–9 MiB，全面支持 Windows、macOS、Linux 和 Android。
如何在 Linux 上安装 aria2？
Ubuntu/Debian: sudo apt install aria2。Fedora: sudo dnf install aria2。Arch: sudo pacman -S aria2。Android (Termux): pkg install aria2。
如何在 Windows 上安装 aria2？
推荐使用系统包管理器：winget install aria2.aria2 或 scoop install aria2，也可以从 GitHub Releases 下载便携版 ZIP 并将 aria2c.exe 添加至系统 PATH。
如何在 macOS 上安装 aria2？
运行 brew install aria2（需预先安装 Homebrew）。安装后通过 aria2c --version 验证。
如何最大化 aria2 下载速度？
在命令中使用 aria2c -x 16 -s 16 https://example.com/file.zip。-x 16 参数开启单服务器 16 条连接；-s 16 将文件切分成 16 个并发分块，瞬间榨干带宽速率。
如何将 aria2 与 yt-dlp 搭配使用？
在 yt-dlp 命令中添加 --external-downloader aria2c 参数即可将下载任务转交给 aria2。这将开启多线程音视频流并发切片，有效突破视频平台的单线程限速。
aria2 安全可靠吗？是否有后门或遥测？
绝对安全。aria2 是一款在 GitHub 上拥有数万 Star 的纯开源轻量工具，零间谍软件、零追踪遥测，且不含任何捆绑插件。当然，如同任何下载引擎一样，请确保您下载的具体文件来源安全可靠。
aria2 是否比传统工具（如 wget 和 curl）更快？
对于大文件下载，aria2 显著更快。 wget 和 curl 默认仅使用单个 TCP 连接顺序下载，而 aria2 专为多连接并发设计，可同时向同一文件（或多个镜像源）发起多达 16 条连接，瞬间跑满物理带宽。
如何为 aria2 配置网络代理？
aria2 通过 --all-proxy 参数支持 HTTP 代理（HTTPS 下载通过 CONNECT 隧道），可附带用户名和密码。aria2 不支持 SOCKS4/SOCKS5 代理，如有需要请使用 privoxy 或 gost 等本地 HTTP 转 SOCKS 桥接工具。
# HTTP 代理示例: aria2c --all-proxy="http://user:pass@127.0.0.1:8080" https://...
aria2 能直接下载 YouTube 视频吗？
原生不支持。aria2 是纯粹的底层传输引擎，无法解析 YouTube 的流媒体加密算法。但您可以将 yt-dlp 的外部下载器配置为 aria2：yt-dlp --external-downloader aria2c --external-downloader-args "-x 16" <URL>
如何将 aria2 作为后台守护进程 (Daemon) 常驻运行？
启动时同时传入 --daemon=true 与 --enable-rpc=true 参数即可。aria2 将脱离终端并在后台静默监听 6800 端口，供 AriaNg 等 WebUI 随时连接控制：aria2c --daemon=true --enable-rpc=true
aria2 相比 IDM (Internet Download Manager) 有何优劣？
取决于具体需求。IDM 是一款仅限 Windows 的商业闭源软件，以浏览器深度集成见长。aria2 则是完全免费开源的 C++ 底层引擎，全平台通用（Windows/Linux/macOS/Docker/NAS），支持 BT/磁力与 RPC 远程调用，在服务器自动化与极客高并发场景下具有压倒性优势。
如何让 Chrome 或 Firefox 浏览器自动调用 aria2 下载？
在浏览器中安装扩展：Aria2 Explorer（Chrome/Edge）或 aria2-integration（Firefox）。这些插件会自动拦截网页下载请求并将其无缝转发至 localhost:6800 的本地 aria2 守护进程。
电脑意外断电或重启后，aria2 是否支持断点续传？
完全支持。通过 --save-session 与 --input-file 设定进度保存文件；下次启动时会自动恢复中断任务。对于单个直链文件，在相同目录下执行 aria2c -c <URL> 即可无缝续传。
如何使用 aria2 下载 Google Drive 等网盘大文件？
Google Drive 大文件需要鉴权 Cookie。使用 --header 参数传入浏览器的登录 Cookie，或使用 gdown 等工具提取直链后交由 aria2 进行 16 线程高速下载。
aria2 的理论最高下载速度是多少？
软件层面无任何速率限制。基于极速 C++ 编写，aria2 的实际吞吐量仅受限于您的物理网络带宽与硬盘写入速度，已在 10Gbps+ 万兆专线 上通过测试且 CPU 占用率极低。