安裝

$ sudo apt install -y aria2

配置文件aria2.config

$ mkdir -p ~/.config/aria2/  # 創(chuàng)建配置文件夾
$ vi ~/.config/aria2/aria2.config   # 創(chuàng)建配置文件

配置文件內(nèi)容

################ 文件保存相關 ################
# 文件的保存路徑(可使用絕對路徑或相對路徑), 默認: 當前啟動位置
dir=/home/pi/disk/download
# 啟用磁盤緩存, 0為禁用緩存, 需1.16以上版本, 默認:16M
#disk-cache=32M
# 文件預分配方式, 能有效降低磁盤碎片, 默認:prealloc
# 預分配所需時間: none < falloc ? trunc < prealloc
# falloc和trunc則需要文件系統(tǒng)和內(nèi)核支持
# NTFS建議使用falloc, EXT3/4建議trunc, MAC 下需要注釋此項
#file-allocation=none
# 斷點續(xù)傳
continue=true

################ 下載連接相關 ################
# 最大同時下載任務數(shù), 運行時可修改, 默認:5
#max-concurrent-downloads=5
# 同一服務器連接數(shù), 添加時可指定, 默認:1
max-connection-per-server=5
# 最小文件分片大小, 添加時可指定, 取值范圍1M -1024M, 默認:20M
# 假定size=10M, 文件為20MiB 則使用兩個來源下載; 文件為15MiB 則使用一個來源下載
min-split-size=10M
# 單個任務最大線程數(shù), 添加時可指定, 默認: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
# 最大重試次數(shù), 設置為0表示不限制重試次數(shù), 默認:5
#max-tries=5
# 設置重試等待的秒數(shù), 默認: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], 不同系統(tǒng)默認值不同
#event-poll=select
# RPC監(jiān)聽端口, 端口被占用時可以修改, 默認: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 協(xié)議連接
#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監(jiān)聽端口, 當端口被屏蔽時使用, 默認:6881-6999
#listen-port=51413
# 單個種子最大連接數(shù), 默認:55
#bt-max-peers=55
# 打開DHT功能, PT需要禁用, 默認:true
#enable-dht=false
# 打開IPv6 DHT功能, PT需要禁用
#enable-dht6=false
# DHT網(wǎng)絡監(jiān)聽端口, 默認:6881-6999
#dht-listen-port=6881-6999
# 本地節(jié)點查找, 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
# 當種子的分享率達到這個數(shù)時, 自動停止做種, 0為一直做種, 默認:1.0
#seed-ratio=0
# 強制保存會話, 即使任務已經(jīng)完成, 默認:false
# 較新的版本開啟后會在任務完成后依然保留.aria2文件
#force-save=false
# BT校驗相關, 默認:true
#bt-hash-check-seed=true
# 繼續(xù)之前的BT任務時, 無需再次校驗, 默認:false
#bt-seed-unverified=true
# 保存磁力鏈接元數(shù)據(jù)為種子文件(.torrent文件), 默認:false
#bt-save-metadata=true

# 事件回調 钓葫，可以結合腳本库菲，實現(xiàn)很多自定義功能
# Aria2 會在特定的時候，調用指定的腳本程序找岖，然后將相關的參數(shù)傳遞進去
# on-download-complete=/Users/apple/腳本放置的目錄/on-download-complete.py
# 對于BitTorrent在下載完成并且播種結束后調用指定的命令
# on-bt-download-complete=/Users/apple/腳本放置的目錄/on-bt-download-complete.py
# 設置下載因錯誤導致中止后執(zhí)行的命令
#on-download-error=/Users/apple/腳本放置的目錄/on-download-error.py
# 設置下載暫停后要執(zhí)行的命令。
#on-download-pause=/Users/apple/腳本放置的目錄/on-download-pause.py
# 設置下載開始后要執(zhí)行的命令。
#on-download-start=/Users/apple/腳本放置的目錄/on-download-start.py
# 設置下載停止后要執(zhí)行的命令蘸际。
#on-download-stop=/Users/apple/腳本放置的目錄/on-download-stop.py

