如何配置-Aria2-来进行文件下载

jiezi

5 年前

aria2 是一个轻量级的多协议和多源命令行下载实用程序。它支持 HTTP / HTTPS，FTP，SFTP，BitTorrent 和 Metalink。aria2 可以通过内置的 JSON-RPC 和 XML-RPC 接口进行操作。

上面是官网对 Aria2 的介绍，讲的直白一点，Aria2 就是一个下载工具，它最大的优势就是下载速度快，基本可以达到你网络带宽的满速，同时支持的协议很多，不管你的下载链接是以 http，https 开头，还是以 magent 开头的磁力链接以及 BT 种子，它都可以下载。

如果你没有安装包管理工具 Homebrew，那么先在终端输入下面的命令安装:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

然后在终端输入下面的命令安装 Aria2:

brew install aria2

安装完成后，我们需要创建一个配置文件 aria2.conf，将其放在 ~/.aria2文件夹中。依次在终端输入以下命令:

cd ~
mkdir .aria2
cd .aria2
touch aria2.conf

其中，命令 cd 的作用是切换路径，mkdir的作用是创建文件夹，touch的作用是新建文件。
然后打开 Finder，同时按下 command、shift、G，进入文件夹:~/.aria2(以 . 开头的文件夹为隐藏文件夹，如果想直接从 Finder 中找到这个文件夹，需要先同时按下 command、shift、. 显示隐藏文件)，就可以看到配置文件 aria2.conf，利用文本编辑器打开，将下面的信息复制进去:

## '#' 开头为注释内容, 选项都有相应的注释说明, 根据需要修改 ##
## 被注释的选项填写的是默认值, 建议在需要修改时再取消注释  ##

## 文件保存相关 ##

# 文件的保存路径 (可使用绝对路径或相对路径), 默认: 当前启动位置
dir=/Users/mofiter/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
max-connection-per-server=5
# 最小文件分片大小, 添加时可指定, 取值范围 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

## 进度保存相关 ##

# 从会话文件中读取下载任务
input-file=/usr/local/Cellar/aria2/aria2.session
# 在 Aria2 退出时保存 ` 错误 / 未完成 ` 的下载任务到会话文件
save-session=/usr/local/Cellar/aria2/aria2.session
# 定时保存会话, 0 为退出时才保存, 需 1.16.1 以上版本, 默认:0
#save-session-interval=60

## RPC 相关设置 ##

# 启用 RPC, 默认:false
enable-rpc=true
# 允许所有来源, 默认:false
rpc-allow-origin-all=true
# 允许非外部访问, 默认:false
rpc-listen-all=true
# 事件轮询方式, 取值:[epoll, kqueue, port, poll, select], 不同系统默认值不同
#event-poll=select
# RPC 监听端口, 端口被占用时可以修改, 默认:6800
#rpc-listen-port=6800
# 设置的 RPC 授权令牌, v1.18.4 新增功能, 取代 --rpc-user 和 --rpc-passwd 选项
#rpc-secret=<TOKEN>
# 设置的 RPC 访问用户名, 此选项新版已废弃, 建议改用 --rpc-secret 选项
#rpc-user=<USER>
# 设置的 RPC 访问密码, 此选项新版已废弃, 建议改用 --rpc-secret 选项
#rpc-passwd=<PASSWD>

## BT/PT 下载相关 ##

# 当下载的是一个种子(以.torrent 结尾) 时, 自动开始 BT 任务, 默认:true
#follow-torrent=true
# BT 监听端口, 当端口被屏蔽时使用, 默认:6881-6999
listen-port=51413
# 单个种子最大连接数, 默认:55
#bt-max-peers=55
# 打开 DHT 功能, PT 需要禁用, 默认:true
enable-dht=false
# 打开 IPv6 DHT 功能, PT 需要禁用 
#enable-dht6=false
# DHT 网络监听端口, 默认:6881-6999
#dht-listen-port=6881-6999
# 本地节点查找, PT 需要禁用, 默认:false
#bt-enable-lpd=false
# 种子交换, PT 需要禁用, 默认:true
enable-peer-exchange=false
# 每个种子限速, 对少种的 PT 很有用, 默认:50K
#bt-request-peer-speed-limit=50K
# 客户端伪装, PT 需要
peer-id-prefix=-TR2770-
user-agent=Transmission/2.77
# 当种子的分享率达到这个数时, 自动停止做种, 0 为一直做种, 默认:1.0
seed-ratio=0
# 强制保存会话, 即使任务已经完成, 默认:false
# 较新的版本开启后会在任务完成后依然保留.aria2 文件
#force-save=false
# BT 校验相关, 默认:true
#bt-hash-check-seed=true
# 继续之前的 BT 任务时, 无需再次校验, 默认:false
bt-seed-unverified=true
# 保存磁力链接元数据为种子文件(.torrent 文件), 默认:false
bt-save-metadata=true

