在 Windows 上配置和运行 FunASR最省事的路子是走 Docker 一键部署或者用现成的整合包‌。下面按不同需求给出对应方案。 方案一Docker 一键部署推荐适合离线转写服务这是目前最省心的方式不用手动配 Python 环境适合把语音转写做成服务来用。‌‌‌前置条件‌Windows 10/11 64 位专业版安装 Docker Desktop 并启用 WSL2 后端同时装好 Git。家庭版需先开启 WSL2 功能。‌克隆仓库‌打开终端执行 git clone https://gitcode.com/GitHub_Trending/fun/FunASR.git然后进入 FunASR/runtime/deploy_tools 目录。‌运行部署脚本‌双击 funasr-runtime-deploy-offline-cpu-zh.bat按提示选择模型类型1 基础转写、2 带时间戳、3 热词增强、服务端口默认 10095和工作目录建议放非系统盘。‌验证服务‌部署完成后浏览器打开 http://localhost:10095 能看到状态页或者命令行执行 curl http://localhost:10095/health 返回 {status:healthy,version:2.0} 即成功。‌转写音频‌进入 runtime/python/websocket 目录用客户端脚本送音频‌‌bashpython funasr_wss_client.py --host 127.0.0.1 --port 10095 --mode offline --audio_in C:/test.wav --use_itn 1--audio_in 支持 wav/mp3/mp4 等格式--use_itn 1 开启数字规范化比如把一百二十三转成123。‌‌不想用命令行的话浏览器打开 runtime/html5/static/index.html可以直接上传文件或对着麦克风录音转写。‌‌ 方案二pip 安装适合开发集成想在自己的 Python 项目里调用 FunASR就用这种方式。‌‌‌环境要求‌64 位 Windows 10/11Python 3.8~3.13建议用 conda 建独立环境避免依赖冲突。‌安装依赖‌‌‌bashpip install -U funasr modelscope torch torchaudio国内网络慢的话加 -i https://mirror.sjtu.edu.cn/pypi/web/simple 换源。‌‌‌跑通识别‌用官方示例脚本进入 runtime/python/websocket 目录先装服务端依赖再启动bashpip install -r requirements_server.txtpython funasr_wss_server.py --port 10095 --certfile 0--certfile 0 关闭 SSL本地测试更省事。首次启动会自动下载模型看到终端提示服务就绪即可。‌‌‌测试识别‌另开终端执行bashpython funasr_wss_client.py --host 127.0.0.1 --port 10095 --mode offline --audio_in../../funasr_api/asr_example.wav看到带标点的文字输出就说明部署成功。‌‌⚡ 方案三免安装整合包最快体验只想赶紧用上、不想折腾环境直接下载整合包双击运行即可。‌‌‌实时语音识别版‌识别麦克风或电脑内播放的声音支持实时翻译解压后双击 启动软件.exe 就行。‌注意事项‌软件路径不能有中文和空格只支持 Win10/Win11识别电脑内声音需在系统声音设置里启用立体声混音。‌‌️ 常见问题排查‌端口被占用‌报错 address already in use 时执行 netstat -ano | findstr :10095 找到占用进程再 taskkill /PID 进程ID /F 结束它或者换个端口启动。‌模型下载卡住‌网络原因导致重跑命令会续传也可以把 FunASR 目录加入杀软信任区。‌识别准确率不高‌在模型目录放 hotwords.txt每行写词语 权重如 达摩院 20启动服务端时加 --hotword 指向它专有名词识别率会明显提升。‌转写视频报错‌需要安装 ffmpeg执行 winget install ffmpeg 即可。‌‌首次启动会自动下载模型权重耗时视网速而定期间别关终端。纯 CPU 也能跑有 NVIDIA 显卡可装 CUDA 环境加速实测 GPU 大约快 3 倍左右。‌‌https://hf-mirror.com/FunAudioLLM/SenseVoiceSmall/resolve/main/model.pt https://hf-mirror.com/FunAudioLLM/SenseVoiceSmall/resolve/main/config.yaml https://hf-mirror.com/FunAudioLLM/SenseVoiceSmall/resolve/main/configuration.json1. centosliunx中执行如下所示命令# 完整安装含vLLM加速GPU推荐 pip install funasr vllm fastapi uvicorn python-multipart # CPU启动 funasr-server --device cpu --model SenseVoiceSmall --port 8002 --host 0.0.0.0 # GPU启动 funasr-server --device cuda --model SenseVoiceSmall --port 8002 --host 0.0.0.0