把下载器变成服务:开启 RPC 远程控制接口
RPC 是什么
RPC 让 aria2 从"跑完就退的命令"变成"一直在线的下载服务":其他程序(图形前端、脚本、手机 App)通过网络接口给它派任务、查进度、改配置。下载器本体不需要图形界面,界面由前端承担。
启动命令
aria2c --enable-rpc --rpc-listen-all
--enable-rpc:打开 RPC 服务(默认 false);--rpc-listen-all:监听所有网卡;不加则只监听本机回环地址——只在本机用前端时更安全,远程访问才需要打开;--rpc-listen-port:端口,默认 6800(可选范围 1024-65535)。
生产用法一般配合密钥与后台运行:
aria2c --enable-rpc --rpc-listen-all --rpc-secret=换成你的长随机字符串 -D
接口路径速查
| 接口 | 路径 | 说明 |
|---|---|---|
| JSON-RPC over HTTP | /jsonrpc | 支持 POST 与 GET(JSONP) |
| JSON-RPC over WebSocket | /jsonrpc(同端口) | 额外支持服务器主动推送通知 |
| XML-RPC | /rpc | 传统接口 |
JSON-RPC 基于 JSON-RPC 2.0 规范,字符编码用 UTF-8;WebSocket 地址就是同端口的同一路径换成 ws 协议。常用方法清单见RPC 方法速查。
验证服务活着
浏览器访问本机回环地址的 6800 端口 RPC 路径,或用前端连接测试。前端连接三要素:主机地址、端口 6800、密钥——见图形前端。
安全提醒
- 一定设置
--rpc-secret,公开网络上的无鉴权 RPC 等于把下载器交给任何人; - 只在本机用时别开
--rpc-listen-all; - 需要加密传输时可用
--rpc-secure配证书。