# SenseVoice-small-onnx语音识别部署教程：SSL证书配置与API安全加固 ## 1. 项目概述与环境准备 SenseVoice-small-onnx是一个基于ONNX量化的多语言语音识别模型，支持中文、粤语、英语、日语、韩语等50多种语言的自动检测和转写。本教程将指导您完成从基础部署到SSL证书配置和API安全加固的完整流程。 **前置要求**： - Linux服务器（Ubuntu 20.04+推荐） - Python 3.8+ - 基本命令行操作经验 - 域名（用于SSL证书申请） **环境准备步骤**： 首先更新系统并安装基础依赖： ```bash # 更新系统包 sudo apt update && sudo apt upgrade -y # 安装Python和基础工具 sudo apt install python3-pip python3-venv nginx certbot -y # 创建项目目录 mkdir sensevoice-deployment cd sensevoice-deployment ``` ## 2. 基础服务部署 ### 2.1 安装Python依赖 创建虚拟环境并安装所需包： ```bash # 创建虚拟环境 python3 -m venv venv source venv/bin/activate # 安装核心依赖 pip install funasr-onnx gradio fastapi uvicorn soundfile jieba cryptography ``` ### 2.2 创建应用文件 创建`app.py`作为主应用文件： ```python from fastapi import FastAPI, File, UploadFile, HTTPException from fastapi.middleware.httpsredirect import HTTPSRedirectMiddleware from funasr_onnx import SenseVoiceSmall import os import logging # 配置日志 logging.basicConfig(level=logging.INFO) logger = logging.getLogger(__name__) app = FastAPI(title="SenseVoice语音识别API", version="1.0.0") # 添加HTTPS重定向中间件 app.add_middleware(HTTPSRedirectMiddleware) # 初始化模型 model_path = "/root/ai-models/danieldong/sensevoice-small-onnx-quant" try: model = SenseVoiceSmall( model_path, batch_size=10, quantize=True ) logger.info("模型加载成功") except Exception as e: logger.error(f"模型加载失败: {e}") model = None @app.get("/health") async def health_check(): return {"status": "healthy", "model_loaded": model is not None} @app.post("/api/transcribe") async def transcribe_audio( file: UploadFile = File(...), language: str = "auto", use_itn: bool = True ): if model is None: raise HTTPException(status_code=503, detail="模型未加载") # 保存上传文件 file_path = f"/tmp/{file.filename}" with open(file_path, "wb") as f: f.write(await file.read()) try: result = model([file_path], language=language, use_itn=use_itn) os.remove(file_path) # 清理临时文件 return {"text": result[0], "language": language} except Exception as e: os.remove(file_path) raise HTTPException(status_code=500, detail=f"处理失败: {str(e)}") if __name__ == "__main__": import uvicorn uvicorn.run(app, host="0.0.0.0", port=7860) ``` ## 3. SSL证书配置 ### 3.1 安装和配置Nginx 首先安装Nginx并配置反向代理： ```bash # 安装Nginx sudo apt install nginx -y # 创建Nginx配置文件 sudo nano /etc/nginx/sites-available/sensevoice ``` 添加以下配置内容： ```nginx server { listen 80; server_name your-domain.com; # 替换为您的域名 location / { proxy_pass http://127.0.0.1:7860; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } # 安全头设置 add_header X-Frame-Options DENY; add_header X-Content-Type-Options nosniff; add_header X-XSS-Protection "1; mode=block"; } ``` 启用配置并重启Nginx： ```bash sudo ln -s /etc/nginx/sites-available/sensevoice /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl restart nginx ``` ### 3.2 申请SSL证书 使用Certbot申请免费的Let's Encrypt SSL证书： ```bash # 安装Certbot sudo apt install certbot python3-certbot-nginx -y # 申请证书 sudo certbot --nginx -d your-domain.com # 替换为您的域名 # 设置自动续期 echo "0 12 * * * /usr/bin/certbot renew --quiet" | sudo tee -a /etc/crontab > /dev/null ``` 证书申请完成后，Nginx配置会自动更新为HTTPS版本。 ## 4. API安全加固 ### 4.1 配置防火墙 设置UFW防火墙规则： ```bash # 启用防火墙 sudo ufw enable # 允许必要端口 sudo ufw allow 22/tcp # SSH sudo ufw allow 80/tcp # HTTP sudo ufw allow 443/tcp # HTTPS sudo ufw deny 7860/tcp # 禁止直接访问7860端口 # 查看规则 sudo ufw status ``` ### 4.2 添加API密钥认证 修改`app.py`添加API密钥验证： ```python from fastapi import Security, Depends from fastapi.security import APIKeyHeader from starlette.status import HTTP_401_UNAUTHORIZED API_KEY_NAME = "X-API-Key" api_key_header = APIKeyHeader(name=API_KEY_NAME, auto_error=False) # 在实际应用中，应该使用环境变量存储密钥 VALID_API_KEYS = {"your-secret-api-key-here"} # 替换为实际密钥 async def validate_api_key(api_key: str = Security(api_key_header)): if api_key not in VALID_API_KEYS: raise HTTPException( status_code=HTTP_401_UNAUTHORIZED, detail="无效的API密钥" ) return api_key @app.post("/api/transcribe") async def transcribe_audio( file: UploadFile = File(...), language: str = "auto", use_itn: bool = True, api_key: str = Depends(validate_api_key) ): # 原有的处理逻辑 ``` ### 4.3 速率限制配置 添加请求速率限制： ```python from slowapi import Limiter, _rate_limit_exceeded_handler from slowapi.util import get_remote_address from slowapi.errors import RateLimitExceeded limiter = Limiter(key_func=get_remote_address) app.state.limiter = limiter app.add_exception_handler(RateLimitExceeded, _rate_limit_exceeded_handler) @app.post("/api/transcribe") @limiter.limit("10/minute") # 每分钟10次请求 async def transcribe_audio( # 参数保持不变 ): # 处理逻辑 ``` ## 5. 完整部署脚本 创建一键部署脚本`deploy.sh`： ```bash #!/bin/bash # SenseVoice语音识别服务自动化部署脚本 set -e echo "开始部署SenseVoice语音识别服务..." # 安装系统依赖 echo "安装系统依赖..." sudo apt update sudo apt install -y python3-pip python3-venv nginx certbot python3-certbot-nginx # 创建项目目录 mkdir -p sensevoice-deployment cd sensevoice-deployment # 设置虚拟环境 echo "设置Python虚拟环境..." python3 -m venv venv source venv/bin/activate # 安装Python依赖 echo "安装Python依赖..." pip install funasr-onnx gradio fastapi uvicorn soundfile jieba cryptography slowapi # 创建应用文件 echo "创建应用配置文件..." cat > app.py << 'EOF' # 这里插入上面完整的app.py内容 EOF # 配置Nginx echo "配置Nginx..." sudo bash -c 'cat > /etc/nginx/sites-available/sensevoice << "EOL" # 这里插入上面完整的Nginx配置内容 EOL' # 启用配置 sudo ln -sf /etc/nginx/sites-available/sensevoice /etc/nginx/sites-enabled/ sudo nginx -t sudo systemctl restart nginx echo "部署完成！" echo "请运行: source venv/bin/activate && python app.py" echo "然后访问: https://your-domain.com" ``` ## 6. 测试与验证 ### 6.1 服务健康检查 测试API端点是否正常工作： ```bash # 健康检查 curl -X GET https://your-domain.com/health # 带API密钥的转录请求 curl -X POST "https://your-domain.com/api/transcribe" \ -H "X-API-Key: your-secret-api-key-here" \ -F "file=@audio.wav" \ -F "language=auto" \ -F "use_itn=true" ``` ### 6.2 SSL证书验证 检查SSL证书配置： ```bash # 检查证书状态 sudo certbot certificates # 测试SSL配置 openssl s_client -connect your-domain.com:443 -servername your-domain.com ``` ## 7. 运维与监控 ### 7.1 创建系统服务 创建systemd服务文件确保应用自动启动： ```bash sudo nano /etc/systemd/system/sensevoice.service ``` 添加以下内容： ```ini [Unit] Description=SenseVoice语音识别服务 After=network.target [Service] User=ubuntu Group=ubuntu WorkingDirectory=/path/to/sensevoice-deployment Environment="PATH=/path/to/sensevoice-deployment/venv/bin" ExecStart=/path/to/sensevoice-deployment/venv/bin/python app.py Restart=always RestartSec=5 [Install] WantedBy=multi-user.target ``` 启用并启动服务： ```bash sudo systemctl daemon-reload sudo systemctl enable sensevoice sudo systemctl start sensevoice sudo systemctl status sensevoice ``` ### 7.2 日志监控 配置日志轮转： ```bash sudo nano /etc/logrotate.d/sensevoice ``` 添加日志管理配置： ``` /path/to/sensevoice-deployment/*.log { daily missingok rotate 7 compress delaycompress notifempty copytruncate } ``` ## 8. 总结与最佳实践 通过本教程，您已经完成了SenseVoice-small-onnx语音识别服务的完整部署，包括SSL证书配置和API安全加固。以下是关键要点的总结： **安全最佳实践**： 1. 始终使用HTTPS加密通信 2. 实施API密钥认证和速率限制 3. 定期更新SSL证书（Certbot会自动处理） 4. 使用防火墙限制不必要的端口访问 5. 定期检查和服务日志监控 **性能优化建议**： 1. 根据实际负载调整Nginx worker进程数 2. 考虑使用CDN加速静态资源 3. 配置适当的缓存策略 4. 监控服务器资源使用情况 **故障排除提示**： - 使用`journalctl -u sensevoice`查看服务日志 - 检查Nginx错误日志：`/var/log/nginx/error.log` - 验证证书状态：`sudo certbot certificates` 现在您的语音识别服务已经具备了生产环境所需的安全性和可靠性，可以处理多语言语音转写任务并为应用程序提供稳定的API服务。 --- > **获取更多AI镜像** > > 想探索更多AI镜像和应用场景？访问 [CSDN星图镜像广场](https://ai.csdn.net/?utm_source=mirror_blog_end)，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。