https://blog.niekun.net/tag/aria2/ https://blog.niekun.net/archives/1199.html 2020-02-28T17:10:00+08:00 aria2 是一款轻量级的下载器，支持 HTTP/HTTPS, FTP, SFTP, BitTorrent and Metalink 等多种协议。它有如下特点：多节点链接：下载一个文件可以同时链接多个源来提速轻量级：占用系统资源极少，一般下载任务内存占用 10mb 内全功能的 BitTorrent 客户端：支持 DHT, PEX, Encryption, Magnet URI, Web-Seeding, Selective Downloads, Local Peer Discovery and UDP tracker支持 metalink 链接支持远程控制：支持 RPC 界面控制 aria2 进程官网：https://aria2.github.io/GitHub 主页：https://github.com/aria2/aria2webui-aria2：https://github.com/ziahamza/webui-aria2aria2 下载安装从官方发布页下载对应平台的最新版包，我是 Windows x64 系统下载了 aria2-1.35.0-win-64bit-build1.zip：https://github.com/aria2/aria2/releases/ 解压压缩包到本地，我的解压目录是：C:\Users\Marco Nie\Application\aria2aria2c.exe 就是 aria2 主程序。命令行使用aria2 原生支持命令行控制，它的控制语句形式由 主程序 - 选项参数 - 链接 构成：aria2c [<OPTIONS>] [<URI>|<MAGNET>|<TORRENT_FILE>|<METALINK_FILE>] 全部的可用参数参考官方文档：https://aria2.github.io/manual/en/html/aria2c.html#synopsis下面简单介绍几个常用的下载命令修改下载目录终端里切换到 aria2 目录，使用下面命令将文件下载到 /home 目录下，使用参数 --dir 控制下载目录：aria2c --dir=/home http://www.file.zip 注意如果不定义 dir 目录，则默认下载到当前用户根目录。下载指定文档内的链接aria2c --input-file=dl.txt --max-concurrent-downloads=5 --dir=/home 下载 dl.txt 内所有的链接，同时下载5个文件。多路链接下载aria2c --split=5 http://www.file.zip 同时建立 5 个链接来下载这个文件，如果链接源速度不够快，这样可以达到提速效果。远程控制aric2c --enable-rpc=true --rpc-listen-all=true 开启远程控制，默认端口为 6800 可使用 --rpc-listen-port 参数修改。以上命令执行后，可以使用 JSON-RPC/XML-RPC 来控制，下一章节会详细介绍。指定配置文件aria2c --conf-path=/home/aria2.conf http://www.file.zip 当设置的 option 参数很多的时候，每次启动都敲入大量的命令就很麻烦了，可以将所有需要的配置参数放到一个配置文件里，使用 --conf-path 加载配置文件就可以了。由于命令行方式控制不便于个人使用，所以这里介绍以 webUI 的方式控制 aria2。webui-aria2webui-aria2 是一个官方推荐的 web RPC 控制器，图形化的界面方便管理进程。GitHub 主页：https://github.com/ziahamza/webui-aria2下载仓库包到本地：解压压缩包到本地，我放在了 aria2 文件夹目录，在 docs 文件夹下启动 indix.html 就打开了 web 控制面板：这时候页面会报错，因为 aria2 源程序还没有启动，命令行执行一下指令启动 rpc：aric2c --enable-rpc=true --rpc-listen-all=true 刷新页面就可以连接到 aria2 了。下面系统介绍配置文件的建立和断点续传的使用。配置文件在 aria2 根目录下新建四个文件：aria2.conf，aria2.session，aria2.log，dht.dataria2.conf：aria2 的配置参数文件，定义了 aria2 的启动参数aria2.session：会话信息记录文件，用来进行断点续传aria2.log：日志文件dht.dat：DHT 网络路由缓存文件路径，BT 相关aria2.conf 推荐设置内容如下(自行修改里面的目录)：# 文件的保存路径(可使用绝对路径或相对路径), 默认: 当前启动位置 dir=C:\Users\Marco Nie\Downloads # 启动的时候，从会话文件中读取下载任务 input-file=C:\Users\Marco Nie\Application\aria2\aria2.session # 在Aria2退出时保存`错误/未完成`的下载任务到会话文件 save-session=C:\Users\Marco Nie\Application\aria2\aria2.session # DHT 路由文件路径，BT 相关 dht-file-path=C:\Users\Marco Nie\Application\aria2\dht.dat # log 日志文件，没有的话输出到 stdout log=C:\Users\Marco Nie\Application\aria2\aria2.log # 日志级别 debug, info, notice, warn or error. Default: debug log-level=warn #下载完成后执行脚本 # on-download-complete=执行脚本 # Windows 下不关闭的话会出现 Timeout while contacting DNS servers async-dns=false # 启用磁盘缓存, 0为禁用缓存, 需1.16以上版本, 默认:16M #disk-cache=32M #disk-cache=32M # 文件预分配方式, 能有效降低磁盘碎片, 默认:prealloc # 预分配所需时间: none < falloc < trunc < prealloc # falloc和trunc则需要文件系统和内核支持 # NTFS建议使用falloc, EXT3/4建议trunc, MAC 下需要注释此项 file-allocation=prealloc # 断点续传 continue=true ## 下载连接相关 ## # 最大同时下载任务数, 运行时可修改, 默认:5 max-concurrent-downloads=10 # 同一服务器连接数, 添加时可指定, 默认:1 最大16 max-connection-per-server=16 # 最小文件分片大小, 添加时可指定, 取值范围1M -1024M, 默认:20M # 假定size=10M, 文件为20MiB 则使用两个来源下载; 文件为15MiB 则使用一个来源下载 min-split-size=10M # 单个任务最大线程数, 添加时可指定, 默认:5 split=5 # 整体下载速度限制, 运行时可修改, 默认: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 # 定时保存会话, 0为退出时才保存, 需1.16.1以上版本, 默认:0 save-session-interval=60 ## RPC相关设置 ## # 启用RPC, 默认:false enable-rpc=true # 添加任务后默认暂停下载 pause=false # 允许所有来源, 默认:false rpc-allow-origin-all=true # 允许外网访问, 默认:false rpc-listen-all=true # save torrent or metalink meta data to --dir rpc-save-upload-metadata=true # 设置的RPC授权令牌, v1.18.4新增功能, 取代 --rpc-user 和 --rpc-passwd 选项 rpc-secret=<设置自定义 token，要和远程设置一样> # RPC监听端口, 端口被占用时可以修改, 默认:6800 rpc-listen-port=6800 ## BT/PT下载相关 ## # 当下载的是一个种子(以.torrent结尾)时, 自动开始BT任务, 默认:true follow-torrent=true # BT监听端口, 当端口被屏蔽时使用, 默认:6881-6999 #listen-port=51413 # 单个种子最大连接数, 默认:55 bt-max-peers=55 # 打开DHT功能, PT需要禁用, 默认:true enable-dht=true # 打开IPv6 DHT功能, PT需要禁用 #enable-dht6=false # DHT网络监听端口, 默认:6881-6999 dht-listen-port=6881-6999 # 本地节点查找, PT需要禁用, 默认:false bt-enable-lpd=true # 种子交换, PT需要禁用, 默认:true enable-peer-exchange=true # 每个种子限速, 对少种的PT很有用, 默认:50K #bt-request-peer-speed-limit=50K # 客户端伪装, PT需要 #peer-id-prefix=-TR2770- user-agent=Transmission/2.92 #user-agent=netdisk;4.4.0.6;PC;PC-Windows;6.2.9200;WindowsBaiduYunGuanJia # 当种子的分享率达到这个数时, 自动停止做种, 0为一直做种, 默认:1.0 seed-ratio=1.0 #作种时间大于30分钟，则停止作种 seed-time=30 # 强制保存会话, 话即使任务已经完成, 默认:false，BitTorrent seeding which is recognized as completed state #force-save=false # BT校验相关, 默认:true #bt-hash-check-seed=true # 继续之前的BT任务时, 无需再次校验, 默认:false bt-seed-unverified=true # 保存磁力链接元数据为种子文件(.torrent文件), 默认:false bt-save-metadata=true # 加密传输 防止吸血 bt-force-encryption=true # 添加自定义的 bt tracker 地址，从 https://github.com/ngosang/trackerslist 找最新的链接 bt-tracker=udp://tracker.coppersurfer.tk:6969/announce,udp://tracker.leechers-paradise.org:6969/announce,udp://tracker.opentrackr.org:1337/announce,udp://p4p.arenabg.com:1337/announce,udp://9.rarbg.to:2710/announce,udp://9.rarbg.me:2710/announce,udp://tracker.internetwarriors.net:1337/announce,udp://exodus.desync.com:6969/announce,udp://tracker.tiny-vps.com:6969/announce,udp://tracker.torrent.eu.org:451/announce,udp://tracker.cyberia.is:6969/announce,udp://open.stealth.si:80/announce,udp://open.demonii.si:1337/announce,udp://denis.stalker.upeer.me:6969/announce,udp://tracker.sbsub.com:2710/announce,udp://tracker.moeking.me:6969/announce,udp://retracker.lanta-net.ru:2710/announce,udp://ipv4.tracker.harry.lu:80/announce,udp://explodie.org:6969/announce,udp://zephir.monocul.us:6969/announce启动 aria2上述文件设置完毕后，就可以启动 aria2 了，在终端执行如下命令：cd /to/aria2/path aria2c --conf-path=aria2.conf 然后启动 webui-aria2 的 index.html 网页，根据 aria2.conf 配置文件情况设置 setting - connection 内容，就可以正常使用了。我将 webui-aria2 托管到了我的网站：https://webui-aria2.niekun.net。但是发现如果 webui 是 https 的就无法连接上 aria2 了，查了下好像是 web 加密问题，所以还是把 webui-aria2 放在本地使用吧。外网远程控制如果服务器在内网，可能需要进行内网穿透，可以参考我的 frp 教程，建立 http 转发：https://niekun.net/archives/539.htmlfrpc 配置示例片段：[aria2] type = http local_ip = 127.0.0.1 local_port = 6800 subdomain = aria2 use_encryption = true use_compression = true如果按照我 frp 教程配置 nginx 代理 frp 的话，完成后就可以通过：https://aria2.youdomain.net:443 来控制 aria2 了。开机自启动可以建立脚本来实现开机自启动。Windows在 aria2 目录新建 bat 文件，内容如下：@echo off if "%1" == "h" goto begin mshta vbscript:createobject("wscript.shell").run("""%~nx0"" h",0)(window.close)&&exit :begin REM cd %USERPROFILE%\Application\aria2 aria2c --conf-path=aria2.conf exit建立脚本快捷方式，将快捷方式放到开机启动文件夹内即可，Windows 10 开机启动目录为：%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup下载完成执行脚本使用配置文件里的 on-download-complete 选项，可以实现自定义的功能。在 aria2 下载完成后，执行 on-download-complete 脚本时会自动传递三个参数：GID GID is an ID of a download which aria2c uses to identify a particular download下载文件个数文件路径示例：$ cat hook.sh #!/bin/sh echo "Called with [$1] [$2] [$3]" $ aria2c --on-download-complete hook.sh http://example.org/file.iso Called with [1] [1] [/path/to/file.iso]Linux 下可以编写 bash 脚本。windows 下可以执行 bat 脚本，注意 bat 脚本必须和配置文件在一个路径，否则报错。我实现的功能是下载完成后触发一个系统通知。Linux 脚本我测试了 macos 下的脚本，使用了 AppleScript 实现，在 bash 中使用 as 可以使用 osascript 命令，脚本内容如下：#!/bin/sh osascript -e 'display notification "download complete" sound name "Pop.aiff"'具体参考我的 osascript 教程：https://blog.niekun.net/archives/1773.htmlWindows 脚本Windows 脚本使用 powershell 实现，由于 aria2 只能调用 bat 批处理脚本，且必须在和主程序同一个目录下，所以再编写一个 bat 脚本调用 ps 脚本，稍微复杂一些。bat 脚本：script.bat@ECHO OFF set arg1=%3 PowerShell.exe -Command "&'path\to\download-complete.ps1' %arg1%" PAUSEbat 脚本里传入参数使用 %0，%1，%2 等表示，%0 表示所有传入参数，%1 表示第一个参数。内部定义参数使用 set 命令，使用变量时前后加上百分号 %，如：%arg1%。以上脚本内容是：读取传入的下载文件地址参数，使用 powershell 执行 ps 脚本且传递读取的文件地址。powershell 脚本：download-complete.ps1$var1 = $args[0] # Write-Output $var1 Add-Type -AssemblyName System.Windows.Forms $global:balmsg = New-Object System.Windows.Forms.NotifyIcon $path = (Get-Process -id $pid).Path $balmsg.Icon = [System.Drawing.Icon]::ExtractAssociatedIcon($path) $balmsg.BalloonTipIcon = [System.Windows.Forms.ToolTipIcon]::Warning $balmsg.BalloonTipText = "Path is $var1" $balmsg.BalloonTipTitle = "download complete" $balmsg.Visible = $true $balmsg.ShowBalloonTip(20000)保存以上两个脚本到 aria2.conf 配置文件一个目录下，然后修改配置文件：on-download-complete=script.bat 重新运行 aria2，下载文件测试效果。实现更多的脚本功能，可以参考开源项目：https://github.com/P3TERX/aria2.conf