Aria2 这个工具我到今天还在用三年前第一次装上它的时候我只是抱着“试试看”的心态结果用顺手之后它成了我每台电脑的必装软件。如果你经常下载大文件、批量拉取资源、或者受不了浏览器下载动不动就断掉那Aria2大概率能帮你省下不少时间。这篇内容我会从安装讲到配置再讲到实际使用里最常踩的坑不绕弯子全程按我自己实际操作过的流程来。1. Aria2是什么和普通下载工具差别在哪1.1 它到底是什么Aria2是一个轻量级的多协议命令行下载工具支持HTTP、HTTPS、FTP、SFTP、BitTorrent、Metalink。光是听到“命令行”三个字可能一部分人就想关页面了但我劝你先看完这一段因为它的能力是真的值得你为它破例。用一句话概括它可以把一个下载任务拆成最多16个连接同时下载并且支持断点续传、支持后台运行、支持通过远程网页界面管理下载任务。打个比方普通浏览器下载像一个人去搬砖一次搬几块Aria2默认开启16个连接相当于叫了16个人同时搬速度快慢取决于对方的“门”服务器带宽开多大。这个类比不严谨但意思到位了它通过并行请求把带宽利用率拉满。1.2 解决什么问题我最早遇到的需求特别朴素公司内网下载一个好几个GB的数据库备份包浏览器下到一半断了又得从头来。试试Aria2之后断点续传这个功能直接把我救了。后来发现它还能批量下载支持通配符、支持按列表文件下载、支持设置下载任务队列甚至能配合RPC接口做成一个类似下载中心的服务。再后来我把它装在了一台小服务器上多台电脑共用同一个下载服务白天在公司添加任务回家后文件已经躺在服务器的硬盘里了。说实话那种体验比起“下载靠网盘客户端”、“限速还弹窗”的工具舒服太多。1.3 适合谁用如果你是下面这几类人Aria2值得花时间学会经常下载软件镜像、视频素材、数据集等大文件的用户需要同时下载多个文件不想一个个点保存的办公族有服务器或Linux机器希望在后台挂下载任务的技术爱好者对网盘客户端限速、广告、内存占用不满意的实用主义者如果只是偶尔下个小文件那继续用浏览器自带的下载器也没问题这个教程其实主要面向“受够了下载慢、下载断”的人。2. 安装前先搞清楚这几件事省得后面踩坑2.1 确认系统类型和架构Aria2虽然是个命令行程序但它在Windows、macOS、Linux、甚至OpenWrt路由器上都能跑。安装前先确认两件事你的操作系统是什么以及你的CPU是什么架构。Windows主力是x64老机器可能是x86ARM架构的Windows也能装特定版本macOSIntel芯片和M系列芯片对应的版本不同Linux通过包管理器安装一般自动匹配自行下载二进制时需要注意x86_64、aarch64等区别不确认架构就直接下载二进制文件最常见的报错是“无法识别文件格式”或者“Permission denied”换个说法就是你拿了异世界的钥匙开这扇门当然打不开。2.2 命令行工具的通用逻辑Aria2的核心程序叫aria2c安装完成之后你在终端里输入aria2c再跟上参数它就开始干活了。所有配置都是通过参数传给程序的也可以在命令里指定一个配置文件由配置文件提供参数。理解了这一点后面看任何教程都会觉得通透你没必要死记硬背所有参数只需要记住“配置文件可以代替一大串命令行参数”这个原则就能把Aria2用得很舒服。2.3 需要准备什么环境Windows用户建议装一个什么如果还没有任何命令行终端工具用自带的PowerShell其实就够了。Linux和macOS用户直接用自带的终端。另外如果你之后计划用Web界面管理下载任务那需要在系统里保留Aria2进程常驻Windows下可以用后台运行方式启动Linux下建议配成systemd服务macOS下可以用launchd实现这部分我会在后面细说。3. 各平台安装Aria2实操步骤3.1 LinuxDebian/Ubuntu、CentOS/RHEL、Arch安装方法Debian系系统安装最省事一条命令sudo apt update sudo apt install aria2CentOS/RHEL 8及以后版本建议用dnfsudo dnf install aria2如果是老版本的CentOS 7yum也能装sudo yum install aria2Arch Linux用户更简单sudo pacman -S aria2安装完成后验证aria2c --version能看到版本号就说明装好了。我最初是在Ubuntu 20.04上装的当时软件源里的版本是1.35.0功能完全够用后来自己编译升级过一次其实日常使用中感受不到太大差异。3.2 macOS安装方法macOS用户优先推荐Homebrew一行命令搞定brew install aria2没有Homebrew的同学去GitHub的Aria2 Releases页面下载对应架构的二进制文件解压后把aria2c文件移动到/usr/local/bin目录下M系列芯片是/opt/homebrew/bin目录然后同样执行aria2c --version验证。macOS上有个细节如果你是从网上下载的二进制文本未经公证系统第一次运行可能会提示“无法打开因为无法验证开发者”。解决方法是到“系统设置”里的“隐私与安全性”手动允许或者在终端执行chmod x /path/to/aria2c这一步是给程序加可执行权限很多新手在这个地方卡住。3.3 Windows安装方法Windows用户有三条路可以选。第一条用Chocolatey包管理器choco install aria2第二条直接去官方Releases页面下载windows版本的zip压缩包解压后你会看到一个aria2c.exe文件。为了方便在任意路径下使用建议把这个exe文件所在的目录添加到系统PATH环境变量里。第三条使用Scoop包管理器scoop install aria2我个人推荐Chocolatey或者Scoop因为后续卸载、升级都方便不需要自己去官网找新版。手动添加PATH的时候注意路径别搞错解压到哪个目录就添加哪个目录目录层级乱了容易找不到程序。3.4 建立后台常驻能力Windows/Linux当Aria2还停留在“临时用一下”的阶段时终端窗口一关下载任务就没了。但如果你想把它当成一个下载中心建议让Aria2在后台常驻。Linux下最简单的方式是在终端用nohupnohup aria2c --conf-path/etc/aria2.conf /var/log/aria2.log 21 正式一点的做法是配置systemd服务写一个/usr/lib/systemd/system/aria2.service文件核心内容大概是[Unit] DescriptionAria2 Service Afternetwork.target [Service] Typeforking ExecStart/usr/bin/aria2c --conf-path/etc/aria2.conf Restarton-failure [Install] WantedBymulti-user.target然后执行sudo systemctl enable aria2 sudo systemctl start aria2Windows下可以用“aria2c --conf-pathC:\Users\你的用户名\aria2.conf”配合计划任务或者“启动”文件夹实现开机自启。也有人在Windows上使用Aria2的Windows服务封装工具不过我用下来发现自启脚本反而更稳定服务封装工具挑系统版本有时候权限不对直接起不来。4. 配置文件与核心参数Aria2的灵魂所在4.1 一条下载命令的完整拆解先看一个最简单的完整例子aria2c -x 8 -s 8 -d /Downloads -o image.iso https://example.com/image.iso这里面的参数分别是什么意思-x 8单台服务器最多建立8个连接。默认是1如果服务器支持分段请求设置之后速度会有质的提高-s 8把文件分成8段下载自己从文件开头和结尾同时拉数据下完再拼起来-d /Downloads保存目录-o image.iso另存为的文件名这个命令是我最常用的快速度参数组合。实际下载速度的提升取决于服务器支持不支持Range请求。如果服务器根本支持不了分段那设置多少连接数都没用这点要有心理预期。4.2 其它高频参数速查使用中反复出现的高频参数我整理成了表格按用途分类方便你直接抄参数说明示例-c断点续传-c-i批量下载从文件中读取任务列表-i urls.txt-j同时最多下载多少个任务-j 5-Z所有URL同时下载默认是队列式逐个下载-Z-PBitTorrent下载后对文件做Hash校验-P--seed-timeBT任务做种时间默认是120分钟不想分享就设0--seed-time0--max-overall-download-limit全局最大总下载速度--max-overall-download-limit0--max-download-limit单任务最大下载速度--max-download-limit5M--file-allocation预分配文件空间falloc更快prealloc对老旧文件系统更稳--file-allocationnone--check-integrity校验文件完整性--check-integritytrue这些参数不必一口气全记住先把-x、-s、-d、-o、-c这5个最常用的背下来后面用到什么再查什么。4.3 配置文件怎么写命令越写越长手滑概率就越高。这时候配置文件的价值就出来了。默认情况下Aria2会读取用户目录下的.aria2.conf文件也可以在运行时通过--conf-path指定。我常用的配置文件模板长这样# 基本设置 continuetrue max-concurrent-downloads5 max-connection-per-server16 split16 min-split-size1M # 目录设置 dir/data/downloads # 日志设置 log/data/aria2/aria2.log log-levelnotice # 会话设置任务恢复关键 input-file/data/aria2/aria2.session save-session/data/aria2/aria2.session save-session-interval60 # RPC设置配合Web UI使用 enable-rpctrue rpc-listen-alltrue rpc-listen-port6800 rpc-secretyour_secret_token # BT相关设置 bt-enable-lpdtrue enable-dhttrue enable-peer-exchangetrue bt-save-metadatatrue bt-load-saved-metadatatrue看到这里你是不是发现了命令行参数去掉短横线再替换成等号基本就是配置文件的写法。确实就是这样理解了这一层配置文件对你来说就不再是玄学。4.4 RPC模式让下载“云化”RPC模式是本篇重点也是Aria2真正拉开和浏览器下载差距的地方。简单说Aria2开启RPC服务后监听6800端口任何能访问到这个端口的程序都能通过JSON-RPC来添加、暂停、删除下载任务。这就是为什么后面我们要配合Web UI使用你在浏览器里的操作通过RPC接口转发给后台运行的Aria2进程下载任务完全由Aria2负责浏览器关掉也不影响任务继续跑。配置里最关键的一段enable-rpctrue rpc-listen-alltrue rpc-listen-port6800 rpc-secretyour_secret_token其中rpc-secret就是你的访问令牌相当于唯一钥匙任何请求RPC接口的动作都要带着这把钥匙。配置好之后你可以用浏览器访问http://你的IP:6800/jsonrpc看到一个“method not found”的提示这是正常的说明服务已经起来了。5. 搭配Web UI使用体感直接翻倍5.1 为什么推荐AriaNg命令行再强大对多数人来说在黑色终端里输入命令还是不够直观。这里我推荐搭配AriaNg这个开源前端项目。AriaNg是纯前端静态页面不依赖后端只需在浏览器里打开页面填上Aria2 RPC地址和密钥就能显示所有下载任务。另一个老牌选择是webui-aria2。相比之下AriaNg更加现代界面清爽支持中文任务管理、速度监控、连接设置都做得很完整。在浏览器里体验下来AriaNg的反应速度非常快基本无感知延迟长年维护这是它最大的优势。5.2 AriaNg部署的两种方式本地部署wget https://github.com/mayswind/AriaNg/releases/download/1.3.4/aria-ng-1.3.4.zip unzip aria-ng-1.3.4.zip -d /data/ariaing cd /data/ariaing python3 -m http.server 8080然后浏览器访问http://服务器IP:8080进入AriaNg界面再配置RPC地址为http://服务器IP:6800/jsonrpc填入rpc-secret即可连上Aria2。在一台没有外网环境的内网服务器上使用浏览器直接打开提供的release单文件版本也行因为AriaNg是纯前端的完全可以“离线使用”。5.3 日常操作演示连上AriaNg之后添加下载任务非常直观在“新建任务”输入框粘贴HTTP下载链接或者选择本地的BT种子文件设置保存目录和文件名可选项包括同时下载数量、单服务器连接数点击下载任务立刻进入队列AriaNg的刷新频率我已经调到了1秒当前下载速度、剩余时间、种子健康度一目了然。如果下载任务出错点击任务查看错误日志也能快速定位原因比命令行看日志方便一个量级。5.4 使用Web UI的注意事项使用Web UI时有一个容易忽略的问题不要用HTTP明文传输敏感操作。RPC接口虽然带token但token一旦在网络上被抓包别人就能随意给你添加下载任务。如果在公网环境使用建议部署Nginx反向代理并加上HTTPS同时限制来源IP。内网环境倒是不用过度紧张自己知道就好。6. 用Aria2下载BT和磁力链接的几个关键优化6.1 BT下载手动配置tracker列表Aria2毕竟不是纯BT工具它的DHT索引能力和专业BT客户端相比有一定差距。因此国内使用BT下载时经常出现“能连上但下载极慢”的情况大概率是DHT网络里的节点太少找不到足够的Peer帮你传数据。解决办法是手动添加tracker列表。你可以在以下来源获取较新的tracker列表https://github.com/ngosang/trackerslist https://trackerslist.com/all.txt获取之后把它们配置到配置文件里bt-trackerhttps://tracker1.example.com/announce,https://tracker2.example.com/announce然后重启Aria2。这一步对于国内BT下载的速度提升是最明显的效果立竿见影。tracker建议每隔一两周更新一次死链多了就换新的。6.2 磁力链接的下载逻辑磁力链接Magnet URI本身不包含文件数据只是包含了文件的哈希值。所以Aria2下载磁力链接时需要先通过DHT网络找到其他用户再获取文件数据。这个过程可能需要一段时间如果找不到节点任务就一直停留在“获取元数据”状态。开启这些配置可以明显提高成功率enable-dhttrue enable-dht6true bt-enable-lpdtrue enable-peer-exchangetrue dht-listen-port6881-6999 bt-request-peer-speed-limit10M我的建议是能拿到种子文件的情况下优先用种子文件不要用磁力链接。磁力链接适合应急的时候用不要在它身上耗时间。6.3 BT下载后做种时间怎么设置Aria2下载完BT任务后默认还会继续上传120分钟也就是做种。如果你不希望它一直占着上传带宽可以在配置里设置seed-time0这个参数的单位是分钟设置0表示下载完成后立刻“收摊”。喜欢“人人为我我为人人”的可以保留默认我自己的下载机设置了20分钟因为多台设备共用带宽实在扛不住长时间做种。7. 常见问题与排查技巧实录7.1 我踩过的坑下载任务一重启就全没了这是我最早用Aria2时遇到过的问题任务断点续传本来是好功能但重启之后任务列表空了什么都没跑起来。折腾了一圈才明白问题出在任务会话没有持久化。Aria2默认情况下任务状态只保存在内存里。你必须手动指定input-file和save-session两个参数它才能在退出前把任务状态写入文件重启后重新读入。input-file/data/aria2/aria2.session save-session/data/aria2/aria2.session save-session-interval60配置好之后正常重启Aria2任务就能自动恢复。注意必须让Aria2以正常方式退出才能保存会话。如果你直接kill -9强杀进程没有机会保存会话之前的任务还是会丢这个细节非常值得注意。7.2 下载速度上不去的几个排查方向身边同事问我最多的问题就是都装了Aria2也设置了16连接为什么还是慢这里梳理一下排查思路按优先级排序先确认文件是不是冷门资源。冷门资源在服务器端没多少带宽你连接数再多也白搭确认服务器支持Range请求。把下载链接丢到命令行里试试curl -I https://example.com/file.zip看响应头里有没有Accept-Ranges字段。没有这字段说明服务器不支持断点续传和分段请求Aria2的执行效果不会比浏览器好看是不是下载一段之后稳定在某个速度。这种情况大概率是单IP限速。你试试同时下一冷一热两个任务如果热任务能跑满说明确实有IP级别的限速策略检查有没有被网络中途劫持。偶尔会遇到下载某个文件时进度条正常但文件内容被替换的情况。Aria2对HTTPS链接默认会校验证书如果证书校验不过去就会一直重试7.3 磁盘相关注意事项还有一个很容易被忽略的点Aria2的--file-allocation预分配文件空间。默认的prealloc会先占满目标文件大小这在下载大文件时会消耗一定的初始化时间。如果磁盘剩余空间不足文件分配失败任务会直接报错。建议在下载超大文件前先检查磁盘空间是否充足。df -h如果你用的是网络文件系统比如NFS挂载目录无论下载还是分配文件都要谨慎一些。网络存储的I/O延迟较高Aria2长时间跑在这种存储上容易出现文件校验失败的问题。最好先把文件下到本地磁盘再转移到远程存储。7.4 日志文件的排查价值当Aria2出现不明所以的下载失败时最有效的定位手段就是看日志。配置了log参数后日志里会记录每次连接失败的具体原因比如DNS解析超时、连接被重置、服务器拒绝访问等等。log/data/aria2/aria2.log log-levelnotice排查问题的时候把日志级别调到debug能看到更多网络交互细节解决问题之后调回notice避免日志文件几天就膨胀到好几个GB。这是个很小的习惯但能帮你省很多事。7.5 常见问题速查表问题可能原因解决办法启动提示“IPv4 DHT failed”端口被防火墙挡了开放DHT端口路由器和防火墙均需检查任务一直停留在“获取元数据”DHT网络找不到节点手动添加tracker等待更长时间下载到99%卡住最后一个分片网络拥塞暂停任务稍后恢复或手动重试重启后任务列表为空没有配置session持久化配置input-file和save-sessionRPC连接失败端口未开放或密钥错误确认rpc-listen-port、rpc-secret用curl访问6800排查BT下载巨慢tracker失效或没有公网IP更新tracker列表开启UPnP端口映射8. 最后一个实用技巧如果让我只讲一条Aria2的使用建议那一定是“把您常用的下载参数全部沉淀到配置文件里”。第一次用的时候我也是一长串参数直接敲因为爽。时间长了就发现麻烦参数多、容易写错、不同机器之间还不一致。后来我把配置沉淀成一套固定模板放在Git仓库里各台设备直接用同一套配置改动时只在仓库里改一次同步下去就完了。这样既省心也保证了不同设备的行为一致。Aria2不是那种需要你时时折腾的工具是一门心思花十分钟搞定之后一劳永逸的长期投资。把它的基础打牢后面你会慢慢发现它给你省下的时间远超过你当初学习它花掉的时间。