# SenseVoice-small-onnx部署教程：Systemd服务配置+自动重启+日志轮转最佳实践 ## 1. 引言 语音识别服务在实际部署中经常会遇到这样的问题：服务运行一段时间后莫名崩溃，需要手动重启；日志文件越来越大，占用大量磁盘空间；服务器重启后服务无法自动恢复。这些问题对于生产环境来说都是不可接受的。 SenseVoice-small-onnx作为一个高效的语音识别服务，支持中文、粤语、英语、日语、韩语等多种语言，具备自动语言检测、富文本转写、情感识别等强大功能。10秒音频仅需70毫秒的推理速度，使其成为实时语音处理的理想选择。 本文将手把手教你如何通过Systemd服务配置，实现SenseVoice-small-onnx服务的自动化管理，包括自动重启、日志轮转、开机自启等生产级部署最佳实践。 ## 2. 环境准备与基础部署 ### 2.1 系统要求与依赖安装 首先确保你的系统是Ubuntu 18.04或更高版本，或者CentOS 7以上。建议使用Python 3.8+版本以获得最佳兼容性。 ```bash # 更新系统包 sudo apt update && sudo apt upgrade -y # 安装必要的系统依赖 sudo apt install -y python3-pip python3-venv ffmpeg # 创建虚拟环境（推荐） python3 -m venv sensevoice-env source sensevoice-env/bin/activate # 安装Python依赖 pip install funasr-onnx gradio fastapi uvicorn soundfile jieba ``` ### 2.2 服务目录结构规划 合理的目录结构是长期稳定运行的基础： ``` /opt/sensevoice/ ├── app.py # 主应用文件 ├── requirements.txt # 依赖列表 ├── logs/ # 日志目录 ├── models/ # 模型缓存目录 └── config/ # 配置文件目录 ``` ## 3. Systemd服务配置详解 ### 3.1 创建Systemd服务文件 创建服务配置文件是核心步骤，让我们一步步来： ```bash # 创建服务文件 sudo nano /etc/systemd/system/sensevoice.service ``` 将以下内容写入服务文件： ```ini [Unit] Description=SenseVoice Small ONNX Speech Recognition Service After=network.target Wants=network.target [Service] Type=simple User=www-data Group=www-data WorkingDirectory=/opt/sensevoice Environment=PYTHONPATH=/opt/sensevoice Environment=PYTHONUNBUFFERED=1 # 使用虚拟环境中的Python解释器 ExecStart=/opt/sensevoice/env/bin/python3 app.py --host 0.0.0.0 --port 7860 # 重要：配置自动重启策略 Restart=always RestartSec=5 StartLimitInterval=0 # 资源限制（根据服务器配置调整） MemoryMax=2G CPUQuota=200% # 安全配置 NoNewPrivileges=yes PrivateTmp=yes ProtectSystem=strict ProtectHome=yes [Install] WantedBy=multi-user.target ``` ### 3.2 关键配置参数解析 - **Restart=always**：确保服务在任何情况下退出都会自动重启 - **RestartSec=5**：重启前等待5秒，避免频繁重启循环 - **MemoryMax=2G**：限制内存使用，防止内存泄漏导致系统崩溃 - **User/Group**：使用非root用户运行，提高安全性 ### 3.3 服务管理命令 配置完成后，使用以下命令管理服务： ```bash # 重新加载systemd配置 sudo systemctl daemon-reload # 启动服务 sudo systemctl start sensevoice # 设置开机自启 sudo systemctl enable sensevoice # 查看服务状态 sudo systemctl status sensevoice # 查看实时日志 sudo journalctl -u sensevoice -f ``` ## 4. 日志管理最佳实践 ### 4.1 配置日志轮转 为了避免日志文件无限增长，我们需要配置logrotate： ```bash # 创建logrotate配置文件 sudo nano /etc/logrotate.d/sensevoice ``` 添加以下内容： ```conf /opt/sensevoice/logs/*.log { daily missingok rotate 30 compress delaycompress notifempty create 644 www-data www-data sharedscripts postrotate systemctl kill -s USR1 sensevoice.service endscript } ``` ### 4.2 在应用中实现日志分割 在app.py中添加日志配置： ```python import logging from logging.handlers import RotatingFileHandler import os def setup_logging(): # 创建日志目录 log_dir = "/opt/sensevoice/logs" os.makedirs(log_dir, exist_ok=True) # 配置根日志 logger = logging.getLogger() logger.setLevel(logging.INFO) # 文件处理器（自动轮转） file_handler = RotatingFileHandler( f"{log_dir}/sensevoice.log", maxBytes=10*1024*1024, # 10MB backupCount=10 ) file_handler.setFormatter(logging.Formatter( '%(asctime)s - %(name)s - %(levelname)s - %(message)s' )) # 控制台处理器 console_handler = logging.StreamHandler() console_handler.setFormatter(logging.Formatter( '%(levelname)s: %(message)s' )) logger.addHandler(file_handler) logger.addHandler(console_handler) # 在应用启动时调用 setup_logging() ``` ## 5. 健康检查与监控 ### 5.1 实现健康检查接口 在FastAPI应用中添加健康检查端点： ```python from fastapi import FastAPI from fastapi.responses import JSONResponse app = FastAPI() @app.get("/health") async def health_check(): """健康检查接口""" return JSONResponse({ "status": "healthy", "service": "sensevoice-small-onnx", "timestamp": datetime.now().isoformat() }) @app.get("/metrics") async def metrics(): """监控指标接口""" # 这里可以添加各种性能指标 return JSONResponse({ "active_connections": 0, "processed_requests": 0, "memory_usage": "0MB" }) ``` ### 5.2 使用系统监控工具 配置基础监控： ```bash # 安装监控工具 sudo apt install -y htop iotop nmon # 创建监控脚本 sudo nano /opt/sensevoice/scripts/monitor.sh ``` 监控脚本内容： ```bash #!/bin/bash SERVICE="sensevoice" # 检查服务状态 if ! systemctl is-active --quiet $SERVICE; then echo "$(date): Service $SERVICE is down, attempting restart" systemctl restart $SERVICE # 可以在这里添加邮件或短信通知 fi # 检查磁盘空间 DISK_USAGE=$(df / | awk 'NR==2 {print $5}' | sed 's/%//') if [ $DISK_USAGE -gt 90 ]; then echo "$(date): Disk usage is over 90%" fi ``` ## 6. 高级配置与优化 ### 6.1 环境变量配置 创建配置文件管理环境变量： ```bash # 创建环境配置文件 sudo nano /etc/default/sensevoice ``` 添加配置内容： ```ini # SenseVoice 服务配置 MODEL_PATH=/root/ai-models/danieldong/sensevoice-small-onnx-quant BATCH_SIZE=10 LANGUAGE=auto USE_ITN=true LOG_LEVEL=INFO ``` 在服务文件中引用配置： ```ini [Service] EnvironmentFile=/etc/default/sensevoice ExecStart=/opt/sensevoice/env/bin/python3 app.py --host 0.0.0.0 --port 7860 --batch-size ${BATCH_SIZE} ``` ### 6.2 性能优化建议 根据服务器配置调整参数： ```python # 在app.py中根据CPU核心数自动调整工作进程数 import multiprocessing workers = min(multiprocessing.cpu_count() * 2 + 1, 8) # 启动命令调整为使用多个工作进程 # uvicorn app:app --host 0.0.0.0 --port 7860 --workers ${workers} ``` ## 7. 故障排除与维护 ### 7.1 常见问题解决 **服务启动失败排查：** ```bash # 查看详细错误信息 sudo journalctl -u sensevoice -n 50 --no-pager # 检查端口占用 sudo lsof -i :7860 # 检查依赖是否完整 pip check ``` **模型加载问题：** ```bash # 检查模型文件权限 ls -la /root/ai-models/danieldong/sensevoice-small-onnx-quant/ # 确保模型文件可读 sudo chmod -R 755 /root/ai-models/ ``` ### 7.2 定期维护任务 创建维护脚本： ```bash #!/bin/bash # /opt/sensevoice/scripts/maintenance.sh # 清理旧日志 find /opt/sensevoice/logs -name "*.log.*" -mtime +30 -delete # 更新依赖 pip install -U pip pip install -U -r /opt/sensevoice/requirements.txt # 重启服务以应用更新 systemctl restart sensevoice ``` ## 8. 总结 通过本文的Systemd服务配置，你的SenseVoice-small-onnx语音识别服务现在具备了生产级部署所需的所有特性： - **自动重启**：服务异常退出时自动恢复 - **日志管理**：自动轮转，避免磁盘空间耗尽 - **开机自启**：系统重启后服务自动运行 - **资源限制**：防止单一服务耗尽系统资源 - **监控告警**：实时监控服务状态 这些配置不仅适用于SenseVoice-small-onnx，也可以作为其他Python Web服务的部署模板。在实际使用中，记得根据你的具体需求调整内存限制、日志保留策略等参数。 现在你的语音识别服务已经具备了企业级的稳定性和可靠性，可以放心地投入生产环境使用了。 --- > **获取更多AI镜像** > > 想探索更多AI镜像和应用场景？访问 [CSDN星图镜像广场](https://ai.csdn.net/?utm_source=mirror_blog_end)，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。