啟動Aria2 RPC Server
直接在終端中執行aria2c --enable-rpc --rpc-allow-origin-all
可直接開啟RPC服務。
這種方法並不能進行個性化的參數設置,需要用到下面的方法。
使用配置文件啟動Aria2 RPC Server
創建配置文件
$ mkdir ~/.config/aria2
$ touch ~/.config/aria2/aria2.session #用於保存日志
$ touch ~/.config/aria2/aria2.conf #創建配置文件
以配置文件方式啟動Aria2
使用aria2c --conf-path=$HOME/.config/aria2/aria2.conf
啟動aria2,也可添加-D
選項,后台啟動aria2。
建議將以上命令添加到alias
中或啟用開機自啟動。
aria2.conf配置文件示例,僅供參考
## '#'開頭為注釋內容, 選項都有相應的注釋說明, 根據需要修改 ##
## 被注釋的選項填寫的是默認值, 建議在需要修改時再取消注釋 ##
## 進度保存相關 ##
# 從會話文件中讀取下載任務
#input-file=aria2.session
# 在Aria2退出時保存`錯誤/未完成`的下載任務到會話文件
#save-session=aria2.session
# 定時保存會話, 0為退出時才保存, 需1.16.1以上版本, 默認:0
#save-session-interval=60
## 文件保存相關 ##
# 文件的保存路徑, 默認: 當前啟動位置
#dir=/tmp/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
# 連接超時時間, 默認:60
#timeout=60
# 最大重試次數, 設置為0表示不限制重試次數, 默認:5
#max-tries=5
# 設置重試等待的秒數, 默認:0
#retry-wait=0
## 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>
# 是否啟用 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
注意
使用前需要修改配置dir
為下載目錄,input-file
和save-session
為aria2.session所在路徑,才可以正常啟動。
aria2.conf
中的路徑支持絕對路徑和相對路徑,遺憾的是並不支持環境變量,如果多用戶使用,需要每個用戶一個配置文件。推薦使用絕對路徑。