Aria2

aria2 是一个轻量级的开源命令行下载工具，以 C++ 编写，支持 HTTP/HTTPS、FTP、SFTP、BitTorrent 与 Metalink 五大下载协议，可将同一文件的多条网络连接或多个镜像站点并发分段下载，充分榨取可用带宽资源，实现远超单连接下载的速度表现。项目以极低的内存占用、高度可配置的参数体系和结构化的 RPC 控制接口著称，是服务器端下载管理、自动化脚本集成以及各类可视化下载前端的理想后端引擎。凭借跨平台的静态二进制发行与零外部依赖的特性，aria2 在 NAS、嵌入式设备与 Linux 服务器场景中保持着持久的生命力与广泛的用户基础。

项目背景与设计理念

aria2 由日本开发者 Tatsuhiro Tsujikawa 发起，最初在 SourceForge 平台托管，后迁移至 GitHub，以 GPLv2 许可证开放全部源代码。项目名称中的数字代表对第二代多协议下载管理器的设计定位，目标是在单一工具中整合当时主流的多种下载协议，提供统一的命令行与 API 操作接口。aria2 的核心设计哲学强调极简性与可嵌入性：它刻意不提供图形界面，而是通过丰富的命令行参数与结构化的 JSON-RPC 接口将控制权完全交给外部工具与前端。正是这一设计理念，使 aria2 成为 yt-dlp、you-get 等主流下载工具的首选外部下载后端，也催生了 AriaNg 等优秀的可视化前端生态，让非技术用户也能通过友好界面驾驭 aria2 的强大能力。

核心功能详解

• 多协议统一下载：HTTP 与 HTTPS 支持基于 Range 请求头的分段并行下载；FTP 与 SFTP 覆盖传统文件传输场景；BitTorrent 完整支持磁力链接（Magnet URI）、.torrent 种子文件、DHT、PEX 与传输加密扩展；Metalink 支持多镜像站点并发与基于 MD5/SHA 哈希的下载完整性自动校验。
• 多线程分段并行下载：通过 --split 参数将单个文件拆分为多个独立片段，每个片段由单独的连接并行下载不同的字节范围，大幅提升对支持 HTTP Range 请求的高性能服务器的下载吞吐量，--max-connection-per-server 参数控制对同一服务器的最大并发连接数。
• 断点续传与数据保护：HTTP 下载利用 Range 请求自动从中断点恢复；对于 BitTorrent 任务，重启时自动扫描本地已存在的文件块并进行哈希校验，仅下载缺失或损坏的分片，最大限度减少重复传输的网络开销。
• 会话持久化机制：通过 --save-session 参数，aria2 在正常退出或收到 SIGTERM 信号时，将所有进行中与排队等待的任务状态序列化保存到指定的会话文件中；下次启动时通过 --input-file 参数加载该文件即可完全恢复上次的下载队列，实现跨重启的任务持久化管理。
• 精细化限速控制：支持全局下载限速（--max-overall-download-limit）、全局上传限速（--max-overall-upload-limit）以及单任务级别的独立限速配置，在下载高峰时段保护其他网络服务不受影响，同时满足 PT 站点对上传速率的要求。
• 批量下载支持：支持从文本列表文件（--input-file）批量读取 URL，每行一个地址，可附加 aria2 特有的选项注释行，实现对大量下载任务的批量管理与灵活参数定制。

RPC 接口与可视化前端生态

aria2 内置完整的 JSON-RPC（通过 HTTP POST 或 WebSocket）与 XML-RPC 控制接口，通过 --enable-rpc 参数开启后默认监听 6800 端口。RPC 接口支持以下核心操作：

• aria2.addUri：添加 HTTP、FTP 或磁力链接下载任务，支持传入自定义下载选项。
• aria2.addTorrent：提交 Base64 编码的 .torrent 文件内容以添加 BT 下载任务。
• aria2.addMetalink：提交 Metalink 文件内容以添加多镜像下载任务。
• aria2.tellStatus：实时查询指定任务的下载状态、进度百分比、速度与错误信息。
• aria2.pause 与 aria2.remove：暂停指定任务或将其从队列中彻底移除。
• aria2.getGlobalStat：获取全局下载速度、上传速度与活跃任务数等汇总统计。

