Whisper-WebUI部署完全攻略：Docker、本地安装与云端部署

【免费下载链接】Whisper-WebUI A Web UI for easy subtitle using whisper model. 项目地址: https://gitcode.com/gh_mirrors/wh/Whisper-WebUI

Whisper-WebUI是一款基于Whisper模型的字幕生成Web界面工具，提供了便捷的语音转文字功能。本指南将详细介绍三种部署方式——Docker容器化部署、本地环境安装以及云端服务器部署，帮助新手用户快速搭建属于自己的字幕生成平台。

📋 部署前准备工作

在开始部署Whisper-WebUI之前，需要确保系统满足以下基础要求：

• 硬件要求：建议至少4GB内存，支持CUDA的NVIDIA显卡可提升处理速度（非必需）
• 软件依赖：
  • Git（用于克隆代码仓库）
  • Python 3.10~3.12版本
  • FFmpeg（用于音频处理）

必需软件安装指南

1. Git安装：从官网下载对应系统版本并按照提示安装
2. Python安装：推荐使用3.10版本，安装时勾选"Add Python to PATH"选项
3. FFmpeg安装：
   • 下载地址：FFmpeg官方网站
   • 安装后需将FFmpeg/bin文件夹添加到系统环境变量PATH中

🐳 Docker容器化部署（推荐新手）

Docker部署方式具有环境隔离、配置简单的优点，适合没有太多开发经验的用户。

步骤1：安装Docker Desktop

1. 访问Docker官网下载并安装Docker Desktop
2. 启动Docker Desktop，等待服务完全启动（任务栏图标停止动画）

步骤2：获取项目代码

打开终端（命令提示符/终端），执行以下命令克隆代码仓库：

git clone https://gitcode.com/gh_mirrors/wh/Whisper-WebUI
cd Whisper-WebUI

步骤3：构建并启动容器

在项目根目录执行以下命令：

docker compose build
docker compose up

步骤4：访问Web界面

容器启动成功后，打开浏览器访问：http://localhost:7860即可使用Whisper-WebUI

提示：如果需要修改配置，可以编辑项目根目录下的docker-compose.yaml文件

💻 本地环境安装（适合开发调试）

本地安装方式可以更灵活地调整配置，适合需要进行二次开发或自定义设置的用户。

步骤1：克隆代码仓库

git clone https://gitcode.com/gh_mirrors/wh/Whisper-WebUI
cd Whisper-WebUI

步骤2：安装依赖

根据操作系统执行对应的安装脚本：

• Windows系统：

  install.bat
  

• Linux/Mac系统：

  chmod +x install.sh
  ./install.sh
  

安装脚本会自动创建虚拟环境（venv目录）并安装requirements.txt中列出的所有依赖包

步骤3：启动Web服务

• Windows系统：

  start-webui.bat
  

• Linux/Mac系统：

  chmod +x start-webui.sh
  ./start-webui.sh
  

服务启动后，访问http://localhost:7860即可使用Web界面

☁️ 云端服务器部署（生产环境）

对于需要公网访问或长期运行的场景，推荐使用云端服务器部署方案。

步骤1：服务器环境准备

1. 准备一台运行Linux系统的云服务器（推荐Ubuntu 20.04+）
2. 安装必要依赖：

   sudo apt update
   sudo apt install -y git python3 python3-venv ffmpeg nginx
   

步骤2：部署应用服务

1. 克隆代码并安装依赖：

   git clone https://gitcode.com/gh_mirrors/wh/Whisper-WebUI
   cd Whisper-WebUI
   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
   pip install -r backend/requirements-backend.txt
   

2. 使用uvicorn启动后端服务：

   uvicorn backend.main:app --host 0.0.0.0 --port 8000
   

步骤3：配置Nginx反向代理

1. 编辑Nginx配置文件：

   sudo nano /etc/nginx/sites-available/whisper-webui
   

2. 添加以下配置（替换your_domain.com为实际域名）：

   server {
       listen 80;
       server_name your_domain.com;
   
       location / {
           proxy_pass http://127.0.0.1:7860;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
       }
   }
   

3. 启用配置并重启Nginx：

   sudo ln -s /etc/nginx/sites-available/whisper-webui /etc/nginx/sites-enabled/
   sudo nginx -t
   sudo systemctl restart nginx
   

步骤4：配置自动启动

使用systemd创建服务，确保服务器重启后自动运行：

sudo nano /etc/systemd/system/whisper-webui.service

添加以下内容：

[Unit]
Description=Whisper-WebUI Service
After=network.target

[Service]
User=ubuntu
WorkingDirectory=/path/to/Whisper-WebUI
ExecStart=/path/to/Whisper-WebUI/venv/bin/python app.py
Restart=always

[Install]
WantedBy=multi-user.target

启用并启动服务：

sudo systemctl enable whisper-webui
sudo systemctl start whisper-webui

⚙️ 常见问题解决

1. 依赖安装失败

如果遇到依赖安装问题，可以尝试手动安装：

pip install --upgrade pip
pip install -r requirements.txt --extra-index-url https://download.pytorch.org/whl/cu128

2. 端口占用问题

如果启动时提示端口被占用，可以修改启动脚本中的端口号，例如修改start-webui.sh中的端口参数。

3. GPU加速配置

默认配置针对NVIDIA GPU优化，如使用其他类型显卡或CPU，需修改requirements.txt中的--extra-index-url参数。

📝 总结

通过本指南，您已经掌握了Whisper-WebUI的三种部署方式：

• Docker部署：适合快速启动，环境隔离
• 本地安装：适合开发调试，自定义配置
• 云端部署：适合生产环境，公网访问

选择最适合您需求的部署方式，开始体验便捷的语音转文字功能吧！如有其他问题，可以查阅项目中的backend/README.md获取更多技术细节。

【免费下载链接】Whisper-WebUI A Web UI for easy subtitle using whisper model. 项目地址: https://gitcode.com/gh_mirrors/wh/Whisper-WebUI