HunyuanVideo-Foley保姆级教程：Docker Compose编排WebUI+API+Redis缓存
HunyuanVideo-Foley保姆级教程：Docker Compose编排WebUI+API+Redis缓存
1. 环境准备与快速部署
在开始之前，请确保您的硬件配置满足以下要求：
- 显卡：RTX 4090/4090D 24GB显存
- 内存：≥120GB
- CPU：10核及以上
- 磁盘空间：系统盘50GB + 数据盘40GB
1.1 安装Docker和Docker Compose
如果您尚未安装Docker和Docker Compose，请先执行以下命令：
# 安装Docker curl -fsSL https://get.docker.com | sh sudo systemctl start docker sudo systemctl enable docker # 安装Docker Compose sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose1.2 下载镜像并准备环境
HunyuanVideo-Foley镜像已经预装了所有必要的依赖项，包括：
- Python 3.10+
- PyTorch 2.4+ (CUDA 12.4编译)
- Transformers/Accelerate/Diffusers
- xFormers/FlashAttention加速库
- FFmpeg音视频处理工具
2. Docker Compose编排配置
我们将使用Docker Compose来同时管理WebUI服务、API服务和Redis缓存。创建一个docker-compose.yml文件：
version: '3.8' services: webui: image: hunyuanvideo-foley:latest command: bash start_webui.sh ports: - "7860:7860" volumes: - ./output:/workspace/output deploy: resources: devices: - driver: nvidia capabilities: [gpu] environment: - REDIS_HOST=redis - REDIS_PORT=6379 api: image: hunyuanvideo-foley:latest command: bash start_api.sh ports: - "8000:8000" volumes: - ./output:/workspace/output deploy: resources: devices: - driver: nvidia capabilities: [gpu] environment: - REDIS_HOST=redis - REDIS_PORT=6379 depends_on: - redis redis: image: redis:alpine ports: - "6379:6379" volumes: - redis_data:/data command: redis-server --appendonly yes volumes: redis_data:3. 启动服务
3.1 一键启动所有服务
使用以下命令启动所有服务（WebUI、API和Redis）：
docker-compose up -d3.2 验证服务状态
检查各服务是否正常运行：
docker-compose ps您应该看到三个服务都处于"running"状态。
4. 服务访问与使用
4.1 WebUI界面访问
WebUI服务将在以下地址可用：
http://localhost:7860在WebUI中，您可以：
- 输入文本提示生成视频
- 添加音效描述生成Foley音效
- 调整生成参数（时长、采样率等）
- 预览和下载生成结果
4.2 API服务使用
API服务提供了RESTful接口，文档地址：
http://localhost:8000/docs您可以使用curl测试API：
# 生成视频 curl -X POST "http://localhost:8000/api/v1/generate/video" \ -H "Content-Type: application/json" \ -d '{"prompt":"繁忙的城市街道","duration":10}' # 生成音效 curl -X POST "http://localhost:8000/api/v1/generate/audio" \ -H "Content-Type: application/json" \ -d '{"prompt":"雨声和远处雷声","duration":15}'4.3 Redis缓存配置
Redis服务用于缓存生成结果，提高重复请求的响应速度。默认配置：
- 主机：redis
- 端口：6379
- 密码：无
- 数据库：0
您可以通过环境变量调整缓存策略：
environment: - REDIS_CACHE_TTL=3600 # 缓存过期时间(秒) - REDIS_MAX_MEMORY=2gb # 最大内存使用5. 高级配置与优化
5.1 显存优化配置
针对RTX 4090D 24GB显卡，可以添加以下优化参数：
environment: - XFORMERS_MEMORY_EFFICIENT_ATTENTION=1 - FLASH_ATTENTION=1 - TORCH_CUDA_ARCH_LIST=8.95.2 批量生成配置
要启用批量生成功能，修改API服务的环境变量：
environment: - MAX_BATCH_SIZE=4 - BATCH_TIMEOUT=305.3 挂载外部存储
如果需要更大的输出存储空间，可以挂载外部存储：
volumes: - /path/to/external/storage:/workspace/output6. 常见问题解决
6.1 服务启动失败
如果服务启动失败，检查日志：
docker-compose logs webui docker-compose logs api docker-compose logs redis常见问题：
- 显存不足：确保没有其他进程占用显存
- 端口冲突：检查7860和8000端口是否被占用
- 权限问题：确保对挂载目录有读写权限
6.2 性能调优建议
如果生成速度不理想，可以尝试：
- 启用xFormers和FlashAttention
- 增加Docker容器的共享内存大小
- 调整Redis缓存大小
- 使用更短的生成时长进行测试
6.3 模型加载缓慢
首次加载模型可能需要1-3分钟，这是正常现象。后续请求会快很多，因为模型会保留在内存中。
7. 总结
通过本教程，您已经成功部署了包含以下组件的HunyuanVideo-Foley完整解决方案：
- WebUI可视化界面
- RESTful API服务
- Redis缓存服务
- Docker Compose编排管理
这种部署方式具有以下优势：
- 一键启动所有服务
- 资源隔离，互不干扰
- 易于扩展和维护
- 内置性能优化
- 支持二次开发
获取更多AI镜像
想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。