Debian运行Aria2后台服务

Aria2在默认设置下运行时，会启动下载并在完成后退出。Aria2也支持以后台服务的模式在Linux系统下运行，提供 XML RPC 和 JSON RPC 接口供前台程序进行操控。本文以Debian Linux系统为例，简单介绍下这种玩法。

请将下文中的 <用户名> 替换为你的实际用户名。请将 vi 命令替换成你喜欢的文本编辑器，比如 nano。

先安装软件：

sudo apt install aria2 curl jq

建一个放配置的文件夹：

mkdir /home/<用户名>/.aria2

再建一个放下载的文件夹：

mkdir /home/<用户名>/aria2

创建一个空的进度文件：
touch /home/<用户名>/.aria2/session

创建后台服务的配置文件：

vi /home/<用户名>/.aria2/aria2.conf

内容是如下：

#下载文件夹
dir=/home/<用户名>/aria2

#启动后从这里读取进度
input-file=/home/<用户名>/.aria2/session

#日志文件
log=/home/<用户名>/.aria2/aria2.log

#这个太难解释了—。—
bt-detach-seed-only=true

#BT加载元数据
bt-load-saved-metadata=true

#BT保存元数据到torrent文件
bt-save-metadata=true

#BT做种前不验证以前下载的文件的完整性
bt-seed-unverified=true

#IPv4 DHT节点文件
dht-file-path=/home/<用户名>/.aria2/dht.dat

#IPv6 DHT节点文件
dht-file-path6=/home/<用户名>/.aria2/dht6.dat

#UDP监听端口
dht-listen-port=50414

#开启IPv6 DHT
enable-dht6=true

#TCP监听端口
listen-port=50414

#上传限速
max-overall-upload-limit=800K

#分享率达到指定值后停止做种
seed-ratio=0.0

#允许RPC远程操控
enable-rpc=true

#远程操控RPC监听端口
rpc-listen-port=6800

#以后台服务模式运行
daemon=true

#文件分配方法
file-allocation=falloc

#强制保存
force-save=true

#日志等级
log-level=notice

#下载限速
max-overall-download-limit=400K

#进度保存在这个文件
save-session=/home/<用户名>/.aria2/session
#配置结束

创建后台服务描述文件：
sudo vi /usr/local/lib/systemd/system/aria2.service
内容如下：
[Unit]
Description=Aria2
After=network-online.target
[Install]
WantedBy=multi-user.target
[Service]
User=<用户名>
ExecStart=aria2c
Type=forking

配置就到这里。下面安装后台服务：
sudo systemctl enable aria2

启动服务：
sudo systemctl start aria2

现在Aria2就在后台运行了。用 curl 测试一下RPC：

curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0", "id":"1", "method":"aria2.tellActive","params":[]}' 'http://[::1]:6800/jsonrpc' | jq

末尾的 jq 命令目的是将结果整理得易读。命令太复杂，搞个简易的脚本：
sudo vi /usr/local/bin/adm.sh
内容为：
#!/bin/bash
function help () {
echo "adm.sh is a helper script to interact with aria2 daemon through JSON RPC. It calls curl to pass method and arguments to aria2."
echo "Usage: adm.sh <method> <arg1>,<arg2>,... <jqs>"
echo " adm.sh -h|--help"
echo "Some useful methods and args:"
echo " aria2.addUri [<uri>]"
echo " aria2.remove <gid>"
echo " aria2.tellStatus <gid>"
echo " aria2.getPeers <gid>"
echo " aria2.tellActive"
echo " aria2.tellStopped <m>,<n>"
echo " aria2.getGlobalStat"
echo " aria2.shutdown"
echo "Default is tellActive if you run me without argument."
}
[ "$1" == "-h" ] || [ "$1" == "--help" ] && {
help
exit 0
}
RPC_METHOD=$1
RPC_PARAMS="$2"
JQ_ARG="$3"
UUID=$(cat /proc/sys/kernel/random/uuid)
[ $RPC_METHOD ] || RPC_METHOD=aria2.tellActive
curl -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0", "id":"'$UUID'", "method":"'${RPC_METHOD}'","params":['${RPC_PARAMS}']}' 'http://[::1]:6800/jsonrpc' | jq "$JQ_ARG"

修改下权限：
sudo chmod 755 /usr/local/bin/adm.sh

查看使用方法：

adm.sh -h