在统信UOS中部署Aria2需五步:一、用sudo apt install aria2安装;二、旧版可源码编译;三、创建~/.aria2/aria2.conf并启用RPC;四、配置systemd用户服务实现自启;五、用curl测试6800端口RPC连通性并对接AriaNg。

在统信UOS系统中部署Aria2下载工具,需完成安装、配置RPC服务、启用自启并对接Web管理界面,才能真正实现多线程、断点续传与远程控制功能。
用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。
创建配置文件并启用RPC远程控制
Aria2默认不开放远程调用接口,必须手动创建配置文件并显式启用RPC,否则AriaNg等Web界面无法连接。
执行 mkdir -p ~/.aria2 创建配置目录→运行 touch ~/.aria2/aria2.conf 生成空配置文件→用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中填写的密钥完全一致,否则连接失败且无明确报错提示。
配置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)”即表示服务已就绪。
用curl测试RPC端口连通性
这是确认Aria2是否真正对外提供JSON-RPC服务的关键验证步骤,不能跳过。
在终端中执行:curl http://localhost:6800/jsonrpc -X POST -H "Content-Type: application/json" --data '{"jsonrpc":"2.0","method":"system.listMethods","id":1}'
若返回包含大量method名称的JSON响应,说明RPC服务正常;若返回“Connection refused”或超时,则检查配置中rpc-listen-all=true是否拼写错误,或防火墙是否拦截6800端口。
对接AriaNg Web管理界面
方法一:本地直接访问(推荐初试)
下载AriaNg最新版(如v1.3.0),解压后双击index.html即可在浏览器中打开。在设置→RPC→填入:
RPC地址:http://127.0.0.1:6800
RPC密钥:UOS2024(与配置文件中rpc-secret值严格一致)→点击“保存”→页面右上角显示绿色“已连接”即成功。
方法二:部署到局域网其他设备访问
将AriaNg整个文件夹放入Nginx或Apache的web根目录,修改RPC地址为你的UOS本机IP(如http://192.168.1.100:6800),确保UOS防火墙放行6800端口:sudo ufw allow 6800。

















