# aria2多线程下载
# 1. 安装 aria2
Ubuntu/Debian
sudo apt update sudo apt install aria2
CentOS/RHEL
sudo yum install aria2
如果默认源没有,可以通过 EPEL 源安装。
MacOS
brew install aria2
检查是否安装成功
aria2c --version
# 2. 基本用法
# 下载文件
aria2c -x 16 -c -o 文件名.ext '下载链接'
参数说明:
-x 16
:最大连接数,通常16线程下载加快速度-c
:断点续传-o
:输出文件名- URL 用单引号包裹,防止 shell 解析特殊字符
# 示例
aria2c -x 16 -c -o example.mp3 'https://example.com/file.mp3?token=xxxx&other=yyy'
# 3. 常见问题及解决
# 1) URL 中有特殊字符导致命令失败
- URL 带
?
、&
等特殊字符,必须用单引号或双引号括起来 - 不然 shell 会把它们当作后台符号,拆分命令出错
# 2) 中文文件名导致下载异常或乱码
- aria2 和终端环境对中文名支持有限,最好用英文或拼音文件名
- 下载完用
mv
命令重命名为中文
# 3) 下载链接过期或权限限制
- 含时间戳或签名的链接一般有有效期,过期会返回错误状态码
- 需要重新生成最新的有效链接
- 确认网络权限,服务器可以访问该链接
# 4) 报错 HTTP 状态码异常(如 status=959)
- 多为链接格式问题(未加引号)或服务端拒绝请求
- 检查链接有效性,确认网络可达
# 4. 小贴士
- 用
curl -I '链接'
或wget --spider '链接'
先检测链接是否能正常访问 - 如果需要下载多个文件,可写一个文本文件,一行一个 URL,用
aria2c -i urls.txt
批量下载 - aria2 支持 BitTorrent、Metalink、HTTP/FTP 下载,非常强大,可查官方文档深入学习