KnoAI 技术站

主题

ComfyUI 动漫生成流水线部署文档 ​

部署日期: 2026-08-18
GPU: AMD Radeon RX 7900 XTX (24GB VRAM, gfx1100)
节点: szb122009 (192.168.122.9)
基础镜像: vllm-rocm:v0.6.6 (ROCm 6.3.2 + PyTorch 2.4.0)
ComfyUI 版本: v0.3.10
动漫模型: Animagine XL 3.1 (SDXL, 6.5GB)

一、部署架构 ​

  • ComfyUI Pod 运行在 GPU 节点 szb122009
  • Web UI: http://0.0.0.0:8188 (NodePort 30188)
  • 挂载: /opt/comfyui (hostPath), /dev/dri, /dev/kfd
  • 环境变量: HSA_OVERRIDE_GFX_VERSION=11.0.0, PYTORCH_ROCM_ARCH=gfx1100

二、部署步骤 ​

2.1 前置条件 ​

  1. 缩容 vllm-qwen14b 到 0（释放 GPU）
  2. 确认 GPU 节点 szb122009 可用

2.2 创建 Setup Pod ​

创建临时 Pod用于安装和下载。重要：只挂载 /opt/comfyui，不要挂载整个 /opt，否则会覆盖镜像中的 PyTorch。

2.3 下载 ComfyUI ​

从 gitee.com 镜像下载 v0.3.10：

bash
curl -fSL -o comfyui.tar.gz https://gitee.com/mirrors/ComfyUI/repository/archive/v0.3.10.tar.gz
tar xzf comfyui.tar.gz && mv comfyui-v0.3.10 ComfyUI

2.4 安装依赖 ​

使用清华镜像安装（避免 PyPI 超时）：

  • comfyui-frontend-package, comfyui-workflow-templates, comfyui-embedded-docs
  • torchsde, aiohttp, yarl, alembic, SQLAlchemy, filelock, simpleeval, blake3
  • kornia==0.7.1, spandrel, pydantic, pydantic-settings
  • comfy-kitchen==0.1.6, comfy-aimdo, trampoline
  • transformers<4.46（兼容 PyTorch 2.4.0）

2.5 下载动漫模型 ​

从 hf-mirror.com 下载 Animagine XL 3.1（约 6.5GB，10-15分钟）：

bash
curl -fSL --retry 3 -o /opt/comfyui/ComfyUI/models/checkpoints/animagine-xl-3.1.safetensors \
  https://hf-mirror.com/cagliostrolab/animagine-xl-3.1/resolve/main/animagine-xl-3.1.safetensors

2.6 部署到生产 ​

bash
kubectl apply -f comfyui-deploy.yaml

三、关键问题与解决方案 ​

问题原因解决方案
PyTorch 不可见Setup Pod 挂载 /opt 覆盖了镜像中的 PyTorch只挂载 /opt/comfyui
comfy-kitchen 兼容性0.2.x 需要 PyTorch >= 2.5降级到 0.1.6
transformers 兼容性5.x 需要 PyTorch >= 2.5降级到 <4.46
torchaudio 不兼容PyPI 版本是 CUDA 版本不安装（动漫图像不需要音频）
GitHub 被墙网络限制使用 gitee.com 镜像
PyPI 下载慢网络限制使用清华镜像 pypi.tuna.tsinghua.edu.cn
kornia_rs 缺失kornia 0.8.x 需要 kornia_rs降级到 kornia==0.7.1

四、部署文件清单 ​

文件用途
comfyui-deploy.yamlK8s Deployment + Service
comfyui-deploy.sh部署脚本
comfyui-setup.yaml临时 Setup Pod
comfyui-anime-pipeline.md本文档

五、运维命令 ​

bash
./comfyui-deploy.sh start    # 启动
./comfyui-deploy.sh stop     # 停止（释放 GPU）
./comfyui-deploy.sh restart  # 重启
./comfyui-deploy.sh status   # 查看状态
./comfyui-deploy.sh logs     # 查看日志

六、访问方式 ​

七、动漫工作流 ​

使用 Animagine XL 3.1 模型生成动漫风格图像：

  • Steps: 20-30, CFG Scale: 7-9
  • Sampler: euler_ancestral 或 dpmpp_2m
  • Resolution: 1024x1024 (SDXL 标准)
  • 正向提示词: 1girl, masterpiece, best quality, anime style
  • 负向提示词: low quality, bad anatomy, worst quality

八、性能指标 ​

  • GPU 显存使用: ~8-10GB (模型加载)
  • 生成时间: 约 10-20 秒/张 (1024x1024, 20 steps)
  • 最大分辨率: 2048x2048 (受显存限制)