IndexTTS Docker镜像文档

镜像概述

IndexTTS Docker镜像是基于IndexTTS项目构建的文本转语音（TTS）容器化方案，优先使用GPU加速以提升性能，若无GPU支持则自动降级为CPU模式运行（速度显著降低）。镜像内置Gradio WebUI，可通过浏览器便捷访问。

部署方案

1. Docker Run部署

基本命令

shell
# 需Docker环境，--rm表示停止后删除容器
docker run --rm -it --gpus all -p 7860:7860 luojiecong/index-tts:1.5-20250727-9098497

阿里云加速镜像

shell
docker run --rm -it --gpus all -p 7860:7860 xxx.xuanyuan.run/luojiecong/index-tts:1.5-20250727-9098497

访问方式

部署后通过浏览器访问：[***]

2. Docker Compose部署

docker-compose.yml配置

yaml
services:
  index-tts:
    image: luojiecong/index-tts:1.5-20250727-9098497   # 使用指定镜像
    container_name: index-tts                          # 容器名称，便于管理
    restart: unless-stopped                            # 异常退出时重启，手动停止则不重启
    ports:
      - "7860:7860"                                     # 映射容器7860端口到主机（Gradio WebUI默认端口）
    volumes:
      - ./tmp:/tmp
      #- ./checkpoints:/checkpoints                     # 可选：映射本地模型权重目录到容器
    deploy:
      resources:
        reservations:
          devices:
            - capabilities: [gpu]                       # Docker Compose GPU资源声明
    environment:
      - NVIDIA_VISIBLE_DEVICES=all                      # 启用所有GPU（可指定具体编号）
    stdin_open: true                                    # 保持标准输入打开
    tty: true                                           # 分配伪终端

操作命令

shell
# 启动容器（后台运行）
docker-compose up -d

# 停止并移除容器
docker-compose down

构建方法（CPU版本）

构建CPU版本镜像命令：

shell
docker build -t image:tag -f Dockerfile .

环境要求

• Docker环境（推荐nvidia-docker以支持GPU）
• 建议GPU环境以保证性能，CPU模式仅用于测试
• 开放主机7860端口（或自定义映射端口）