统信uos上通过浏览器使用aria2需三步:一、用apt安装含enable_rpc的aria2c(≥1.36.0);二、创建~/.aria2/aria2.conf并配置enable-rpc、rpc-listen-all、rpc-secret等5项核心参数;三、部署ariang或webui-aria2,填localhost:6800及密钥uos2024完成连接。

您想在统信UOS上通过浏览器图形界面操作Aria2下载器,而不是敲命令行,这就必须完成三件事:装对版本的aria2c、配好RPC服务、挂上能连通的Web前端——缺一环,页面就显示“无法连接到Aria2 RPC服务器”。
安装Aria2本体
统信UOS基于Debian,官方源已内置Aria2,直接用apt安装最稳妥。【别用snap或flatpak装,它们默认不带ENABLE_RPC编译标志】
打开终端(Ctrl+Alt+T),依次执行:
sudo apt update → sudo apt install aria2 -y
运行 aria2c -v,确认输出里包含“1.36.0”或更高版本号,且有 ENABLE_RPC 字样——没有就说明装的是阉割版,得换方式。
创建并配置RPC服务
默认安装后Aria2不启用远程控制,必须手动建配置文件并开启JSON-RPC接口,否则Web界面根本连不上。
第一步:创建配置目录和空白配置文件
mkdir -p ~/.aria2 && touch ~/.aria2/aria2.conf
第二步:用nano编辑配置(也可用其他文本编辑器)
nano ~/.aria2/aria2.conf
第三步:粘贴以下5行核心配置(其余参数可后续追加)
enable-rpc=true
rpc-listen-all=true
rpc-allow-origin-all=true
rpc-listen-port=6800
rpc-secret=UOS2024
【rpc-secret必须设且记住,WebUI连接时要填这个Token,不是用户名密码】 保存退出(Ctrl+O → Enter → Ctrl+X)。
第四步:赋予下载目录写权限(假设你想存到 ~/Downloads)
mkdir -p ~/Downloads && chown -R $USER:$USER ~/Downloads
启动Aria2服务
方法一:前台测试启动(适合首次验证)
aria2c --conf-path=~/.aria2/aria2.conf
看到“07/25 10:22:12 [NOTICE] IPv4 RPC server started”即表示RPC已就绪。保持这个窗口开着,别关——关了服务就停了。
方法二:配置systemd用户服务(推荐,开机自启)
创建服务文件:nano ~/.config/systemd/user/aria2.service
填入以下内容:
[Unit]
Description=Aria2 RPC Service
[Service]
Type=simple
ExecStart=/usr/bin/aria2c --conf-path=%h/.aria2/aria2.conf
Restart=on-failure
[Install]
WantedBy=default.target
启用并启动:systemctl --user daemon-reload → systemctl --user enable aria2.service → systemctl --user start aria2.service
部署WebUI前端
WebUI本身无需安装服务端,纯静态HTML,扔进浏览器就能用。但必须确保它能访问UOS本地的6800端口。
方法一:用AriaNg(轻量、免部署)
访问 https://github.com/mayswind/AriaNg/releases → 下载最新版 AriaNg-Next.zip → 解压 → 双击打开 index.html 即可运行。
首次打开后点右上角“设置”→“AriaNg设置”→“RPC”→“主机”填 localhost,“端口”填 6800,“密钥”填 UOS2024 → 点“测试连接”,出现绿色勾即成功。
方法二:本地部署webui-aria2(更稳定)
下载地址:https://github.com/ziahamza/webui-aria2/archive/refs/heads/master.zip → 解压 → 将整个 webui-aria2-master 文件夹重命名为 webui → 移动到 ~/Documents/ 目录下。
用浏览器打开 file:///home/$USER/Documents/webui/index.html → 设置同上,主机填 localhost,密钥填 UOS2024。
【若填IP地址连不上,请检查rpc-listen-all是否为true,且防火墙没拦截6800端口】











