基于FunASR语音识别WebUI快速部署｜科哥二次开发镜像实战

优质文章学习记录

10 Apr 2026 — 10 min read

基于FunASR语音识别WebUI快速部署｜科哥二次开发镜像实战

1. 背景与技术选型

1.1 语音识别技术发展现状

近年来，随着深度学习在语音信号处理领域的深入应用，自动语音识别（ASR）技术取得了显著突破。特别是在中文场景下，基于端到端模型的语音识别系统已广泛应用于智能客服、会议转录、字幕生成等实际业务中。

FunASR 是由阿里云推出的一个开源语音识别工具包，支持多种主流模型架构，如 Paraformer、SenseVoice 等，具备高精度、低延迟和良好的可扩展性。其模块化设计使得开发者可以灵活集成 VAD（语音活动检测）、PUNC（标点恢复）、LM（语言模型）等功能组件。

1.2 科哥二次开发镜像的价值

本文所使用的镜像 “FunASR 语音识别基于speech_ngram_lm_zh-cn 二次开发构建by科哥” 是在官方 FunASR 基础上进行功能增强和界面优化的定制版本。该镜像主要特点包括：

集成 speech_ngram_lm_zh-cn 中文N-gram语言模型，提升中文识别准确率
提供图形化 WebUI 界面，降低使用门槛
支持实时录音、文件上传、多格式导出等完整工作流
内置 CUDA 加速支持，兼顾性能与效率

相比原始命令行操作方式，此镜像极大简化了部署流程，适合非专业开发者或企业快速落地语音识别能力。

2. 镜像部署与环境准备

2.1 系统要求与依赖

为确保镜像正常运行，请确认以下硬件和软件条件：

项目	推荐配置
操作系统	Ubuntu 20.04 / 22.04 LTS
CPU	Intel i5 及以上
GPU	NVIDIA 显卡（支持 CUDA 11.8+），显存 ≥ 6GB（可选）
内存	≥ 16GB
存储空间	≥ 20GB（含模型缓存）
Docker	已安装并配置好权限

注意：若无 GPU，系统将自动降级至 CPU 模式运行，但识别速度会明显下降。

2.2 Docker 环境安装

# 更新系统包索引 sudo apt update && sudo apt upgrade -y # 安装必要依赖 sudo apt install -y apt-transport-https ca-certificates curl software-properties-common gnupg lsb-release # 添加 Docker GPG 密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg # 添加 Docker 官方仓库 echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null # 更新包列表并安装 Docker sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin # 启动并启用开机自启 sudo systemctl start docker sudo systemctl enable docker

2.3 拉取并运行科哥定制镜像

# 创建本地模型存储目录 mkdir -p ./funasr-runtime-resources/models # 拉取镜像（假设镜像已发布至公共仓库） docker pull registry.cn-hangzhou.aliyuncs.com/funasr_repo/funasr:funasr-runtime-sdk-online-cpu-0.1.12 # 启动容器并映射端口与卷 sudo docker run -p 7860:7860 -it --privileged=true \ -v $PWD/funasr-runtime-resources/models:/workspace/models \ registry.cn-hangzhou.aliyuncs.com/funasr_repo/funasr:funasr-runtime-sdk-online-cpu-0.1.12

说明：-p 7860:7860 将容器内 WebUI 服务端口暴露给主机-v 参数实现模型持久化存储，避免重复下载--privileged=true 赋予容器更高权限以访问音频设备

3. WebUI 功能详解与使用实践

3.1 访问 WebUI 界面

启动成功后，在浏览器中访问：

http://localhost:7860

若从远程访问，请替换 localhost 为服务器 IP 地址：

http://<服务器IP>:7860

页面加载完成后将显示主界面，标题为 “FunASR 语音识别 WebUI”，底部标注开发者信息：“webUI二次开发 by 科哥”。

3.2 控制面板功能解析

3.2.1 模型选择

左侧控制面板提供两种预置模型：

Paraformer-Large：大参数量模型，识别精度高，适用于对准确性要求高的场景（如会议记录）
SenseVoice-Small：轻量级模型，响应速度快，适合实时交互场景（如语音助手）

默认选中 SenseVoice-Small，用户可根据需求切换。

3.2.2 设备模式选择

CUDA：启用 GPU 加速，需确保宿主机安装 NVIDIA 驱动及 CUDA 环境
CPU：纯 CPU 推理，兼容性更好，但处理长音频时延迟较高

系统启动时会自动检测 GPU 状态并推荐最优选项。

3.2.3 功能开关配置

三个核心功能可通过复选框开启：

✅ 启用标点恢复 (PUNC)：自动为识别结果添加句号、逗号等标点符号
✅ 启用语音活动检测 (VAD)：跳过静音段落，提升识别效率
✅ 输出时间戳：返回每个词/句的时间区间，便于后期编辑

建议保持三项全开以获得最佳体验。

3.2.4 模型状态与操作按钮

模型状态指示灯：绿色 ✓ 表示模型已加载；红色 ✗ 表示未加载
加载模型：手动触发模型初始化（首次启动后需点击一次）
刷新：更新当前状态信息

4. 语音识别使用流程

