全球极速开源
命令行下载引擎
支持 HTTP/HTTPS、FTP/SFTP、BitTorrent 与 Metalink。通过 16 线程多连接并行下载将宽带速度拉满，内存占用仅 4–9 MiB。
下载并安装 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
使用 YUM 包管理器安装。
sudo yum install aria2
包管理器安装
在 Termux 终端中运行：pkg install aria2
验证安装
运行：aria2c --version
为什么 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://...
图形客户端 (GUI) 与 Web 控制台全方位对比
aria2 是一款极其强悍的命令行下载引擎，但许多用户更青睐图形界面。以下是社区最受好评的可视化前端工具。
| GUI 前端客户端 | 支持平台 | 开源免费 | 适用场景 |
|---|---|---|---|
| Aria2App | Android | 移动端用户随时随地远程控制 | |
| AriaNg | Web UI | NAS 私有云与家庭服务器自建 | |
| Motrix | Windows / Mac / Linux | 初学者与喜欢开箱即用桌面客户端的用户 | |
| uGet | Linux Desktop | Linux 桌面深度原生集成 | |
| Aria2 Explorer | Chrome Extension | 浏览器自动接管下载与流量拦截 |
交互式 aria2.conf 配置文件生成器
定制你的极速后台下载引擎。通过下方开关调节参数，一键复制生成的配置至 ~/.aria2/aria2.conf。
如何将 aria2 与 yt-dlp、Docker 及 Python 深度集成
aria2 可原生作为 yt-dlp、Docker 容器、Python/Node 脚本及 systemd 服务的下载加速引擎。在 yt-dlp 中传入 --external-downloader aria2c 即可获得 10 倍视频极速下载。通过 6800 端口的 JSON-RPC 接口轻松实现代码级远程调用与自动化控制。
使用 aria2 加速 yt-dlp 视频下载
突破视频站点单线程限速 — 将 aria2 作为 yt-dlp 外部下载引擎，多连接并发加速提速 10 倍：
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 大文件：
SOCKS5 / HTTP 网络代理转发
将所有下载任务流量与 DHT Tracker 寻址请求通过本地 SOCKS5 代理安全转发：
WebSocket 与 JSON-RPC 远程调用
启用基于 WebSocket (ws://127.0.0.1:6800/jsonrpc) 的 JSON-RPC 服务，畅享毫秒级 WebUI 实时同步：
浏览器自动拦截与下载接管
自动拦截浏览器所有网页下载，完整传递登录态 Cookie 与 Referer 来源保护：
aria2c --enable-rpc --rpc-allow-origin-all=true
BitTorrent 节点与速度调优
消除机械硬盘 IOPS 瓶颈，开启内存写入缓存，并发连接数百个活跃做种节点：
.aria2 二进制控制文件解析与修复
深入理解 .aria2 文件二进制协议规范，拯救卡死任务并实时恢复断点：
常见错误排查与解决方案
整理运行 aria2 时最常见报错的快速修复对策。
提示缺少依赖：error while loading shared libraries: libxml2.so.2 / libsqlite.so.3
说明系统环境中缺少动态依赖库。在 Debian/Ubuntu 上运行 sudo apt install libxml2 libsqlite3-0；在 RHEL/CentOS 上使用 sudo yum install libxml2 sqlite 安装即可。
$sudo apt install libxml2 libsqlite3-dev zlib1g-dev
On Windows, ensure the .exe remained in its extracted folder containing the bundled DLL files.
SSL 证书验证失败：unable to verify certificate
通常是由于旧系统中的 CA 根证书过期导致的。可以通过更新根证书解决：sudo apt install ca-certificates，或在临时调试时追加 --check-certificate=false。
aria2c --check-certificate=false https://...
For a permanent fix, update your OS certificates: sudo apt install ca-certificates.
aria2 下载速度缓慢 — 如何彻底提速跑满带宽？
By default, aria2 is conservative to avoid server bans. To saturate your bandwidth, force parallel connections and chunking:
Tip: If using HDDs, add --file-allocation=falloc to prevent disk fragmentation slowdowns.
目录权限拒绝报错：Exception: [download_helper.cc:451] 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
Frequently Asked Questions
Quick answers, common issues, and core concepts — all in one place.
什么是 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 上拥有数万 Stars 的纯开源轻量工具，零间谍软件、零追踪遥测，且不含任何捆绑插件。当然，如同任何下载引擎一样，请确保您下载的具体文件来源安全可靠。
aria2 是否比传统工具（如 wget 和 curl）更快？
对于大文件下载，aria2 显著更快。 wget 和 curl 默认仅使用单个 TCP 连接顺序下载，而 aria2 专为多连接并发设计，可同时向同一文件（或多个镜像源）发起多达 16 条连接，瞬间跑满物理带宽。
如何为 aria2 配置网络代理 (HTTP / SOCKS5)？
aria2 原生支持 HTTP/HTTPS 与 SOCKS5 代理，使用 --all-proxy 参数即可：
# SOCKS5 example: aria2c --all-proxy="socks5://127.0.0.1:1080" 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 占用率极低。
图形客户端 (GUI) 与 Web 控制台全方位对比
更喜欢可视化操作？为 aria2 搭配现代化 Web 前端与浏览器下载拦截器。
Aria2 Explorer
首选浏览器扩展，自动捕获浏览器中的下载链接并将其通过 JSON-RPC 无缝发送至 localhost:6800 的后台 aria2。
AriaNg
响应式现代化 Web 控制台。完全在客户端运行（纯 HTML/JS），完美适配手机移动端，支持实时速度折线图与多任务管理。
Motrix
支持 Windows、macOS 和 Linux 的跨平台桌面图形下载管理器。内置完整 aria2 引擎，支持深色模式与系统托盘常驻。
什么是 .aria2 文件？（二进制规范与恢复指南）
在下载目录中看到了 filename.aria2 文件？以下是它的运作原理以及如何使用它恢复中断的下载：
.aria2 文件是二进制控制文件，由 aria2 在下载过程中自动创建在目标文件同级目录下。它记录了分块哈希校验码、位掩码 (Bitfield) 与下载进度，确保随时能够安全暂停、恢复与断点续传。
为什么会产生 .aria2 文件？
由于 aria2 支持高达 16 线程并发分块下载，它需要一个索引文件记录哪些数据块已完整写入。当文件下载达到 100% 并通过哈希验证后，aria2 会自动删除 .aria2 文件，仅保留最终的完整文件。
如何利用 .aria2 文件恢复下载？
若下载意外中断，切勿删除 .aria2 文件！只需在相同目录下重新执行带 -c（断点续传）参数的命令：aria2c -c <URL>，即可从上次断点处无缝继续。
可以手动删除 .aria2 文件吗？
仅当你希望放弃当前未完成的下载并彻底重头开始时才可删除。在活跃下载过程中删除它会导致进度丢失，aria2 必须从 0% 重新拉取整个文件。