将其中的 dir 改为自己想要保存下载文件的路径。

在终端输入下面命令即可启用(注意更改其中的 xxx 为你自己的电脑用户名):

aria2c --conf-path="/Users/xxx/.aria2/aria2.conf" -D

如果你不想每次用的时候都要在终端输入上面的命令开启，你可以将其设为开机自启，这样就方便多了。在终端依次输入下列命令:

cd ~/Library/LaunchAgents
touch aria2.plist

然后打开 Finder，同时按下 command、shift、G，进入文件夹: ~/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>RunAtLoad</key>
        <true />
        <key>Label</key>
        <string>aria2</string>
        <key>ProgramArguments</key>
        <array>
            <string>/usr/local/bin/aria2c</string>
        </array>
        <key>WorkingDirectory</key>
        <string>/Users/mofiter/Downloads</string>
    </dict>
</plist>

将 <array></array> 中的值改为自己电脑上 aria2c 命令的路径，可以在终端输入 which aria2c 查看，将 WorkingDirectory 后面的 <string></string> 中的值改为自己的下载路径。然后在终端依次输入下列命令:

chmod 644 aria2.plist
launchctl load aria2.plist
launchctl start aria2

这样，开机自启就设置成功了，如果你重新启动 Mac，你会发现在活动监视器里面进程 aria2c 是存在的。

官方没有给出 Windows 版本的安装包，需要自己利用源代码 build，这对一般人来说太难了，所以很多网友自制了懒人版，我这里选用青小蛙的版本，在此表示感谢，由于他给的下载地址是百度云盘，我担心资源失效，所以将其另存到了 coding.net，可以点此下载，下载完之后解压并将其保存到一个你常用的软件安装路径即可，并不需要安装什么。

在解压后的文件夹里面有一个 config.conf 文件，用文本编辑器打开，然后根据自己的需要修改相应选项，这里可能需要修改的是 dir=./downloads，是下载文件的保存路径，如果你不修改，下载的文件将会保存在你解压的文件夹里面的downloads 文件夹里面。

点击文件夹里面的 aria2 启动.VBS，即可开启 Aria2，这时你去任务管理器的进程可以看到名为aria2c.exe 的进程。

每次开机之后都要重新打开上面的文件来启动 Aria2 也有点烦，你可以将其设为开机自启。Windows 上面将一个程序设为开机自启有两种方式，一种是和登录用户绑定，即用户登录时才启动，假如你电脑上有 2 个用户 A 和 B，你给 A 设置了一个开机启动的任务，那么当你电脑开机后是 B 用户登录时，这个任务就不会启动。某个用户的启动文件夹为:C:\Users\xxx\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup，这里的 xxx 为用户名，然后给前面的 aria2 启动.VBS 文件创建一个快捷方式，将这个快捷方式放到这个启动文件夹里面就可以了，注意不要直接将 aria2 启动.VBS 文件放到文件夹，因为此文件在启动 Aria2 时用的是相对路径，如果你将此文件放到启动文件夹，它将找不到 Aria2 程序。第二种是和登录用户无关的，不管登录哪个用户都能启动，这个启动文件夹是:C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp，将创建的 aria2 启动.VBS 文件的快捷方式放到此文件夹就可以了。设置了开机自启之后，你关机重启电脑仍然可以在任务管理器里看到 aria2c.exe 进程。
注意: AppData 和 ProgramData 文件夹都是隐藏文件夹，请先选中查看隐藏的项目。

当你在 Mac 或者 Windows 上安装配置好 Aria2 时，你就可以通过其下载文件了。Aria2 有命令行，web UI，GUI 三种使用方式，这里推荐 web UI(命令行太麻烦，GUI 也不是太稳定，而 web UI 使用不区分平台，很方便)。可以选择的 web UI 有 Aria2 WebUI、Aria2 Web 控制台、Aria2 管理等，我这里选择 Aria2 WebUI。打开网站后，在 设置→连接设置 里面将主机改为 127.0.0.1，端口改为6800，然后应该就会提示连接成功。

