Wan2.2-I2V-A14B生产环境部署：Nginx反向代理与Docker Compose编排

本文介绍了如何在星图GPU平台上自动化部署Wan2.2-I2V-A14B私有部署镜像（RTX4090D 24G CUDA12.4优化版），实现高效视频生成与处理。通过Nginx反向代理与Docker Compose编排，用户可快速搭建生产环境，适用于短视频内容创作、影视特效制作等场景，显著提升AI视频生成效率。

韩锋裂变营销

316人浏览 · 2026-03-30 05:31:02

韩锋裂变营销 · 2026-03-30 05:31:02 发布

Wan2.2-I2V-A14B生产环境部署：Nginx反向代理与Docker Compose编排

1. 部署目标与前置准备

在开始之前，我们先明确这次部署要实现的目标：通过Docker Compose编排Wan2.2-I2V-A14B模型服务及其依赖组件，使用Nginx作为反向代理，构建一个高可用的生产环境。这个方案能让你轻松管理多个服务，同时确保系统的安全性和稳定性。

你需要准备：

一台Linux服务器（推荐Ubuntu 20.04+）
已安装Docker和Docker Compose
域名和SSL证书（可选，但生产环境强烈建议）
基础命令行操作知识

2. 项目结构与Docker Compose配置

2.1 创建项目目录

首先建立一个清晰的项目目录结构：

mkdir -p wan-i2v-deploy/{config,models,logs,nginx}
cd wan-i2v-deploy

这个结构将包含：

config：存放各服务的配置文件
models：存放模型文件
logs：存放各服务的日志
nginx：存放Nginx配置

2.2 编写docker-compose.yml

创建docker-compose.yml文件，这是整个部署的核心：

version: '3.8'

services:
  app:
    image: wan-i2v-a14b:latest
    build: .
    ports:
      - "8000:8000"
    volumes:
      - ./models:/app/models
    environment:
      - REDIS_HOST=redis
      - DB_HOST=db
    depends_on:
      - redis
      - db
    restart: unless-stopped

  redis:
    image: redis:6-alpine
    volumes:
      - ./data/redis:/data
    restart: unless-stopped

  db:
    image: postgres:13-alpine
    volumes:
      - ./data/postgres:/var/lib/postgresql/data
    environment:
      - POSTGRES_PASSWORD=your_secure_password
    restart: unless-stopped

  nginx:
    image: nginx:1.21-alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf
      - ./config/ssl:/etc/nginx/ssl
      - ./logs/nginx:/var/log/nginx
    depends_on:
      - app
    restart: unless-stopped

这个配置定义了四个服务：

app：Wan2.2-I2V-A14B模型服务
redis：缓存服务
db：数据库服务
nginx：反向代理服务

3. Nginx反向代理配置

3.1 基础Nginx配置

在nginx/nginx.conf中添加以下配置：

worker_processes auto;

events {
    worker_connections 1024;
}

http {
    upstream app_servers {
        server app:8000;
    }

    server {
        listen 80;
        server_name yourdomain.com;

        location / {
            proxy_pass http://app_servers;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }

        access_log /var/log/nginx/access.log;
        error_log /var/log/nginx/error.log;
    }
}

3.2 添加SSL支持（可选但推荐）

要启用HTTPS，你需要准备SSL证书（可以从Let's Encrypt获取免费证书），然后在Nginx配置中添加：

server {
    listen 443 ssl;
    server_name yourdomain.com;

    ssl_certificate /etc/nginx/ssl/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/privkey.pem;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    location / {
        proxy_pass http://app_servers;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

4. 模型服务Dockerfile

在项目根目录创建Dockerfile来构建模型服务：

FROM python:3.9-slim

WORKDIR /app

# 安装系统依赖
RUN apt-get update && apt-get install -y \
    build-essential \
    && rm -rf /var/lib/apt/lists/*

# 复制依赖文件并安装
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制模型文件和代码
COPY models/ ./models/
COPY . .

# 暴露端口
EXPOSE 8000

# 启动命令
CMD ["gunicorn", "--bind", "0.0.0.0:8000", "app:app"]

5. 部署与启动

5.1 构建并启动服务

运行以下命令启动所有服务：

docker-compose build
docker-compose up -d

5.2 验证服务运行

检查服务状态：

docker-compose ps

你应该看到所有服务都处于"running"状态。可以通过以下命令查看日志：

docker-compose logs -f

5.3 测试API端点

使用curl测试API是否正常工作：

curl http://localhost/api/v1/status

如果配置了域名和HTTPS，可以用：

curl https://yourdomain.com/api/v1/status

6. 生产环境优化建议

6.1 性能调优

根据你的服务器配置，可以调整以下参数：

在docker-compose.yml中为app服务添加资源限制：

deploy:
  resources:
    limits:
      cpus: '2'
      memory: 4G

调整Gunicorn工作进程数（在Dockerfile的CMD中）：

CMD ["gunicorn", "--workers", "4", "--threads", "2", "--bind", "0.0.0.0:8000", "app:app"]

6.2 监控与日志

建议添加监控服务如Prometheus和Grafana，可以修改docker-compose.yml添加：

services:
  prometheus:
    image: prom/prometheus
    ports:
      - "9090:9090"
    volumes:
      - ./config/prometheus.yml:/etc/prometheus/prometheus.yml
    restart: unless-stopped

  grafana:
    image: grafana/grafana
    ports:
      - "3000:3000"
    volumes:
      - grafana-storage:/var/lib/grafana
    restart: unless-stopped

volumes:
  grafana-storage: