快速部署 Windows 版 ComfyUI 的核心在于使用官方整合包或手动安装便携版,因为这两种方式不需要复杂的 Python 环境配置,且自带了所需的依赖库。以下是最高效的部署步骤:
这是 ComfyUI 官方提供的 Windows 整合包,自带 Python 环境和 CUDA 支持,解压即用。
前往 ComfyUI 的 GitHub 发布页面(Releases),找到最新的版本,下载名为 ComfyUI_windows_portable_nvidia.7z 的文件(适用于 NVIDIA 显卡)。
使用 7-Zip 或 WinRAR 解压下载的文件。注意:建议解压到纯英文路径下,避免后续插件安装出现路径错误。
进入解压后的文件夹,双击运行 run_nvidia_gpu.bat。
http://127.0.0.1:8188,即可开始使用。如果你希望后续能通过 Git 更新,或者需要更精细的控制,可以使用官方提供的 update 脚本进行安装。
打开 PowerShell 或 CMD,执行以下命令:
# 克隆项目
git clone https://github.com/comfyanonymous/ComfyUI
cd ComfyUI
# 运行便携式启动脚本(会自动下载 Python 嵌入版和依赖)
python main.py这种方式首次运行会自动下载所需文件,速度稍慢于方案一。
如果你不熟悉英文界面或希望自带大量常用插件,可以使用国内开发者(如秋叶)打包的整合包(通常发布在 Bilibili 或 Hugging Face 上)。
启动器.exe -> 点击“一键启动”。部署成功只是第一步,为了让体验更流畅,建议进行以下配置:
ComfyUI 不会自动下载大模型,你需要将模型文件手动放入指定文件夹:
ComfyUI\models\checkpointsComfyUI\models\lorasComfyUI\models\vae如果启动时遇到显存不足(OOM),可以编辑启动脚本(run_nvidia_gpu.bat)或启动命令,添加参数:
--lowvram:为低显存(如 6G/8G)显卡启用优化模式。--precision full --force-fp32:解决某些显卡的精度问题(慎用,可能会变慢)。为了更好地管理插件,建议安装 ComfyUI-Manager:
ComfyUI\custom_nodes 文件夹。git clone https://github.com/ltdrdata/ComfyUI-Manager.git| 问题 | 解决方案 |
|---|---|
| 提示缺少 DLL | 通常是 VC++ 运行库或 NVIDIA 驱动过旧,请更新显卡驱动至最新版。 |
| 启动黑屏闪退 | 查看文件夹内的 cmd 窗口报错信息。通常是 Python 依赖未安装完整,可尝试手动执行 pip install -r requirements.txt。 |
| 浏览器无法打开 | 检查防火墙设置,或手动在浏览器输入 http://127.0.0.1:8188。 |
提示:ComfyUI 的更新非常频繁,使用整合包(方案一)通常是最省心的,因为它能确保 Python 环境与其他依赖库的版本兼容性。