刷新按钮在哪？系统信息页面功能详解

1. 系统信息页面的作用与访问方式

在使用Speech Seaco Paraformer ASR 阿里中文语音识别模型的 WebUI 界面时，你可能会注意到右下角有一个标有“”图标的按钮。这个按钮位于「系统信息」Tab 页面中，它的作用是刷新当前系统的运行状态和模型加载情况。

很多用户第一次使用时都会问：“这个刷新按钮在哪？”其实它就在你进入系统信息页面后最显眼的位置——页面底部中央的蓝色大按钮，写着「刷新信息」。点击它，就能实时获取当前服务的完整运行详情。

要进入该页面，只需打开浏览器访问：

http://<你的服务器IP>:7860

然后在顶部导航栏找到第四个 Tab：⚙ 系统信息，点击即可进入。

2. 系统信息页面的核心功能解析

2.1 为什么需要查看系统信息？

当你部署完模型并启动服务后，虽然可以正常使用语音识别功能，但你可能并不清楚：

模型是否真的成功加载？
当前是在 CPU 还是 GPU 上运行？
Python 版本对不对？
内存还剩多少？

这些信息直接影响识别速度和稳定性。而「系统信息」页面正是为你提供这些关键数据的“仪表盘”。

2.2 点击“刷新信息”后发生了什么？

当你点击「刷新信息」按钮时，前端会向后端发送一个 HTTP 请求，调用内部接口来收集以下两类信息：

模型信息

项目	说明
模型名称	显示当前加载的 ASR 模型全称，如`speech_paraformer-large-vad-punc_asr_nat-zh-cn-16k-common-vocab8404-pytorch`
模型路径	模型文件在服务器上的存储位置，例如`/root/.cache/modelscope/hub/iic/...`
设备类型	显示模型运行在`CUDA`（GPU）还是`CPU`上，直接决定处理速度

系统信息

项目	说明
操作系统	如 Linux 发行版或 Windows 版本
Python 版本	必须为 3.8+ 才能兼容 FunASR 库
CPU 核心数	影响并发处理能力，核心越多越能同时处理多个任务
内存总量 / 可用量	帮助判断是否接近资源瓶颈

提示：如果你发现设备类型显示为 CPU，那说明你的 GPU 没有被正确识别，可能导致识别速度变慢。建议检查 CUDA 驱动和 PyTorch 安装情况。

3. 实际操作演示：如何正确使用刷新功能

3.1 第一次启动后的必做动作

刚启动服务后，系统信息页面默认是空白的。这时你需要手动点击一次「刷新信息」按钮，才能看到真实的数据输出。

刷新成功后，你会看到类似这样的内容：

模型信息 - 模型名称: speech_paraformer-large-vad-punc_asr_nat-zh-cn-16k-common-vocab8404-pytorch - 模型路径: /root/.cache/modelscope/hub/iic/speech_paraformer... - 设备类型: CUDA 系统信息 - 操作系统: Ubuntu 20.04 LTS - Python 版本: 3.9.18 - CPU 核心数: 8 - 内存总量: 31.2 GB - 可用内存: 24.5 GB

这表明模型已成功加载，并正在 GPU 上运行，具备高性能识别能力。

3.2 什么时候应该再次点击刷新？

并不是一劳永逸的操作。以下几种场景建议重新点击刷新：

场景	是否需要刷新
重启服务后	必须刷新，确认模型重新加载
更换模型配置	刷新验证新模型是否生效
长时间运行后怀疑卡顿	查看内存占用是否过高
批量处理大量文件前	确保系统资源充足

特别是当你修改了run.sh脚本中的设备参数（比如从 CPU 改成 CUDA），必须刷新才能看到变化。

4. 常见问题排查：通过系统信息定位故障

4.1 问题一：刷新后设备类型显示为 CPU

现象描述：明明有 NVIDIA 显卡，但设备类型仍显示 CPU。

可能原因：

CUDA 驱动未安装或版本不匹配
PyTorch 安装的是 CPU 版本
Docker 容器未挂载 GPU 设备

解决方案：

登录服务器执行命令：
```
nvidia-smi
```
如果无输出，则说明驱动未安装。
检查 PyTorch 是否支持 CUDA：
```
import torch print(torch.cuda.is_available())
```
若返回False，需重装支持 CUDA 的 PyTorch。

4.2 问题二：刷新失败，页面无响应

现象描述：点击「刷新信息」后没有任何反应，控制台报错。

常见错误日志：

ERROR:tornado.application:Uncaught exception in write_error ConnectionRefusedError: [Errno 111] Connection refused

原因分析：

后端服务未正常启动
端口被占用或防火墙拦截
run.sh脚本执行中断

解决步骤：

重新启动服务：
```
/bin/bash /root/run.sh
```
查看日志是否有模型加载失败提示：
```
tail -f /root/logs/funasr.log
```
确保端口 7860 正常监听：
```
netstat -tuln | grep 7860
```

4.3 问题三：内存可用量极低

现象描述：刷新后发现“可用内存”只有几百 MB。

风险提示：可能导致后续识别任务崩溃或超时。

优化建议：

关闭不必要的后台进程
减少批处理大小（batch_size_s）
升级服务器内存或使用更高性能实例

5. 高级技巧：自动化监控系统状态

虽然 WebUI 提供了手动刷新功能，但在生产环境中，我们可以进一步利用其底层 API 实现自动监控。

5.1 获取系统信息的 API 接口

根据代码逻辑，系统信息功能由 Tornado 框架提供服务。你可以通过发送 POST 请求获取数据（需自行实现接口暴露）。

示例请求结构（模拟）：

curl -X POST http://localhost:7860/api/system_info \ -H "Content-Type: application/json" \ -d '{}'

返回 JSON 示例：

{ "model_name": "speech_paraformer-large...", "device_type": "CUDA", "os": "Linux", "python_version": "3.9.18", "cpu_count": 8, "memory_total_gb": 31.2, "memory_free_gb": 24.5 }

可用于搭建可视化监控面板或告警系统。

5.2 结合日志文件进行深度诊断

除了界面刷新外，还可以结合日志文件辅助判断：

日志路径	用途
`/root/logs/funasr.log`	记录模型加载、识别过程
`~/.cache/modelscope/logs/`	ModelScope 下载与缓存日志
`dmesg`或`journalctl`	系统级硬件异常记录

当刷新按钮无效时，优先查看这些日志定位根本问题。