ghcr.io/rsxdalv/tts-webui:main Docker 镜像

ghcr.io

ghcr.iolinux/amd64main大小: 未知更新于 2026年4月16日

TTS WebUI

Download Installer || Installation || Docker Setup || Silly Tavern || Extensions || Feedback / Bug reports

视频

示例

截图

支持的模型

这些模型默认未安装，而是作为扩展提供。

安装

使用安装程序（推荐）

当前基础安装大小约为 10.7 GB。每个模型还需要额外 2-8 GB 的空间。

下载最新版本并解压。
运行 start_tts_webui.bat 或 start_tts_webui.sh 启动服务器。系统会提示您选择正在使用的 GPU/芯片。完成所有安装后，将在 [] 启动 Gradio 服务器，并在 [] 启动 React UI。
输出日志可在 installer_scripts/output.log 文件中查看。

[!NOTE] 启动脚本会设置 conda 环境和 Python 虚拟环境。因此，您无需在此之前创建虚拟环境，实际上，从其他虚拟环境启动可能会导致脚本出错。

手动安装

前提条件：

git
Python 3.10 或 3.11（3.12 暂不支持）
PyTorch
ffmpeg（带 vorbis 支持）
（可选）NodeJS 22.9.0（用于 React UI）
SQLite（与 Python 捆绑）（用于数据库支持）
克隆仓库：

git clone [***]
  cd tts-webui

安装依赖包：

pip install -r requirements.txt

运行服务器：

python server.py --no-react

对于 React UI：

cd react-ui
  npm install
  npm run build
  cd ..
  python server.py

有关详细的手动安装说明，请参阅《手动安装指南》。

Docker 设置

tts-webui 也可以在 Docker 容器中运行。在 Docker 中使用 CUDA 需要 NVIDIA Container Toolkit。开始前，请从 GitHub Container Registry 拉取镜像：

docker pull ghcr.io/rsxdalv/tts-webui:main

拉取镜像后，可使用 Docker Compose 启动：端口 7770（环境变量：TTS_PORT）用于 Gradio 后端，3000（环境变量：UI_PORT）用于 React 前端。

docker compose up -d

容器首次生成输出时需要一些时间，因为模型会在后台下载。可通过查看容器日志验证下载状态：

docker logs tts-webui

自行构建镜像

如果您希望构建自己的 Docker 容器，可使用提供的 Dockerfile：

docker build -t tts-webui .

[!NOTE] 需要编辑 docker-compose 文件以使用您刚构建的镜像。

变更日志

四月：

将 torchcodec CPU 添加到依赖项
将 PyTorch 升级到 2.11.0
更新并固定 TorchAudio 至 2.7.0

三月：

feat: Next.js 13.5 → 16.2.1 升级

十二月：

小错误修复和改进
refactor: 将 bark 配置加载从 WebUI 提取为独立函数
chore: 从 tts-webui 中移除 postgres，因为它是大多数用户不需要的重型依赖
feat: 添加数据库 API 服务器以管理生成的音频文件和元数据

十一月：

在 Gradio UI 中通过 iframe 直接添加扩展市场
将 voices-tortoise 移至 voices/tortoise/（并将 maha-tts 移至 voices/maha_tts/）
feat: 为 tts_webui 模块添加全面测试套件
feat: 在扩展市场中实现安装按钮
feat: 在扩展管理 UI 中添加检查依赖项的按钮
feat(cli): 添加 extension-manager 命令以启动 GUI 工具
chore: 从 google colab 中移除 uv
chore: 将日志目录移至 installer_scripts/logs/
feat: 支持通过 config.json 禁用装饰器扩展

十月：

将 Gradio 更新至 5.49.1
将 @gradio/client 更新至 1.19.1
修复 Chatterbox 安装问题、路径以及 Silly Tavern 中的流错误
创建新扩展类别 - 对话式 AI
重组环境变量，新的 dotenv 管理器
将更多 UI 转换为扩展并简化基础服务器
为 OpenAI TTS API 扩展添加 API_KEY
feat: 支持新扩展格式 - tabsInGroups
feat: 添加外部扩展安装器，通过 JSON 管理和安装外部扩展
feat: 在文档和安装程序 UI 中添加指向 TTS WebUI 扩展目录的链接
feat: 添加日志查看器扩展以查看和管理日志文件

过往变更

有关 2025 年的详细变更列表，请参阅《2025 年变更日志》。

有关 2024 年的详细变更列表，请参阅《2024 年变更日志》。

有关 2023 年的详细变更列表，请参阅《2023 年变更日志》。

扩展

可从 webui 本身或使用 React UI 安装扩展。也可使用扩展管理器或外部扩展安装器（用于通过 JSON 添加自定义扩展的内置工具）进行安装。

在内部，扩展只是通过 pip 安装的 Python 包。可同时安装多个扩展，但它们之间可能存在兼容性问题。安装或更新扩展后，需要重启应用才能加载。

ghcr.io/rsxdalv/tts-webui:main

TTS WebUI

视频

示例

截图

支持的模型

安装

使用安装程序（推荐）

手动安装

Docker 设置

自行构建镜像

变更日志

过往变更

扩展

集成

Silly Tavern

Text Generation WebUI（oobabooga/text-generation-webui）

拉取命令

专属域名未获取到

相关镜像

轩辕镜像配置手册

Docker 配置

登录仓库拉取

专属域名拉取

K8s Containerd

K3s

Dev Containers

Podman

Singularity/Apptainer

其他仓库配置

Harbor 镜像源配置

Portainer 镜像源配置

Nexus 镜像源配置

系统配置

Linux

Windows/Mac

MacOS OrbStack

Docker Compose

NAS 设备

群晖

飞牛

绿联

威联通

极空间

网络设备

爱快路由

宝塔面板

镜像拉取常见问题

使用与功能问题

配置了专属域名后，docker search 为什么会报错？

Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？

机器不能直连外网时，怎么用 docker save / load 迁镜像？

docker pull 拉插件报错（plugin v1+json）怎么办？

WSL 里 Docker 拉镜像特别慢，怎么排查和优化？

轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？

第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？

错误码与失败问题

docker pull 提示 manifest unknown 怎么办？

docker pull 提示 no matching manifest 怎么办？

镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？

Docker pull 时 HTTPS / TLS 证书验证失败怎么办？

Docker pull 时 DNS 解析超时或连不上仓库怎么办？

Docker 拉取出现 410 Gone 怎么办？

出现 402 或「流量用尽」提示怎么办？

Docker 拉取提示 UNAUTHORIZED（401）怎么办？

遇到 429 Too Many Requests（请求太频繁）怎么办？

docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？

为什么会出现「单层超过 20GB」或 413，无法加速拉取？

账号 / 计费 / 权限

轩辕镜像免费版和专业版有什么区别？

轩辕镜像支持哪些 Docker 镜像仓库？

镜像拉取失败还会不会扣流量？

麒麟 V10 / 统信 UOS 提示 KYSEC 权限不够怎么办？

如何在轩辕镜像申请开具发票？

怎么修改轩辕镜像的网站登录和仓库登录密码？

如何注销轩辕镜像账户？要注意什么？

配置与原理类

写了 registry-mirrors，为什么还是走官方或仍然报错？

怎么用 docker tag 去掉镜像名里的轩辕域名前缀？

如何拉取指定 CPU 架构的镜像（如 ARM64、AMD64）？