✨ 适合上手学习及 AIGC 创作者！

本项目是一个基于 ComfyUI v0.3.75 的 Z-Image Turbo 工作流一键部署包，集成了完整的环境配置和预置模型，让您能够快速体验 AIGC 创作的魅力。

• 操作系统: Linux (基于 Debian)
• Python: 3.11.11
• PyTorch: 2.9.1
• CUDA: 13.0
• cuDNN: 9

• 开发工具:

  • code-server (Web 版 VSCode)
  • Git & Git LFS
  • SSH 服务

• VSCode 插件:

  • cnbcool.cnb-welcome
  • redhat.vscode-yaml
  • dbaeumer.vscode-eslint
  • ms-python.python
  • ms-toolsai.jupyter

• AI 环境:

  • JupyterLab
  • IPython Kernel (cnb-ai-kernel)

• ComfyUI_essentials: 基础功能增强插件
• ComfyUI-Crystools: Crystian 工具集

项目已配置以下模型文件，可直接使用：

• z_image_turbo_bf16.safetensors (11.46 GB) - Z-Image Turbo 主模型

• qwen_3_4b.safetensors (7.49 GB) - Qwen 3.4B 文本编码器

• ae.safetensors (319.77 MB) - 自动编码器

1. Fork 本仓库到您的账号
2. 进入 CloudStudio 平台
3. 导入项目并选择 GPU 运行环境
4. 自动启动配置：
   • ComfyUI 在 8686 端口启动
   • VSCode 开发环境自动配置
   • GPU 加速支持 (需选择 GPU 运行环境)
   • 1 小时保活时间

部署完成后，系统会自动执行环境检查：

• ✅ GPU 状态检测 (nvidia-smi)
• ✅ 模型文件验证
• ✅ 工作流文件检查
• ✅ ComfyUI 运行状态确认

• ComfyUI Web 界面: http://<your-domain>:8686
• VSCode 编辑器: 通过 CloudStudio 提供的链接访问

cd /workspace
docker build -t comfyui-z-image .

docker run -d -p 8188:8188 -v $(pwd):/workspace --name comfyui-container comfyui-z-image

• ComfyUI: http://localhost:8188

• 更多工作流示例: https://comfyanonymous.github.io/ComfyUI_examples/z_image/

• CloudStudio 环境后台保持 1 小时
• 建议不使用时手动关闭以节省资源
• GPU 环境资源消耗较高，请合理使用

/workspace/
├── .cnb.yml                 # CloudStudio 部署配置
├── Dockerfile                 # 容器配置文件
├── README.md                 # 项目说明文档
├── start-comfyui.sh         # ComfyUI 启动脚本
├── download_models.sh       # 模型下载脚本
├── download_workflows.sh    # 工作流下载脚本
├── assets/                  # 资源文件
├── models/                  # 模型文件目录
│   ├── diffusion_models/    # 扩散模型
│   │   └── z_image_turbo_bf16.safetensors
│   ├── text_encoders/       # 文本编码器
│   │   └── qwen_3_4b.safetensors
│   ├── vae/                 # VAE 模型
│   │   └── ae.safetensors
│   └── README.md            # 模型说明
└── workflows/               # ComfyUI 工作流
    └── *.json              # 工作流配置文件

• 运行标签: cnb:arch:amd64:gpu
• Docker 镜像: docker.cnb.cool/zyyh116/comfyui-zoom:latest
• 端口配置: 8686 (ComfyUI)

• VSCode: 自动启用，支持在线开发
• Docker: 内置容器支持
• 保活时间: 3600000ms (1小时)
• 启动方式: 后台守护进程

在 CloudStudio VSCode 终端中执行：

cd /app/ComfyUI/custom_nodes/
git clone <插件仓库地址>
cd <插件目录>
pip install -r requirements.txt

如需 ComfyUI Manager 管理插件，可修改 Dockerfile 取消注释相关行并重新构建镜像。

如需本地调试，可使用 docker logs comfyui-container 查看运行日志，或通过 docker exec -it comfyui-container bash 进入容器。

• ComfyUI 官方文档
• Z-Image Turbo 工作流

---

提示: 本项目专为 AIGC 创作者和学习者设计，提供开箱即用的 ComfyUI 环境。如有问题或建议，欢迎提交 Issue 或 PR！