如果仍然提示无法连接到 Aria2 服务器，请检查自己在之前配置文件 aria2.conf(Mac) 或config.conf(Windows)中的端口是不是 6800 以及自己电脑是不是设置了代理。
连接成功后，点击 添加→使用链接，将你要下载的文件地址输入进去就可以下载了(可以用这个链接 https://coding.net/u/mofiter/… 测试，是一张 2KB 大小的 PNG 格式的图片)。

当文件比较多的时候，我们不可能每次都复制一个文件的下载地址进来手动添加下载任务，这时就能用到 Aria2 的 JSON-RPC 接口。RPC(Remote Procedure Call)是远程过程调用的意思，你可以在你的程序 (Python、JavaScript、Java 等等) 中创建一个网络请求，来调用我们之前配置好的 Aria2 下载文件。

假设我们要下载的文件的下载地址为 https://coding.net/u/mofiter/…，我们要将其保存的路径为 D:\Downloads，要保存的文件名为 button.png，那么我们可以这样写:

import requests
import json
url = 'http://127.0.0.1:6800/jsonrpc'
download_url = "https://coding.net/u/mofiter/p/public_files/git/raw/master/go_to_bottom_button.png"
json_rpc = json.dumps({'id': '','jsonrpc':'2.0','method':'aria2.addUri','params': [[download_url], {'dir':'D:\Downloads','out':'button.png'}]
})
response = requests.post(url=url, data=json_rpc)
print(response)

params 是一个数组，里面的第一个数组元素里面放的是下载路径，而第二个字典元素里面的 dir 表示文件的保存路径，out 表示文件名。请求成功后会返回一个 json，里面包含 id、jsonrpc、result 等字段。然后你去 D:\Downloads 就能找到我们要的文件 button.png 了，当然如果你要下载的文件很大时，它可能还在下载，这时会有一个同名的以 .aria2 结尾的文件，当下载结束后这个文件就会消失。

假设我们要下载的文件地址，文件保存地址以及文件名和上面的一样，那我们可以这样写:

url = 'http://127.0.0.1:6800/jsonrpc'
download_url = "https://coding.net/u/mofiter/p/public_files/git/raw/master/go_to_bottom_button.png"
var json_rpc = {
            id:'',
            jsonrpc:'2.0',
            method:'aria2.addUri',
            params:[[download_url],
                {
                    dir:"'D:\Downloads'",
                    out:"button.png"
                }
            ]
        };
$.ajax({
            url:url,
            type:'POST',
            crossDomain:true,
            processData:false,
            data:JSON.stringify(json_rpc),
            contentType: 'application/json',
            success:function(response){console.log(response);
            }
        });

理论上，只要是互联网上你能找到下载地址的音乐，视频，图片等等任何东西，你都可以通过这种接口调用的方式来下载。使用比较广泛的有百度云盘导出下载 https://chrome.google.com/webstore/detail/baiduexporter/jgebcefbdjhkhapijgbhkidaegoocbjj，打不开的看这里 http://chromecj.com/accessibi…。我也写了几个油猴脚本，可以用来批量下载网易云课堂的免费课程、批量下载中国大学 MOOC 的课程、批量下载 Udemy 的订阅课程，欢迎体验。最后，通过公众号“极课助手”去购买“极客时间”所有课程，可以获得高额返现，最高可返 51 元，想了解更多技术知识，可以关注“极课助手”公众号。

(正文完)

参考文章:

Mac 下开机启动 Aria2
aria2 懒人安装教程
win10 的开机启动文件夹在哪及开机自动启动软件

如何配置-Aria2-来进行文件下载

什么是 Aria2？

如何在 Mac 上配置 Aria2

安装 Aria2

配置 Aria2

开启 Aria2

让 Aria2 开机自启

如何在 Windows 上配置 Aria2

安装 Aria2

配置 Aria2

开启 Aria2

让 Aria2 开机自启

如何使用 Aria2 下载文件

通过 JSON-RPC 接口下载文件

如何在 Python 中利用 JSON-RPC 发送请求下载文件

如何在 JavaScript 中利用 JSON-RPC 发送请求下载文件

JSON-RPC 可以用来做什么