FunASR Docker部署及WebSocket连接问题解决方案

问题背景

在使用FunASR进行语音识别服务部署时，用户通过Docker容器成功启动了ASR服务，但在尝试通过Web客户端连接时遇到了连接失败的问题。虽然telnet测试端口可达，但WebSocket连接始终无法建立。

环境配置

用户按照官方文档使用以下命令启动了Docker容器：

bash run_server.sh \
  --download-model-dir /workspace/models \
  --vad-dir damo/speech_fsmn_vad_zh-cn-16k-common-onnx \
  --model-dir damo/speech_paraformer-large-vad-punc_asr_nat-zh-cn-16k-common-vocab8404-pytorch \
  --punc-dir damo/punc_ct-transformer_cn-en-common-vocab471067-large-onnx \
  --lm-dir damo/speech_ngram_lm_zh-cn-ai-wesp-fst \
  --itn-dir thuduj12/fst_itn_zh \
  --hotword /workspace/models/hotwords.txt \
  --certfile 0

问题现象

1. Docker容器正常启动，端口映射正确（10098->10095）
2. telnet测试端口10098可达
3. Web客户端尝试连接时失败，无论使用wss、ws还是http协议

根本原因分析

经过技术分析，该问题主要由以下两个因素导致：

1. SSL/TLS配置问题：服务端和客户端的SSL配置不一致，导致安全连接无法建立
2. 模型下载失败：部分模型文件未能成功下载，影响了服务的完整启动

解决方案

方案一：统一SSL配置

1. 服务端配置：确保启动脚本中的--certfile参数正确配置

   • 使用有效证书文件路径（非0值）
   • 或者明确禁用SSL（如果环境允许）

2. 客户端配置：

   • 与服务端SSL配置保持一致
   • 如果是自签名证书，需要在客户端进行手工授权

方案二：检查模型下载

1. 查看Docker容器日志，确认所有模型文件是否下载成功
2. 对于下载失败的模型：
   • 检查网络连接
   • 确保有足够的存储空间
   • 考虑手动下载模型文件到指定目录

最佳实践建议

1. 部署前检查：

   • 验证Docker容器内网络连通性
   • 确保主机和容器间端口映射正确
   • 检查模型文件完整性

2. 连接测试：

   • 先使用简单的WebSocket测试工具验证服务可用性
   • 再集成到正式客户端中

3. 日志监控：

   • 实时监控服务端日志，及时发现连接问题
   • 对常见错误建立处理预案

总结

FunASR作为先进的语音识别系统，其Docker部署方案虽然便捷，但在实际应用中仍需注意网络配置、安全设置和模型完整性等关键因素。通过本文提供的解决方案，用户可以快速定位和解决WebSocket连接问题，确保语音识别服务的稳定运行。