aria2 是 macos 中最成熟稳定的命令行下载增强工具,支持多线程与断点续传;通过 homebrew 安装(≥1.36),配置 ~/.aria2/aria2.conf 启用 continue=true、split=16 等参数,并配合 session 持久化实现自动恢复。
在 macos 中配置支持多线程和断点续传的命令行下载增强工具,最成熟、稳定且广泛验证的选择是 aria2(配合配置优化)。它不是图形软件,但完全命令行驱动,轻量、高效,原生支持 https/ftp/bt/magnet,并能通过配置文件精细控制并发与恢复逻辑。
安装 aria2
推荐使用 Homebrew 安装,确保版本较新(≥1.36):
- 若未安装 Homebrew,先运行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 然后执行:
brew install aria2 - 验证安装:
aria2c --version(应显示 1.36 或更高)
启用多线程与断点续传的核心配置
创建配置文件 ~/.aria2/aria2.conf(目录需手动建好),写入以下关键参数:
-
dir=/Users/你的用户名/Downloads(指定默认下载目录) -
max-concurrent-downloads=5(同时下载任务数,避免服务器限流) -
split=16(单文件切片数,提升 HTTP 下载速度) -
max-connection-per-server=16(每服务器最大连接,配合 split 使用) -
continue=true(强制启用断点续传) -
input-file=~/.aria2/aria2.sessionsave-session=~/.aria2/aria2.session
(持久化记录进度,重启后自动恢复) -
disk-cache=32M(减少磁盘写入,提升稳定性) -
user-agent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)(部分网站要求 UA 才允许 resume)
保存后,首次运行前可初始化 session 文件:touch ~/.aria2/aria2.session
日常使用技巧
配置生效后,所有下载默认支持断点续传和多段并发:
- 基础下载:
aria2c -c "https://example.com/file.zip"(-c表示继续) - 指定线程数(覆盖配置):
aria2c -s 16 -x 16 -k 1M "https://...zip"(-s 分段数,-x 连接数,-k 缓存块大小) - 后台静默运行(适合大文件):
aria2c -d ~/Downloads -c -i urls.txt &(urls.txt 每行一个链接) - 中断后恢复:无需额外操作,再次执行相同命令即可自动续传
常见问题处理
如果遇到 “server did not support resume” 错误:
- 确认目标 URL 支持 HTTP Range 请求(静态资源一般支持,动态生成页通常不支持)
- 尝试加
--allow-overwrite=false避免误删临时文件 - 检查
aria2.session是否被意外清空或权限错误(应属当前用户,600 权限) - 临时禁用断点测试:
aria2c --no-conf --allow-overwrite=true "url"











