# Piper

## 产品介绍
Piper 是一个通过 Wyoming 协议提供文本转语音服务的应用，镜像由 LinuxServer.io 维护。

## 主要功能
- 提供 Piper 文本转语音服务。
- 支持选择语音模型、语速、噪声和说话人参数。
- 持久化保存配置和模型数据。

## 访问说明
安装完成后，通过 1Panel 查看容器状态与日志，并使用配置的 Wyoming 端口连接客户端。

## Introduction
Piper is a text-to-speech service exposed through the Wyoming protocol and maintained by LinuxServer.io.

## Features
- Text-to-speech service with configurable voice and runtime parameters.
- Persistent configuration and model storage.
- Wyoming protocol connectivity on the configured port.

## 应用简介
Piper 文本转语音 Wyoming 服务。

英文说明：Text to speech Wyoming service maintained by LinuxServer.io.

## 部署说明
- 本应用使用 Docker Compose 在 1Panel 中部署。
- 应用分类：AI。
- 支持架构：amd64、arm64。
- 可选版本以应用商店当前版本目录和安装表单为准。
- 安装后使用应用表单中的 Wyoming 端口连接客户端。

## 端口
| 变量 | 说明 | 默认值 | 必填 |
| --- | --- | --- | --- |
| PANEL_APP_PORT_WYOMING | Wyoming 端口 | 10200 | 是 |

## 数据持久化
| 变量 | 说明 | 默认值 | 必填 |
| --- | --- | --- | --- |
| CONFIG_PATH | 配置文件路径 | ./data/config | 是 |

升级或迁移前，请在 1Panel 中备份上述数据目录。

## 配置项
| 变量 | 说明 | 默认值 | 必填 |
| --- | --- | --- | --- |
| PIPER_VOICE | Piper 语音 | en_US-lessac-medium | 是 |
| LOCAL_ONLY | 仅本地模型 | - | 否 |
| PIPER_LENGTH | 语音语速，低于 1.0 更快，高于 1.0 更慢 | 1.0 | 否 |
| PIPER_NOISE | 语音变化噪声，过高会降低质量 | 0.667 | 否 |
| PIPER_NOISEW | 语调节奏噪声，过高可能导致停顿异常 | 0.333 | 否 |
| PIPER_SPEAKER | 多说话人语音模型的说话人编号 | 0 | 否 |
| NO_STREAMING | 禁用流式音频 | - | 否 |
| TIME_ZONE | 时区 | Asia/Shanghai | 是 |

## 使用说明
- 安装完成后，在 1Panel 应用页面查看运行状态、端口和日志。
- 首次启用前，请按安装表单填写域名、账号、密码、Token、数据目录等参数。
- 如需对外开放访问，请同步检查防火墙、安全组和反向代理配置。

## 参考资料
- 官网: <https://github.com/rhasspy/piper>
- 文档: <https://docs.linuxserver.io/images/docker-piper/>
- 源码: <https://github.com/linuxserver/docker-piper>