构建时间: 2026-10-11T04:20:13Z
新手安装指南

安装 KokoroTTS

回答六个简短问题。我们会根据你的选择给出一套明确的安装方案,并用简单语言解释每一步。

稳定版 v1.0 或滚动 latest
选择滚动 latest 获取当前更新,或选择通过已发布 SHA-256 摘要锁定的稳定版 v1.0,以获得可重复安装。

告诉我们这台电脑的情况

答案只保留在浏览器中,不会提交或存储到我们的服务器。

操作系统
电脑硬件
下载大小
发布通道
镜像来源
谁可以打开它?

安装 Docker

从官方指南下载 Docker Desktop,使用推荐的 WSL 2 选项安装,然后打开 Docker 并等待引擎启动: Docker Desktop for Windows ↗.

打开命令窗口

选择任务栏上的 Windows 搜索,输入 PowerShell,然后打开 Windows PowerShell: .

粘贴以下检查命令并按 Enter:

检查 Docker
docker version

应同时看到 Client 和 Server 部分。如果缺少 Server,请打开 Docker 并等待启动完成。

为设置和下载文件创建安全位置

Docker 将其称为卷。替换或更新容器时,它会保留重要应用文件。

创建持久存储
docker volume create kokorotts_data

下载并启动 KokoroTTS

复制完整的单行命令,粘贴到同一窗口并按 Enter。首次下载可能较大,请保持窗口打开。

生成的命令
docker run -d --name kokorotts --restart unless-stopped -p 127.0.0.1:7860:7860 --gpus all -v kokorotts_data:/app/persistent hangrylabs/kokorotts:latest

打开 KokoroTTS

等待应用显示已就绪,然后选择此按钮:

在 localhost:7860 打开 KokoroTTS ↗

打开生成页面,输入句子,选择声音并点击生成。可取消合成使用流式页面,集成状态使用 API 页面,模型包和 GPU 控制使用系统页面。

如果页面尚未打开,请再等一分钟后重试。

以后常用的命令

需要时重新打开 PowerShell 或 Terminal 并使用以下命令。

停止
docker stop kokorotts
再次启动
docker start kokorotts
查看启动消息
docker logs -f kokorotts
这些选择改变了什么?

完整镜像包含模型资源,首次拉取后最适合离线使用。精简镜像会在首次使用时下载模型。Docker Hub 和 GHCR 是官方来源;1ms 是可选的第三方镜像服务。本机访问绑定到 127.0.0.1;家庭网络访问会在所有接口发布端口,只应在可信私有网络使用。