基于 Docker 的轻量级 ComfyUI 部署方案

• Docker 20.10+
• NVIDIA Docker Runtime (GPU 支持)

# 一键启动
bash run.sh

Web 界面: http://localhost:8188

.
├── .cnb.yml                   # 云原生构建配置
├── Dockerfile                 # 优化版构建文件
├── run.sh                     # 主启动脚本
├── download_models.sh         # 模型下载脚本
├── README.md                  # 本文档
└── data/                      # 数据目录（自动创建）
    ├── models/                # AI 模型文件
    ├── input/                 # 输入文件
    ├── output/                # 生成结果
    ├── user/                  # 用户配置
    └── temp/                  # 临时文件

• 一键部署 - 单个脚本完成构建和启动
• 智能检测 - 自动识别 GPU/CPU 模式
• 模型下载 - 自动下载 Flux2 和相关模型
• 纯净版本 - 仅包含 ComfyUI 核心 + Manager
• 数据持久化 - 完整的数据目录映射
• 安全可靠 - 优化后的健康检查机制

bash run.sh

docker stop comfyui-pure

docker logs -f comfyui-pure

docker exec -it comfyui-pure /bin/bash

• flux2_dev_fp8mixed.safetensors (33.02 GB)

  • 位置: data/models/checkpoints/ 和 data/models/diffusion_models/
  • 说明: Flux2 主扩散模型，FP8 混合精度版本
  • 用途: ComfyUI CheckpointLoaderSimple 节点加载

• flux1-dev-fp8.safetensors (16.06 GB)

  • 位置: data/models/checkpoints/ 和 data/models/diffusion_models/
  • 说明: Flux1 开发版本，FP8 精度
  • 用途: 备用扩散模型

• flux2-vae.safetensors (320.64 MB)

  • 位置: data/models/vae/
  • 说明: Flux2 专用 VAE 编码器
  • 用途: VAE Loader 节点加载

• ae.safetensors (319.77 MB)

  • 位置: data/models/vae/
  • 说明: 备用自编码器模型
  • 用途: 替代 VAE 编码器

• mistral_3_small_flux2_fp8.safetensors (16.8 GB)
  • 位置: data/models/text_encoders/
  • 说明: Flux2 专用 Mistral 文本编码器
  • 用途: CLIP Text Encode 节点加载

• RealESRGAN_x4plus.pth (63.94 MB)
  • 位置: data/models/upscale_models/
  • 说明: Real-ESRGAN 4倍超分模型
  • 用途: Upscale Model Loader 节点加载

在 ComfyUI Web 界面中：

1. CheckpointLoaderSimple 节点：选择 flux2_dev_fp8mixed.safetensors
2. VAELoader 节点：选择 flux2-vae.safetensors
3. CLIP Text Encode 节点：自动使用 Mistral 文本编码器
4. Upscale Model Loader 节点：选择 RealESRGAN_x4plus.pth

• 总大小: ~83 GB
• 下载来源: 使用国内镜像加速下载
• 自动安装: 运行 ./run.sh 时自动检查并下载缺失模型

所有重要数据都保存在 data/ 目录中：

目录	说明	备份重要性
data/models/checkpoints/	扩散模型 (供 ComfyUI 加载)	重要
data/models/vae/	VAE 编码器模型	重要
data/models/text_encoders/	文本编码器模型	重要
data/models/upscale_models/	超分辨率模型	中等
data/output/	生成结果	重要
data/user/	用户配置	中等
data/input/	输入文件	中等
data/temp/	临时文件	可忽略

1. GPU 检测失败

# 检查 NVIDIA Docker
nvidia-docker run --rm nvidia/cuda:11.0-base nvidia-smi

# 如果失败，系统会自动使用 CPU 模式

2. 端口占用

# 检查端口使用
netstat -tlnp | grep 8188

# 修改 run.sh 中的端口映射

3. 重置环境

# 停止容器
docker stop comfyui-pure

# 删除容器
docker rm comfyui-pure

# 清理镜像
docker rmi comfyui:latest

# 重新启动
bash run.sh

• 官方文档: ComfyUI GitHub
• Docker 官网: docker.com
• 问题反馈: 查看容器日志 docker logs comfyui-pure

---

部署完成！ComfyUI 纯净版本现在可以在 http://localhost:8188 访问。