aria2 中文文档 下载 App

把下载器变成服务:开启 RPC 远程控制接口

RPC 是什么

RPC 让 aria2 从"跑完就退的命令"变成"一直在线的下载服务":其他程序(图形前端、脚本、手机 App)通过网络接口给它派任务、查进度、改配置。下载器本体不需要图形界面,界面由前端承担。

启动命令

aria2c --enable-rpc --rpc-listen-all

生产用法一般配合密钥与后台运行:

aria2c --enable-rpc --rpc-listen-all --rpc-secret=换成你的长随机字符串 -D

密钥见RPC 密钥,后台运行见后台常驻。

接口路径速查

接口路径说明
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、密钥——见图形前端。

安全提醒