当前位置：首页 > news >正文

Speech Seaco Paraformer自动重启脚本：/root/run.sh使用注意事项

news 2026/7/13 5:23:46

Speech Seaco Paraformer自动重启脚本：/root/run.sh使用注意事项

1. 脚本作用与适用场景

1.1 为什么需要这个脚本？

Speech Seaco Paraformer 是一个基于阿里 FunASR 的高性能中文语音识别模型，运行时依赖 WebUI 服务和后端 ASR 引擎。在实际部署中，你可能会遇到以下情况：

服务意外崩溃（如显存溢出、Python 进程被 OOM killer 终止）
系统重启后服务未自动拉起
批量处理大文件后模型状态异常，需软重启恢复稳定性
需要定时维护或无人值守环境下的自愈能力

/root/run.sh就是为解决这些问题而设计的轻量级自动重启脚本——它不依赖 systemd 或 supervisor 等复杂进程管理工具，仅用 Shell 实现“检测→终止→清理→启动→验证”闭环，适合边缘设备、开发测试机或轻量生产环境。

一句话总结：这不是一个“高级部署方案”，而是一个“能跑起来、不掉链子”的务实选择。

1.2 它不是什么？

请明确以下边界，避免误用：

❌ 不是替代systemd的专业服务管理器（无日志轮转、无依赖管理、无资源限制）
❌ 不提供热更新能力（修改代码后仍需手动重启）
❌ 不自动修复模型文件损坏、CUDA 驱动异常等底层问题
❌ 不兼容 Windows 或 macOS（仅适用于 Linux x86_64 环境）

如果你的服务器已配置systemd且稳定运行，建议优先使用标准服务方式；而/root/run.sh更适合：
临时调试环境
Docker 容器内单进程托管
树莓派/NUC 等资源受限设备
快速验证模型可用性的 CI/CD 流程

2. 脚本结构与核心逻辑

2.1 文件位置与权限要求

脚本默认路径为/root/run.sh，必须满足以下条件才能正常工作：

所有者为root（因涉及端口绑定、GPU 设备访问等特权操作）
权限为755（可执行）：
```
chmod 755 /root/run.sh
```
同目录下存在webui.py（主程序入口）和.env（环境变量配置，如有）

注意：若你将项目部署在非/root目录（如/opt/paraformer），请先修改脚本内所有路径引用，或使用符号链接保持一致性。

2.2 脚本执行流程图解

[开始] ↓ 检查端口 7860 是否被占用 → 是 → 杀死占用进程（lsof + kill） ↓ 否 检查 webui.py 进程是否存在 → 是 → 检查是否响应 HTTP GET / → 响应正常？→ 是 → 退出（无需重启） ↓ 否 ↓ 否 终止旧进程（pkill -f "python.*webui.py"） → 清理临时文件（/tmp/gradio_*） → 启动新进程（nohup python webui.py &） ↓ 等待 10 秒 → 发起健康检查（curl -s http://localhost:7860 | grep -q "Gradio"）→ 成功？→ 记录日志并退出 ↓ 否 重试最多 3 次 → 全部失败 → 写入错误日志并退出（返回码 1）

整个过程控制在 30 秒内完成，失败时会生成/root/run.log记录关键步骤时间戳和错误信息。

2.3 关键代码片段说明（精简版）

以下是脚本中最具实操价值的三段逻辑，已去除冗余注释，保留核心判断：

#!/bin/bash PORT=7860 APP_CMD="python webui.py" LOG_FILE="/root/run.log" MAX_RETRY=3 # 检查端口占用并释放 if lsof -i :$PORT > /dev/null; then echo "$(date): Port $PORT occupied, killing..." >> $LOG_FILE lsof -t -i :$PORT | xargs kill -9 2>/dev/null fi # 终止残留进程 pkill -f "$APP_CMD" 2>/dev/null rm -rf /tmp/gradio_* # 启动并验证 for i in $(seq 1 $MAX_RETRY); do nohup $APP_CMD > /dev/null 2>&1 & sleep 10 if curl -s http://localhost:$PORT | grep -q "Gradio"; then echo "$(date): Service UP on port $PORT" >> $LOG_FILE exit 0 fi echo "$(date): Try $i failed, retrying..." >> $LOG_FILE done echo "$(date): Failed to start after $MAX_RETRY attempts" >> $LOG_FILE exit 1

提示：该脚本默认使用nohup启动，进程脱离终端运行；如需查看实时输出，请改用tail -f nohup.out（需确保nohup.out可写）。

3. 日常使用规范与避坑指南

3.1 推荐调用方式

场景	推荐命令	说明
手动触发重启	`/bin/bash /root/run.sh`	最常用，立即生效
开机自启	加入`/etc/rc.local`（末尾添加）	确保`exit 0`前插入该行
定时健康检查	`crontab -e`添加`/10 * * * /root/run.sh >> /dev/null 2>&1`	每10分钟检查一次服务状态
调试模式运行	`bash -x /root/run.sh`	显示每条命令执行过程，便于排查卡点

小技巧：在 crontab 中使用绝对路径调用，避免因$PATH差异导致lsof或curl找不到命令。

3.2 常见报错与解决方案

错误现象：`lsof: command not found`

原因：系统未安装lsof工具（常见于最小化 CentOS/Alpine 镜像）

解决：

# Ubuntu/Debian apt update && apt install -y lsof # CentOS/RHEL yum install -y lsof # Alpine（Docker 环境） apk add lsof

错误现象：`curl: (7) Failed to connect to localhost port 7860`

原因：WebUI 启动失败，可能因：
- GPU 显存不足（CUDA out of memory）
- 模型路径错误（.model_path配置指向不存在目录）
- Python 包缺失（如gradio,funasr未正确安装）
排查步骤：
1. 手动运行python webui.py，观察终端报错
2. 检查/root/.cache/modelscope/hub/下模型是否完整（约 1.2GB）
3. 运行nvidia-smi确认 GPU 可见且驱动正常

错误现象：`Permission denied: '/root/run.log'`

原因：日志文件被其他用户创建，或/root目录权限被修改

解决：

chown root:root /root/run.sh /root/run.log chmod 644 /root/run.log

3.3 安全与权限最佳实践

❌ 禁止将/root/run.sh设置为777（存在提权风险）
建议配合sudoers实现非 root 用户有限调用：
在/etc/sudoers中添加：

www-data ALL=(root) NOPASSWD: /root/run.sh

然后普通用户可通过sudo /root/run.sh安全触发重启。

若用于 Web 前端按钮调用（如通过 Flask API 触发），务必校验请求来源 IP 和 Token，禁止暴露在公网。

4. 进阶定制建议（按需启用）

4.1 添加邮件告警（当重启失败时）

修改脚本末尾，在exit 1前插入：

echo "Speech Seaco Paraformer service failed to restart at $(date)" | \ mail -s "[ALERT] Paraformer Down" admin@example.com

需提前配置好mailutils或ssmtp。

4.2 支持多端口切换（适配不同部署）

在脚本开头增加参数解析：

PORT=${1:-7860} echo "$(date): Starting with PORT=$PORT" >> $LOG_FILE

调用时即可指定：/root/run.sh 8080

4.3 集成 GPU 显存预检（防 OOM 崩溃）

在启动前加入显存检查（需nvidia-smi）：

GPU_MEM=$(nvidia-smi --query-gpu=memory.free --format=csv,noheader,nounits | head -1) if [ "$GPU_MEM" -lt 6000 ]; then echo "$(date): GPU memory < 6GB, aborting start" >> $LOG_FILE exit 2 fi