FunASR无网环境下部署中文实时语音听写服务的解决方案

问题背景

在FunASR项目中，用户尝试在无网络环境的Docker容器中部署中文实时语音听写服务时遇到了模型下载问题。尽管已经提前下载了所有必要的模型文件到本地，系统仍然会不断尝试连接modelscope.cn进行模型下载，导致服务启动时间过长并产生大量错误日志。

问题分析

通过分析错误日志，可以确定问题根源在于FunASR的运行时脚本对模型路径的处理逻辑存在缺陷。当使用相对路径指定模型目录时，系统无法正确识别本地模型文件，转而尝试从网络下载。这主要体现在以下几个方面：

1. 脚本会首先尝试通过modelscope下载模型，即使本地已有模型文件
2. 下载失败后才会回退到使用本地路径
3. 相对路径处理逻辑不完善，导致路径识别失败

解决方案

经过验证，使用绝对路径可以完美解决这个问题。具体操作步骤如下：

1. 确保所有模型文件已下载到本地指定目录，例如：

   /workspace/models/damo/speech_fsmn_vad_zh-cn-16k-common-onnx
   /workspace/models/damo/speech_paraformer-large_asr_nat-zh-cn-16k-common-vocab8404-onnx
   /workspace/models/damo/speech_paraformer-large_asr_nat-zh-cn-16k-common-vocab8404-online-onnx
   /workspace/models/damo/punc_ct-transformer_zh-cn-common-vad_realtime-vocab272727-onnx
   /workspace/models/damo/speech_ngram_lm_zh-cn-ai-wesp-fst
   /workspace/models/thuduj12/fst_itn_zh
   

2. 使用绝对路径启动服务：

   cd /workspace/FunASR/runtime
   nohup bash run_server_2pass.sh \
     --model-dir /workspace/models/damo/speech_paraformer-large_asr_nat-zh-cn-16k-common-vocab8404-onnx \
     --online-model-dir /workspace/models/damo/speech_paraformer-large_asr_nat-zh-cn-16k-common-vocab8404-online-onnx \
     --vad-d