在可视化前端生态中，AriaNg 是目前最流行的选择，它是一个完全静态的单页 Web 应用，无需独立的后端服务，直接在用户浏览器中通过 WebSocket 连接 aria2 的 RPC 端点，提供完整的任务管理界面、实时速度图表与参数配置面板，部署方式极为灵活，可托管在任意 Web 服务器或 Nginx 静态目录中。RPC 接口支持通过 --rpc-secret 参数设置访问令牌，防止未经授权的第三方程序控制下载任务。

技术架构与系统资源特性

aria2 以事件驱动的异步非阻塞 IO 模型实现核心逻辑，单进程内通过事件循环并发处理多条网络连接，避免了多线程模型的锁竞争开销与高线程数带来的上下文切换消耗，在维护数十个并发下载任务时内存占用通常仅数十 MB，CPU 使用率极低。官方提供覆盖 Linux（x86_64、ARM32、ARM64）、Windows 与 macOS 的预编译静态二进制，无需安装任何额外的动态链接库即可直接运行，极大简化了在嵌入式设备与受限环境中的部署难度。

配置文件 aria2.conf 支持数百个精细控制参数，涵盖网络连接行为（超时、重试策略、代理设置）、BitTorrent 协议细节（DHT 端口、做种时间、加密策略）、磁盘写入策略（预分配模式、文件缓冲大小）与日志详细程度等，可通过 XDG 规范的用户配置目录自动加载，也可通过 --conf-path 参数显式指定路径。

典型使用场景

• Linux 服务器持续下载节点：配合 systemd 服务单元文件与会话持久化配置，在 Linux 服务器上实现 7×24 小时不间断的 BT 做种与文件下载，支持开机自启、崩溃自动重启与任务状态跨重启保持。
• yt-dlp 高速下载后端：将 aria2 配置为 yt-dlp 的外部下载器（--downloader aria2c），利用多线程分段能力加速从 YouTube 等平台下载高清视频文件，将原本单连接的下载速度提升数倍。
• NAS 轻量下载引擎：凭借极低的资源消耗，aria2 非常适合运行在ARM 架构的群晖、威联通等 NAS 设备上，配合 AriaNg 提供友好的 Web 管理界面，实现 NAS 上的集中化下载管理而不占用显著的系统资源。
• 大规模科学数据集获取：Metalink 格式原生支持多镜像站点并发下载与 MD5/SHA-256 完整性自动校验，非常适合科研机构分发和获取体积庞大的基因组、天文观测、气象模拟等科学数据集，兼顾下载速度与数据完整性保证。

与同类工具对比

• aria2 与 wget/curl 对比：wget 与 curl 是通用的 HTTP 命令行工具，不具备 BitTorrent 协议支持，也不支持 HTTP 分段并行下载；aria2 专注于多协议多线程下载场景，在下载速度与协议覆盖广度上远超两者，更适合以高效下载为主要目标的使用场景。
• aria2 与 qBittorrent 对比：qBittorrent 提供成熟的图形界面与完整的 BT 功能，更适合作为日常桌面客户端使用；aria2 更为轻量且易于通过 RPC 嵌入其他系统，在以程序化控制和服务器端集成为主要需求的场景中更具优势，两者互补而非竞争。
• aria2 与 Transmission 对比：Transmission 专注于 BitTorrent，界面简洁，适合日常 BT 使用；aria2 协议覆盖更广（HTTP/FTP/Metalink），参数配置更灵活，更适合作为通用下载基础设施在自动化系统中使用。

安全与使用注意事项

• RPC 接口安全配置：默认情况下 RPC 接口不需要任何认证即可接受命令，务必通过 --rpc-secret 参数设置访问令牌，并通过防火墙规则或 Nginx 反向代理将 RPC 端口的访问范围限制在受信任的内网 IP 范围内，防止公网上的恶意程序向 aria2 提交任意下载任务消耗服务器带宽与存储资源。
• BT 上传比例与 PT 站点合规：在私有 PT 站点使用时，须通过 --seed-ratio 与 --seed-time 参数控制做种时间与上传分享比，确保达到站点规定的最低分享率要求，避免因分享率不足而被封号或降级。
• 磁盘预分配策略选择：默认的 --file-allocation=prealloc在机械硬盘（HDD）上能减少文件碎片，但对大文件进行预分配时耗时较长；在固态硬盘（SSD）环境下可将其设置为 none 以跳过预分配步骤，加快任务启动速度。