必须安装配置aria2:先用sudo apt install aria2 -y安装,再创建~/.aria2/aria2.conf并启用rpc,接着配置systemd用户服务实现开机自启,最后用curl测试6800端口确认json-rpc正常响应。

您需要在统信UOS系统中快速获得一个支持多线程、断点续传和远程控制的命令行下载工具,这就必须完成Aria2的安装与基础服务配置,整个过程不依赖图形界面且全程可复现。
用apt命令安装Aria2主程序
统信UOS基于Debian/Ubuntu体系,官方源已预置Aria2包,无需添加第三方仓库或编译源码。
打开终端(快捷键Ctrl+Alt+T)→执行sudo apt update更新软件包索引→运行sudo apt install aria2 -y安装主程序。
验证安装:输入aria2c --version,输出版本号(如1.36.0)即成功。若提示“command not found”,说明安装失败或未刷新shell缓存,可尝试重启终端或执行hash -r。
创建配置目录并生成空白配置文件
这一步操作起来很简单,直接把文件拖进去就行。
执行mkdir -p ~/.aria2创建配置目录→运行touch ~/.aria2/aria2.conf生成空配置文件。
【注意:路径必须是~/.aria2/aria2.conf,不能写成/etc/aria2/或/root/.aria2/,否则后续systemd服务无法读取】
配置RPC服务启用远程控制
Aria2默认不开放远程调用接口,必须手动启用RPC,否则Web界面或Uget等前端无法连接。
用nano编辑配置文件:nano ~/.aria2/aria2.conf,粘贴以下内容:
daemon=true
enable-rpc=true
rpc-allow-origin-all=true
rpc-listen-all=true
rpc-secret=UOS2024
dir=/home/$USER/Downloads
file-allocation=none
max-concurrent-downloads=5
max-connection-per-server=16
split=16
【rpc-secret值必须记住,后续AriaNg或Uget连接时需填完全一致的密钥,否则连接失败且无明确报错】
配置systemd用户服务实现开机自启
避免每次手动启动Aria2,将其注册为登录级systemd服务,确保用户登录后自动运行。
第一步:创建服务定义文件
执行mkdir -p ~/.config/systemd/user→运行nano ~/.config/systemd/user/aria2.service,写入:
[Unit]
Description=Aria2 RPC Service
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/aria2c --conf-path=%h/.aria2/aria2.conf --enable-rpc
Restart=on-failure
RestartSec=5
[Install]
WantedBy=default.target
第二步:启用并启动服务
执行systemctl --user daemon-reload→运行systemctl --user enable aria2.service→启动服务:systemctl --user start aria2.service。
第三步:验证服务状态
输入systemctl --user status aria2.service,看到“active (running)”即表示服务已就绪。
测试RPC端口连通性
这是确认Aria2是否真正可用的最后一步,必须验证6800端口是否响应JSON-RPC请求。
在终端中执行:curl -X POST http://localhost:6800/jsonrpc -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"system.listMethods","id":1}'。
若返回一大段包含“aria2.addUri”等方法名的JSON数据,说明RPC服务已正常监听;若返回“Connection refused”,请检查systemctl --user status aria2.service是否为active状态,并确认配置中rpc-listen-all=true已生效。











