HunyuanVideo-Foley保姆级教程：Docker Compose编排WebUI+API+Redis缓存

HunyuanVideo-Foley保姆级教程Docker Compose编排WebUIAPIRedis缓存1. 环境准备与快速部署在开始之前请确保您的硬件配置满足以下要求显卡RTX 4090/4090D 24GB显存内存≥120GBCPU10核及以上磁盘空间系统盘50GB 数据盘40GB1.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.10PyTorch 2.4 (CUDA 12.4编译)Transformers/Accelerate/DiffusersxFormers/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_HOSTredis - REDIS_PORT6379 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_HOSTredis - REDIS_PORT6379 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和Redisdocker-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_TTL3600 # 缓存过期时间(秒) - REDIS_MAX_MEMORY2gb # 最大内存使用5. 高级配置与优化5.1 显存优化配置针对RTX 4090D 24GB显卡可以添加以下优化参数environment: - XFORMERS_MEMORY_EFFICIENT_ATTENTION1 - FLASH_ATTENTION1 - TORCH_CUDA_ARCH_LIST8.95.2 批量生成配置要启用批量生成功能修改API服务的环境变量environment: - MAX_BATCH_SIZE4 - BATCH_TIMEOUT305.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星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。