以下是基于 Docker 部署 WhisperLiveKit 的详细指南，整合了容器化部署的最佳实践和技术要点：

环境准备

确保系统已安装 Docker 和 Docker Compose。推荐使用 Linux 发行版或 macOS 作为宿主系统，Windows 需启用 WSL2 支持。

验证 Docker 版本：

docker --version
docker-compose --version

获取 WhisperLiveKit 镜像

官方镜像通常托管在 Docker Hub 或 GitHub Container Registry。拉取最新镜像：

docker pull livkit/whisperlive:latest

如需构建自定义镜像，创建包含以下内容的 Dockerfile：

FROM python:3.9-slim
RUN apt-get update && apt-get install -y ffmpeg
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . /app
WORKDIR /app

配置持久化存储

创建数据卷保存模型文件和配置：

docker volume create whisper_models
docker volume create whisper_config

编写 docker-compose.yml

典型配置示例：

version: '3.8'
services:
  whisper:
    image: livkit/whisperlive:latest
    ports:
      - "8080:8080"
    volumes:
      - whisper_models:/models
      - whisper_config:/config
    environment:
      - MODEL_SIZE=medium
      - DEVICE=cuda  # 若使用GPU加速
    deploy:
      resources:
        limits:
          cpus: '4'
          memory: 8G
volumes:
  whisper_models:
  whisper_config:

GPU 加速配置

NVIDIA GPU 用户需安装 nvidia-container-toolkit：

distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit
sudo systemctl restart docker

在 compose 文件中添加：

runtime: nvidia
environment:
  - NVIDIA_VISIBLE_DEVICES=all

启动服务

使用 compose 命令启动容器：

docker-compose up -d

验证服务状态：

docker ps
docker logs whisper

性能调优

对于实时音频处理，建议调整以下参数：

• 增加 -e MAX_CONCURRENT=4 控制并行处理数
• 设置 -e CHUNK_SIZE=2000 调整音频分块大小
• 添加 -e THREADS=4 指定处理线程数

监控与维护

查看资源使用情况：

docker stats

更新服务时：

docker-compose pull
docker-compose up -d --force-recreate

故障排查

常见问题解决方法： 端口冲突时修改 compose 文件的端口映射：

ports:
  - "9090:8080"

模型加载失败检查卷挂载：

docker exec -it whisper ls /models

内存不足时增加资源限制：

deploy:
  resources:
    limits:
      memory: 16G