在统信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。
