怎样在Windows上部署ComfyUI

Windows 上部署 ComfyUI 的简明步骤
一 准备与环境要求

• 操作系统与硬件
• 推荐 Windows 10/11 64 位；内存至少 8GB，建议 16GB+。
• 显卡优先 NVIDIA（支持 CUDA）。显存建议 ≥8GB（流畅跑 SDXL），最低 4–6GB 可跑基础模型（分辨率与模型需保守）。
• 基础软件
• 安装 Python 3.10（建议通过 Anaconda/Miniconda 管理环境）。
• 安装 Git（用于拉取仓库/模型）。
• 更新 NVIDIA 显卡驱动（确保与 CUDA 版本匹配）。
• 可选：安装 CUDA Toolkit 12.x 与 cuDNN（多数情况下 PyTorch 自带 CUDA 运行库即可，无需单独装 cuDNN）。

二 两种安装方式

• 方式 A 官方便携包（最快，适合新手）

1) 从官方 GitHub Releases 下载 Windows 便携包（文件名类似：ComfyUI_windows_portable_nvidia_cu118_or_cpu.7z），用 7-Zip 解压到不含中文与空格的路径。
2) 下载模型放到目录：ComfyUImodelscheckpoints（如 DreamShaper、SDXL 等）。
3) 双击启动：有 NVIDIA GPU 用 run_nvidia_gpu.bat，无 GPU 用 run_cpu.bat；首次会自动打开浏览器访问 http://127.0.0.1:8188。
4) 更新：在 update 目录执行 update_comfyui.bat。

• 方式 B 源码环境（更灵活，便于定制与开发）

1) 克隆仓库：git clone https://github.com/comfyanonymous/ComfyUI.git
2) 创建并激活环境（示例）：conda create -n comfyui python=3.10 然后 conda activate comfyui
3) 安装依赖：pip install -r requirements.txt
4) 启动服务：python main.py（默认端口 8188，浏览器访问 http://127.0.0.1:8188）。
三 模型放置与共享

• 常用目录
• 大模型（Checkpoint）：models/checkpoints
• VAE：models/vae
• LoRA：models/loras
• 与 AUTOMATIC1111 WebUI 共享模型
• 将 extra_model_paths.yaml.example 重命名为 extra_model_paths.yaml。
• 修改其中的 base_path 指向你的 WebUI 根目录（如：E:/sd-webui-aki-v4.8/），保存并重启 ComfyUI。

四 启动参数与性能优化

• 常用启动参数（示例）
• 指定监听与端口：python main.py --listen 0.0.0.0 --port 8188
• 半精度加速：python main.py --force-fp16
• CPU 运行（无 NVIDIA GPU）：python main.py --cpu
• 显存模式（按显存选择）：--highvram / --normalvram / --lowvram / --novram
• 加速组件（可选，提升生成速度与显存利用）
• 安装 xformers：pip install -U xformers --index-url https://download.pytorch.org/whl/cu124
• 安装 ONNX Runtime GPU（与 CUDA 12.x 匹配，如 1.20.x）：pip install onnxruntime-gpu==1.20.0 -i https://pypi.tuna.tsinghua.edu.cn/simple
• 若使用便携包，也可在启动器或环境中按需补充上述加速包。

五 常见问题与快速排查

• 启动报错或卡在加载
• 确认 NVIDIA 驱动为最新；显存不足时改用 --lowvram 或降低分辨率/步数。
• 模型未放对目录（应在 models/checkpoints），或模型文件损坏。
• 浏览器打不开页面
• 默认端口 8188，若被占用可改用 --port 8189；或关闭占用该端口的进程后再启动。
• CUDA 不可用
• 在 Python 中验证：python -c "import torch; print(torch.cuda.is_available())" 应为 True；若为 False，重装与 CUDA 匹配的 PyTorch（如 cu124）。
• 想用 AMD 或 Intel 显卡
• AMD 在 Windows 上体验受限，官方更推荐 Linux；Intel 显卡建议 CPU 模式运行（速度较慢）。