Docker 镜像 rhasspy/wyoming-piper 技术文档

镜像概述与主要用途

rhasspy/wyoming-piper 是一个基于 Wyoming 协议的服务器镜像，用于集成 Piper 文本转语音（TTS）系统。该镜像实现了 Wyoming 协议与 Piper TTS 引擎的对接，提供标准化的文本到语音转换服务，支持通过网络接口为各类应用提供语音合成能力。

核心功能与特性

• Wyoming 协议支持：遵循 Wyoming 协议规范，可与支持该协议的客户端（如 Home Assistant）无缝集成。
• Piper TTS 引擎：内置 Piper 文本转语音引擎，提供自然流畅的语音合成效果。
• 多语音模型支持：通过 --voice 参数指定不同语言/风格的语音模型（如 en_US-lessac-medium）。
• HTTP API 接口：内置 HTTP 服务器（默认端口 5000），支持通过 HTTP 请求调用 TTS 功能，提供交互式 API 文档。
• 本地数据持久化：支持挂载本地目录至容器 /data 路径，用于存储语音模型缓存或配置文件，避免重复下载。

使用场景与适用范围

• 智能家居系统集成：作为 Home Assistant 等智能家居平台的 TTS 服务组件，实现设备语音通知、交互反馈等功能。
• 语音助手开发：为自定义语音助手提供文本转语音能力，支持实时语音合成。
• 自动化通知系统：用于服务器监控、业务告警等场景的语音通知生成。
• 开发与测试：快速搭建本地 TTS 服务，验证文本转语音功能原型。

使用方法与配置说明

前提条件

• 已安装 Docker 环境（Docker Engine 20.10+ 推荐）。
• 若需持久化数据，准备本地目录（如 /path/to/local/data）用于挂载。

基本运行命令

通过以下命令启动基础 TTS 服务（仅支持 Wyoming 协议，默认端口 ***）：

bash
docker run -it -p ***:*** -v /path/to/local/data:/data rhasspy/wyoming-piper \
    --voice en_US-lessac-medium

参数说明：

• -p ***:***：映射容器 Wyoming 协议端口至主机，供客户端连接。
• -v /path/to/local/data:/data：挂载本地目录至容器 /data，用于存储语音模型及缓存（首次运行会自动下载模型至该目录）。
• --voice en_US-lessac-medium：指定语音模型（示例为美式英语中等语速模型，其他模型见 Piper 语音示例）。

启用 HTTP 服务器

若需通过 HTTP API 调用 TTS 功能，需额外映射 HTTP 端口（默认 5000）：

bash
docker run -it -p 5000:5000 -p ***:*** -v /path/to/local/data:/data rhasspy/wyoming-piper \
    --voice en_US-lessac-medium

启动后，访问 http://localhost:5000 可查看交互式 API 文档，支持在线测试文本转语音功能。

docker-compose 配置示例

创建 docker-compose.yml 文件，简化服务管理：

yaml
version: '3.8'

services:
  wyoming-piper:
    image: rhasspy/wyoming-piper
    container_name: wyoming-piper
    restart: unless-stopped
    ports:
      - "***:***"  # Wyoming 协议端口
      - "5000:5000"    # HTTP API 端口
    volumes:
      - /path/to/local/data:/data  # 替换为实际本地目录
    command: --voice en_US-lessac-medium  # 指定语音模型

启动服务：

bash
docker-compose up -d

参数说明

补充信息

• ***文档：rhasspy/wyoming-piper 文档
• 语音模型示例：Piper 语音 samples（可试听并获取模型名称）