安装
$ sudo apt install -y aria2
配置文件aria2.config
$ mkdir -p ~/.config/aria2/ # 创建配置文件夹
$ vi ~/.config/aria2/aria2.config # 创建配置文件
配置文件内容
################ 文件保存相关 ################
# 文件的保存路径(可使用绝对路径或相对路径), 默认: 当前启动位置
dir=/home/pi/disk/download
# 启用磁盘缓存, 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
# 连接超时时间, 默认:60
#timeout=60
# 最大重试次数, 设置为0表示不限制重试次数, 默认:5
#max-tries=5
# 设置重试等待的秒数, 默认:0
#retry-wait=0
################ 进度保存相关 ################
# 从会话文件中读取下载任务
input-file=/home/pi/.config/aria2/aria2.session
# 在Aria2退出时保存`错误/未完成`的下载任务到会话文件
save-session=/home/pi/.config/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=设置成自己的密码
# 设置的RPC访问用户名, 此选项新版已废弃, 建议改用 --rpc-secret 选项
#rpc-user=<USER>
# 设置的RPC访问密码, 此选项新版已废弃, 建议改用 --rpc-secret 选项
#rpc-passwd=<PASSWD>
# 是否启用 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
################ 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
# 事件回调 ，可以结合脚本，实现很多自定义功能
# Aria2 会在特定的时候，调用指定的脚本程序，然后将相关的参数传递进去
# on-download-complete=/Users/apple/脚本放置的目录/on-download-complete.py
# 对于BitTorrent在下载完成并且播种结束后调用指定的命令
# on-bt-download-complete=/Users/apple/脚本放置的目录/on-bt-download-complete.py
# 设置下载因错误导致中止后执行的命令
#on-download-error=/Users/apple/脚本放置的目录/on-download-error.py
# 设置下载暂停后要执行的命令。
#on-download-pause=/Users/apple/脚本放置的目录/on-download-pause.py
# 设置下载开始后要执行的命令。
#on-download-start=/Users/apple/脚本放置的目录/on-download-start.py
# 设置下载停止后要执行的命令。
#on-download-stop=/Users/apple/脚本放置的目录/on-download-stop.py
on-download-complete.py 脚本示例
aria2在执行时将3个参数传递给指定的命令。
这些参数是：GID、文件数、文件路径
#!/usr/bin/python
# -*- coding: utf-8 -*-
import sys
import os
gid=sys.argv[1] # gid
file_count=sys.argv[2] # 文件数量
file_path=sys.argv[3] # 文件路径
拿到了aria2在执行时传来的3个参数，再根据Aria2提供的jsonrpc接口，
可以自己写出一些脚本，来获取下载的各种信息。
完整的文档地址：https://aria2.github.io/manual/en/html/aria2c.html
下面是一个简单的脚本例子：
import json
from urllib.request import urlopen
class Aria2Utils(object):
# Aria2的RPC链接地址
def __init__(self, rpc_url='http://localhost:6800/jsonrpc', json_rpc='2.0', id='qwer', token="token:xxx"):
self._RPC_URL = rpc_url
self._JSON_RPC = json_rpc
self._ID = id
self._TOKEN = token
def download_file(self, uris, save_dir=''):
"""
下载文件的方法
:param uris : 数组，下载地址 例如: ['http://www.sss.xxxx.jpg']
uris是指向同一资源的HTTP / FTP / SFTP / BitTorrent URI（字符串）数组。
如果混合指向不同资源的URI，则下载可能会失败或在没有aria2抱怨的情况下被破坏。
添加BitTorrent Magnet URI时，uris必须只有一个元素，它应该是BitTorrent Magnet URI。
:param save_dir: 保存文件的目录。为空时使用默认目录
:return:
"""
params = [
self._TOKEN,
uris
]
if save_dir:
params_ex = {'dir': save_dir}
params.append(params_ex)
data = json.dumps(
{
'jsonrpc': self._JSON_RPC,
'id': self._ID,
'method': 'aria2.addUri',
'params': params,
})
# print('请求的数据是：', data)
jsonreq = data.encode()
try:
c = urlopen(self._RPC_URL, jsonreq)
return c.read().decode('utf-8')
except:
return ''
def get_files(self, gid):
"""
根据gid，获取下载文件列表
此方法返回由gid（字符串）表示的下载文件列表。
响应体：
index ： 从1开始的文件索引，与多文件torrent中显示的文件的顺序相同。
path ： 文件路径。
length ： 文件大小（字节）。
completedLength ： 已完成此文件的长度（以字节为单位）。
请注意，总和可能completedLength小于 方法completedLength返回的总和aria2.tellStatus()。
这是因为，completedLength在 aria2.getFiles() 仅包括完成作品。
在另一方面，completedLength 在aria2.tellStatus()还包括部分完成的块。
selected ： true如果通过--select-file选项选择此文件。
如果 --select-file未指定或者这是单文件torrent或根本不是torrent下载，
则此值始终为true。否则 false。
uris ： 返回此文件的URI列表。元素类型与aria2.getUris()方法中使用的结构相同。
:param gid:
:return:
"""
params = [self._TOKEN, gid]
data = json.dumps(
{
'jsonrpc': self._JSON_RPC,
'id': self._ID,
'method': 'aria2.getFiles',
'params': params,
})
# print('请求的数据是：', data)
jsonreq = data.encode()
try:
c = urlopen(self._RPC_URL, jsonreq)
return json.loads(c.read().decode('utf-8'))
except:
return ""
测试启动
注意：设置好配置，还要创建该会话空白文件
$ touch /home/pi/.config/aria2/aria2.session #测试下aria2是否启动成功 $ aria2c --conf-path=/home/pi/.config/aria2/aria2.config # 用 ps aux|grep aria2 看是否有进程启动，若有说明启动成功了。 # 附：强制结束进程kill -9 3140（相应pid）
设置aria2服务和开机启动（树莓派）
我们用的Raspbian系统是使用systemd来管理服务的，会和最初init.d有一些差别。
我们创建并编辑aria.service文件
sudo vim /lib/systemd/system/aria.service
并输入以下内容：[Unit] Description=aria2c -- file download manager After=network.target [Service] Type=forking User=%i WorkingDirectory=%h Environment=VAR=/var/%i ExecStart=/usr/bin/aria2c --daemon --enable-rpc --rpc-listen-all --rpc-allow-origin-all -c -D --conf-path=/etc/aria2/aria2.conf [Install] WantedBy=multi-user.target# 重新载入服务，并设置开机启动 $ sudo systemctl daemon-reload $ sudo systemctl enable aria # 查看aria服务状态 $ sudo systemctl status aria # 启动，停止，重启aria服务 $ sudo systemctl（start、stop、restart） aria
话外
aria2的web管理界面（AriaNg）
一个网页管理界面：
https://github.com/mayswind/AriaNg
浏览器插件
这些浏览器插件的功能就是将网页下载连接直接添加到aira2。
Safari2Aria: 在Safari中管理Aria2，并且劫持默认下载方式
115下载助手: 使用Aria2下载115资源 注：115网盘下载压缩包很大几率出现数据损坏
BaiduExporter: 网盘助手, 使用Aria2下载百度网盘资源。
YAAW for Chrome: 在chrome中直接内置一个YAAW，用于直接管理Aria2
迅雷离线助手 将迅雷离线任务迁移到aria。
下载速度慢问题
很多伙伴会发现，使用aria2没有迅雷下载快，甚至下不动，这是因为迅雷有自己的服务器，而Aria2没有加速服务器，有些种子一直没几个人上传导致只有几KB的速度甚至完全没速度，这种情况下该怎么办呢？
给Aria2添加Tracker，让Aria2不只是从DHT网络或者种子文件中存储的Tracker信息，从而找到更多的下载源。这里建议添加
trackers_best (20 trackers)，最优的20条。
链接：https://github.com/ngosang/trackerslist# 进入aira2配置 vim ~/.config/aria2/aria2.config # 添加如下(自行用“,”分隔每个tarck) bt-tracker=udp://tracker.coppersurfer.tk:6969/announce,udp://tracker.open-internet.nl:6969/announce,udp://tracker.skyts.net:6969/announce,udp://tracker.piratepublic.com:1337/announce,udp://tracker.opentrackr.org:1337/announce,udp://9.rarbg.to:2710/announce,udp://retracker.coltel.ru:2710/announce,udp://pubt.in:2710/announce,udp://public.popcorn-tracker.org:6969/announce,udp://z.crazyhd.com:2710/announce,udp://wambo.club:1337/announce,udp://tracker4.itzmx.com:2710/announce,udp://tracker1.wasabii.com.tw:6969/announce,udp://tracker.zer0day.to:1337/announce,udp://tracker.xku.tv:6969/announce,udp://tracker.vanitycore.co:6969/announce,udp://ipv4.tracker.harry.lu:80/announce,udp://inferno.demonoid.pw:3418/announce,udp://open.facedatabg.net:6969/announce,udp://mgtracker.org:6969/announce