4.1 方式一：上传音频文件识别

步骤 1：准备音频文件

支持格式包括：

WAV (.wav)
MP3 (.mp3)
M4A (.m4a)
FLAC (.flac)
OGG (.ogg)
PCM (.pcm)

推荐采样率为 16kHz，单声道，比特率不低于 64kbps。

步骤 2：上传文件

在 “ASR 语音识别” 区域点击 “上传音频” 按钮，选择本地文件上传。系统支持拖拽上传。

步骤 3：设置识别参数

批量大小（秒）：默认 300 秒（5 分钟），最大支持 600 秒
识别语言：
- auto：自动检测（推荐）
- zh：强制中文识别
- en：英文
- yue：粤语
- ja：日语
- ko：韩语

混合语种内容建议选择 auto。

步骤 4：开始识别

点击 “开始识别” 按钮，系统将调用后台模型进行推理。进度条显示处理状态。

步骤 5：查看识别结果

结果展示区包含三个标签页：

文本结果：纯文本输出，支持一键复制
详细信息：JSON 格式，包含置信度、时间戳等元数据
时间戳：按 [序号] 开始时间 - 结束时间 (时长) 格式列出

示例输出：

[001] 0.000s - 0.500s (时长: 0.500s) [002] 0.500s - 2.500s (时长: 2.000s)

4.2 方式二：浏览器实时录音识别

步骤 1：授权麦克风权限

点击 “麦克风录音” 按钮，浏览器弹出权限请求，点击 “允许”。

若未出现提示，请检查浏览器设置是否阻止了麦克风访问。

步骤 2：录制语音

持续按住录音按钮说话，松开即停止录制。录音数据临时保存在内存中。

步骤 3：启动识别

点击 “开始识别”，系统将上传录音片段并返回识别结果。

该模式适用于短语音输入，如指令识别、关键词提取等场景。

5. 结果导出与高级功能

5.1 多格式结果下载

识别完成后，可通过三个按钮下载不同格式的结果：

按钮	输出格式	应用场景
下载文本	.txt	文档整理、内容提取
下载 JSON	.json	程序解析、API 对接
下载 SRT	.srt	视频字幕制作

所有文件统一保存在容器内的 outputs/ 目录下，命名规则为：

outputs/outputs_YYYYMMDDHHMMSS/ ├── audio_001.wav ├── result_001.json ├── text_001.txt └── subtitle_001.srt

通过 -v 卷映射，宿主机也可直接访问这些输出文件。

5.2 高级参数调优建议

批量大小调整

小批量（60~180s）：适合内存有限或希望快速获取部分结果的场景
大批量（300~600s）：适合处理整段讲座、访谈等长音频

注意：过大的批次可能导致 OOM 错误，尤其在 CPU 模式下。

语言设置策略

内容类型	推荐语言设置
普通话演讲	`zh`
英文播客	`en`
中英混杂对话	`auto`
粤语访谈	`yue`

正确设置语言可显著提升识别准确率。

时间戳应用场景

视频剪辑定位关键片段
自动生成带时间轴的会议纪要
构建语音搜索引擎索引

6. 常见问题与解决方案

Q1：识别结果不准确？

排查步骤：

检查是否选择了正确的语言模式
确认音频清晰无背景噪音
尝试更换为 Paraformer-Large 模型
使用外部工具（如 Audacity）进行降噪预处理

Q2：识别速度慢？

可能原因与对策：

使用 CPU 模式 → 切换至 CUDA 模式
音频过长 → 分段处理（每段 ≤ 5 分钟）
模型未加载 → 点击“加载模型”重新初始化

Q3：无法上传音频？

检查项：

文件格式是否受支持（优先使用 WAV 或 MP3）
文件大小是否超过 100MB
浏览器是否为最新版 Chrome/Firefox

Q4：录音无声？

解决方法：

确保浏览器已授予麦克风权限
在系统设置中测试麦克风是否正常工作
修改代码中设备名称（参考 ALSA 设备命名规则）

Q5：如何提高整体识别质量？

综合建议：

使用 16kHz 采样率的高质量音频
减少环境噪声干扰
清晰发音，避免过快语速
合理选择语言模型和识别模式

7. 总结

本文详细介绍了基于 “FunASR 语音识别基于speech_ngram_lm_zh-cn 二次开发构建by科哥” 镜像的完整部署与使用流程。该方案通过封装复杂的技术细节，提供了直观易用的 WebUI 界面，实现了从音频上传、实时录音到多格式导出的一站式语音识别服务。

其核心优势在于：

开箱即用：无需编写代码即可完成部署
功能完整：涵盖 VAD、PUNC、时间戳等工业级特性
灵活适配：支持 CPU/GPU、多种语言与模型切换
易于集成：输出格式标准化，便于后续自动化处理

无论是个人开发者尝试语音识别技术，还是企业用于会议转录、教育录播等场景，该镜像都提供了一个高效、稳定的解决方案。

未来可进一步探索方向包括：

集成热词功能提升专有名词识别率
构建 RESTful API 实现服务化调用
结合 Whisper 等多语言模型拓展国际化支持

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 ZEEKLOG星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。