Aria2 在 macOS 上的详细安装教程！
安装和设置 Aria2#使用Homebrew安装aria2brewinstallaria2#创建配置文件aria2.conf和空对话文件aria2.sessionmk...
安装和设置 Aria2
# 使用 Homebrew 安装 aria2
brew install aria2
# 创建配置文件aria2.conf和空对话文件aria2.session
mkdir ~/.aria2 && cd ~/.aria2
touch aria2.conf
touch aria2.session编辑配置文件aria2.conf
本人设置文件:
默认开启 RPC 模式
已设置 RPC 授权令牌, 详见设置文件注释
已经添加 BT tracker，更多详见 XIU2/TrackersListCollection[1]
$ cat aria2.conf
## '#'开头为注释内容, 选项都有相应的注释说明, 根据需要修改 ##
## 被注释的选项填写的是默认值, 建议在需要修改时再取消注释 ##
## 沙漠之子 自用 2020-2-6 ##
## 文件保存相关 ##
# 文件的保存路径(可使用绝对路径或相对路径), 默认: 当前启动位置
dir=${HOME}/Downloads
# 启用磁盘缓存, 0为禁用缓存, 需1.16以上版本, 默认:16M
disk-cache=32M
# 文件预分配方式, 能有效降低磁盘碎片, 默认:prealloc
# 预分配所需时间: none < falloc ? trunc < prealloc
# falloc和trunc则需要文件系统和内核支持
# NTFS建议使用falloc, EXT3/4建议trunc, MAC 下需要注释此项
#file-allocation=none
# 断点续传
continue=true
## 下载连接相关 ##
# 最大同时下载任务数, 运行时可修改, 默认:5
#max-concurrent-downloads=5
# 同一服务器连接数, 添加时可指定, 默认:1, 最大值16
max-connection-per-server=5
# 最小文件分片大小, 添加时可指定, 取值范围1M -1024M, 默认:20M
# 假定size=10M, 文件为20MiB 则使用两个来源下载; 文件为15MiB 则使用一个来源下载
min-split-size=10M
# 单个任务最大线程数, 添加时可指定, 默认:5
#split=5
# 分片选择算法,有助于视频的边下边播同时兼顾减少建立连接的次数
stream-piece-selector=geom
# 整体下载速度限制, 运行时可修改, 默认:0
#max-overall-download-limit=0
# 单个任务下载速度限制, 默认:0
#max-download-limit=0
# 整体上传速度限制, 运行时可修改, 默认:0
#max-overall-upload-limit=0
# 单个任务上传速度限制, 默认:0
#max-upload-limit=0
# 禁用IPv6, 默认:false
#disable-ipv6=true
# 连接超时时间, 默认:60
#timeout=60
# 最大重试次数, 设置为0表示不限制重试次数, 默认:5
#max-tries=5
# 设置重试等待的秒数, 默认:0
#retry-wait=0
## 进度保存相关 ##
# 日志文件
log-level=notice
log=${HOME}/.aria2/aria2.log
# 从会话文件中读取下载任务
# 需提前创建一个空文件否则会报错
input-file=${HOME}/.aria2/aria2.session
# 在Aria2退出时保存`错误/未完成`的下载任务到会话文件
save-session=${HOME}/.aria2/aria2.session
# 定时保存会话, 0为退出时才保存, 需1.16.1以上版本, 默认:0
save-session-interval=60
# 强制保存会话, 即使任务已经完成, 默认:false
# 较新的版本开启后会在任务完成后依然保留.aria2文件
#force-save=true
## RPC相关设置 ##
# 启用RPC, 默认:false
enable-rpc=true
# 允许所有来源, 默认:false
rpc-allow-origin-all=true
# 允许非外部访问, 默认:false
rpc-listen-all=true
# RPC监听端口, 端口被占用时可以修改, 默认:6800
rpc-listen-port=6800
# 设置的RPC授权令牌
# 此处使用`openssl rand -base64 32`命令生成<TOKEN>
rpc-secret=<TOKEN>
# 是否启用 RPC 服务的 SSL/TLS 加密,
# 启用加密后 RPC 服务需要使用 https 或者 wss 协议连接
#rpc-secure=true
# 在 RPC 服务中启用 SSL/TLS 加密时的证书文件,
# 使用 PEM 格式时，您必须通过 --rpc-private-key 指定私钥
#rpc-certificate=/path/to/certificate.pem
# 在 RPC 服务中启用 SSL/TLS 加密时的私钥文件
#rpc-private-key=/path/to/certificate.key
## HTTP 设置 ##
# 自定义 User Agent
user-agent=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.85 Safari/537.36
## BT/PT下载相关 ##
# 当下载的是一个种子(以.torrent结尾)时, 自动开始BT任务, 默认:true
follow-torrent=true
# BT监听端口, 当端口被屏蔽时使用, 默认:6881-6999
listen-port=6881-6999
# 单个种子最大连接数, 默认:55
#bt-max-peers=55
### DHT 功能, 仅对 BT 生效, PT 无效###
# 打开 DHT (IPv4) 功能
enable-dht=true
# 打开 DHT (IPv6) 功能
enable-dht6=true
# DHT网络监听端口, 默认:6881-6999
dht-listen-port=6881-6999
# 本地节点查找
bt-enable-lpd=true
# 种子交换
enable-peer-exchange=true
# DHT (IPv4) 路由表文件路径
dht-file-path=${HOME}/.aria2/dht.dat
# DHT (IPv6) 路由表文件路径
dht-file-path6=${HOME}/.aria2/dht6.dat
# 客户端伪装, PT需要
peer-id-prefix=-UT341-
peer-agent=uTorrent/341(109279400)(30888)
# 同一服务器连接数
# 每个种子限速, 对少种的PT很有用, 默认:50K
#bt-request-peer-speed-limit=50K
# 当种子的分享率达到这个数时, 自动停止做种, 0为一直做种, 默认:1.0
seed-ratio=0
# BT校验相关, 默认:true
#bt-hash-check-seed=true
# 继续之前的BT任务时, 无需再次校验, 默认:false
bt-seed-unverified=true
# 保存磁力链接元数据为种子文件(.torrent文件), 默认:false
bt-save-metadata=true
# BT 服务器地址
# 逗号分隔的 BT 服务器地址. 如果服务器地址在 --bt-exclude-tracker 选项中, 其将不会生效.
bt-tracker=
# BT 排除服务器地址
bt-exclude-tracker=
# 启用后台进程
daemon=false
# 部分事件hook, 调用第三方命令:/path/to/command
# BT下载完成(如有做种将包含做种，如需调用请务必确定设定完成做种条件)
on-bt-download-complete=${HOME}/.aria2/download-complete-hook.sh
# 下载完成
on-download-complete=${HOME}/.aria2/download-complete-hook.sh
# 下载错误
on-download-error=
# 代理 仅支持 HTTP 协议
#all-proxy=http://127.0.0.1:1087设置为 macOS 的开机启动
参考: 控制 macOS 的开机启动[2]
创建用户启动文件
touch ~/Library/LaunchAgents/aria2.plist写入如下
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key>
<true/>
<key>Label</key>
<string>aria2</string>
<key>ProgramArguments</key>
<array>
<string>/usr/local/bin/aria2c</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>WorkingDirectory</key>
<string>/Users/maboloshi/Downloads</string>
</dict>
</plist>注意: 修改
WorkingDirectory目录
# 检查plist语法是否正确
plutil ~/Library/LaunchAgents/aria2.plist
# 修改文件权限
chmod 644 ~/Library/LaunchAgents/aria2.plist添加并启用自启动项
# 添加自启动项: aria2
launchctl load ~/Library/LaunchAgents/aria2.plist
# 删除自启动项: aria2
launchctl unload ~/Library/LaunchAgents/aria2.plist
# 启动服务: aria2
launchctl start aria2
# 停止服务: aria2
launchctl stop aria2更多
launchctl使用方法, 详见命令手册
可使用killall aria2c结束进程, 并会自动重启进程
添加自动更新BT tracker功能
创建trackers-list-aria2.sh脚本
参考: Aria2 bt-tracker 跟踪服务器列表自动更新[3]
脚本内容详见:
#!/bin/bash
#trackers-list-aria2.sh
# aria2 设置文件路径
CONF=${HOME}/.aria2/aria2.conf
#设置选择的 trackerlist （可选 all_aria2.txt, best_aria2.txt, http_aria2.txt）
trackerfile=all_aria2.txt
#downloadfile=https://raw.githubusercontent.com/ngosang/trackerslist/master/${trackerfile}
downloadfile=https://trackerslist.com/${trackerfile}
list=$(curl -fsSL ${downloadfile})
if ! grep -q "bt-tracker" "${CONF}" ; then
echo -e "\033[34m==> 添加 bt-tracker 服务器信息......\033[0m"
echo -e "\nbt-tracker=${list}" >> "${CONF}"
else
echo -e "\033[34m==> 更新 bt-tracker 服务器信息.....\033[0m"
sed -i '' "s@bt-tracker.*@bt-tracker=${list}@g" "${CONF}"
fi
## 重启 aria2 服务
echo -e "\033[34m==> 停止 aria2 服务......\033[0m"
launchctl stop aria2
echo -e "\033[34m==> 启动 aria2 服务......\033[0m"
launchctl start aria2脚本放置到如~/.aria2/
设置运行权限:
chmod +x ~/.aria2/trackers-list-aria2.sh设置任务计划程序 实现自动更新
参考:
Aria2 bt-tracker 跟踪服务器列表自动更新[4]
mac 下 crontab 执行定时脚本[5]
编译当前用户任务计划
crontab -e在打开的vi中 键入如下, 并使用:wq命令保存退出, 可用crontab -l查看当前用户任务计划
0 18 * * * ~/.aria2/trackers-list-aria2.sh或者 直接
(crontab -l 2&> /dev/null; echo "0 18 * * * ~/.aria2/trackers-list-aria2.sh") | crontab以上表示: 每天下午 6 点自动更新
BT tracker(并重启aria2服务)
更多crontab时间的设定详见: 这里[6]
取消计划任务
crontab -e然后手动删除, 或者
crontab -l 2&> /dev/null| sed "/trackers-list-aria2.sh/d" | crontab
添加下载通知
参考: macOS 下 给 aria2 RPC 添加一个下载通知[7]
最终效果：当下载完成会在屏幕右上角弹出一个提示框显示具体下载完成的文件名，同时中文语音播报：“有个文件下载完成，请查收！”
创建download-complete-hook.sh脚本
参考:
aria2 event-hook[8]
Display notification from the Mac command line[9]
在 mac 命令行执行显示通知[10]
Pass in variable from shell script to applescript[11]
脚本内容详见:
$ cat download-complete-hook.sh
#!/bin/sh
# 给aria2 RPC添加一个下载完成通知 for macOS
# 最终效果：当下载完成会在屏幕右上角弹出一个提示框显示具体下载完成的文件名，
# 同时中文语音播报：“有个文件下载完成，请查收！”
# 变量 3 表示下载完成文件的路径
# 具体提示框设置可参考`https://code-maven.com/display-notification-from-the-mac-command-line`。
# 不支持设置自定义图标
fname=`basename $3`
osascript <<EOF
display notification "$fname 已经下载完成！" with title "【下载完成】"
say "有个文件下载完成，请查收！"
EOF脚本放置到如~/.aria2/
设置运行权限:
chmod +x ~/.aria2/download-complete-hook.sh添加 Hook 设置
参考:
https://aria2.github.io/manual/en/html/aria2c.html#event-hook
在 aria2 设置文件.aria2.conf加入如下：
# BT下载完成(如有做种将包含做种，如需调用请务必确定设定完成做种条件)
on-bt-download-complete=${HOME}/.aria2/download-complete-hook.sh
# 下载完成
on-download-complete=${HOME}/.aria2/download-complete-hook.shAria2 web UI
无需安装，直接使用浏览器打开: AriaNg 版 UI[12]
PRC 设置
根据 aria2 配置文件中的 PRC 相关设置项进行设置
安装浏览器下载插件
Aria2 for Chrome 插件[13]
内置一个离线 AriaNg 版 UI
整合右键下载菜单
内置的离线 AriaNg 版也需要设置 PRC，否则无法“导出到 ARIA2 RPC”。
参考
Mac 下配置 Aria2 来代替迅雷[14]
Aria2 配置文件参数翻译详解[15]
关于 aria2 最完整的一篇[16]
aria2c 手册[17]
引用链接
[1]
XIU2/TrackersListCollection: https://trackerslist.com/#/zh
[2]控制 macOS 的开机启动: https://www.jianshu.com/p/eee8a7de179c
[3]Aria2 bt-tracker 跟踪服务器列表自动更新: https://www.feng.ee/aria2-trackers-auto-update.html
[4]Aria2 bt-tracker 跟踪服务器列表自动更新: https://www.feng.ee/aria2-trackers-auto-update.html
[5]mac 下 crontab 执行定时脚本: https://blog.csdn.net/ty_hf/article/details/72354230
[6]这里: https://user-images.githubusercontent.com/7850715/87239248-94674100-c43f-11ea-8445-1d084be61436.png
[7]macOS 下 给 aria2 RPC 添加一个下载通知: https://github.com/maboloshi/Blog/blob/hexo/source/_posts/05.%20macOS%E4%B8%8B%20%E7%BB%99aria2%20RPC%E6%B7%BB%E5%8A%A0%E4%B8%80%E4%B8%AA%E4%B8%8B%E8%BD%BD%E9%80%9A%E7%9F%A5.md
[8]aria2 event-hook: https://aria2.github.io/manual/en/html/aria2c.html#event-hook
[9]Display notification from the Mac command line: https://code-maven.com/display-notification-from-the-mac-command-line
[10]在 mac 命令行执行显示通知: https://www.zixi.org/archives/notification_on_macos.html
[11]Pass in variable from shell script to applescript: https://stackoverflow.com/a/17243326/7488424
[12]AriaNg 版 UI: http://ariang.mayswind.net/latest/
[13]Aria2 for Chrome 插件: https://chrome.google.com/webstore/detail/aria2-for-chrome/mpkodccbngfoacfalldjimigbofkhgjn
[14]Mac 下配置 Aria2 来代替迅雷: https://www.damocles.me/2019/06/16/mac-aria2-configure/
[15]Aria2 配置文件参数翻译详解: http://www.senra.me/aria2-conf-file-parameters-translation-and-explanation/
[16]关于 aria2 最完整的一篇: http://ivo-wang.github.io/2019/04/18/%E5%85%B3%E4%BA%8Earia2%E6%9C%80%E5%AE%8C%E6%95%B4%E7%9A%84%E4%B8%80%E7%AF%87/
[17]aria2c 手册: https://aria2.github.io/manual/en/html/aria2c.html#aria2-conf
原文链接：https://gist.github.com/maboloshi/a4b1f27567319d4a42352aadd036a578
你可能还喜欢
点击下方图片即可阅读
云原生是一种信仰 🤘
关注公众号
后台回复◉k8s◉获取史上最方便快捷的 Kubernetes 高可用部署工具，只需一条命令，连 ssh 都不需要！
点击 "阅读原文" 获取更好的阅读体验！
发现朋友圈变“安静”了吗？
为开发者提供学习成长、分享交流、生态实践、资源工具等服务，帮助开发者快速成长。
更多推荐
5
0- 0
已为社区贡献17条内容
所有评论(0)