on-download-complete.py 腳本示例

aria2在執(zhí)行時將3個參數(shù)傳遞給指定的命令。
這些參數(shù)是：GID徒扶、文件數(shù)粮彤、文件路徑

#!/usr/bin/python
# -*- coding: utf-8 -*-
import sys
import os

gid=sys.argv[1] # gid
file_count=sys.argv[2] # 文件數(shù)量
file_path=sys.argv[3] # 文件路徑

拿到了aria2在執(zhí)行時傳來的3個參數(shù)，再根據(jù)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 : 數(shù)組溶浴，下載地址  例如: ['http://www.sss.xxxx.jpg']
                uris是指向同一資源的HTTP / FTP / SFTP / BitTorrent URI（字符串）數(shù)組乍迄。
                如果混合指向不同資源的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('請求的數(shù)據(jù)是：', data)
        jsonreq = data.encode()
        try:
            c = urlopen(self._RPC_URL, jsonreq)
            return c.read().decode('utf-8')
        except:
            return ''

    def get_files(self, gid):
        """
        根據(jù)gid重慢，獲取下載文件列表
        此方法返回由gid（字符串）表示的下載文件列表欠拾。
        響應體：
            index ： 從1開始的文件索引缕探，與多文件torrent中顯示的文件的順序相同。
            path ： 文件路徑墓臭。
            length ： 文件大谢骸（字節(jié)）核芽。
            completedLength ： 已完成此文件的長度（以字節(jié)為單位）。
                    請注意酵熙，總和可能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('請求的數(shù)據(jù)是：', data)
        jsonreq = data.encode()
        try:
            c = urlopen(self._RPC_URL, jsonreq)
            return json.loads(c.read().decode('utf-8'))
        except:
            return ""

測試啟動

注意：設置好配置浸须，還要創(chuàng)建該會話空白文件

$ 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系統(tǒng)是使用systemd來管理服務的删窒，會和最初init.d有一些差別裂垦。
我們創(chuàng)建并編輯aria.service文件
sudo vim /lib/systemd/system/aria.service
并輸入以下內(nèi)容：

[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服務狀態(tài) 
$ sudo systemctl status aria 
# 啟動肌索，停止蕉拢，重啟aria服務 
$ sudo systemctl（start、stop诚亚、restart） aria

話外

aria2的web管理界面（AriaNg）

一個網(wǎng)頁管理界面：
https://github.com/mayswind/AriaNg

瀏覽器插件

這些瀏覽器插件的功能就是將網(wǎng)頁下載連接直接添加到aira2晕换。
Safari2Aria: 在Safari中管理Aria2，并且劫持默認下載方式
115下載助手: 使用Aria2下載115資源 注：115網(wǎng)盤下載壓縮包很大幾率出現(xiàn)數(shù)據(jù)損壞
BaiduExporter: 網(wǎng)盤助手, 使用Aria2下載百度網(wǎng)盤資源站宗。
YAAW for Chrome: 在chrome中直接內(nèi)置一個YAAW闸准，用于直接管理Aria2
迅雷離線助手 將迅雷離線任務遷移到aria。

下載速度慢問題

很多伙伴會發(fā)現(xiàn)梢灭，使用aria2沒有迅雷下載快夷家，甚至下不動蒸其，這是因為迅雷有自己的服務器，而Aria2沒有加速服務器库快，有些種子一直沒幾個人上傳導致只有幾KB的速度甚至完全沒速度摸袁，這種情況下該怎么辦呢？
給Aria2添加Tracker义屏，讓Aria2不只是從DHT網(wǎng)絡或者種子文件中存儲的Tracker信息靠汁，從而找到更多的下載源。

這里建議添加trackers_best (20 trackers)闽铐，最優(yōu)的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