便携包

便携包是 ComfyUI 官方 GitHub 开源版本提供的自包含 Windows 包。下载、解压、运行即可，不需要把 Python 安装到系统环境里。

这篇文档讲的是 GitHub Windows Portable Package，不是 ComfyUI Desktop。Desktop 有自己的安装器、应用管理目录和更新方式。如果你用的是 Desktop，请看 如何安装 ComfyUI Desktop。

ComfyUI 官方发布更新很频繁，请始终以 GitHub releases 页面上的最新资产和说明为准。

第 1 步：下载

打开 ComfyUI GitHub releases 页面，按你的硬件选择便携包。

当前 release 资产通常是这些命名模式：

• ComfyUI_windows_portable_nvidia.7z - NVIDIA GPU 默认包
• ComfyUI_windows_portable_nvidia_cu126.7z - CUDA 12.6 包，适合部分较旧 NVIDIA GPU
• ComfyUI_windows_portable_amd.7z - AMD Windows 便携包，如果当前 release 提供
• ComfyUI_windows_portable_intel.7z - Intel Windows 实验性便携包，如果当前 release 提供

文件通常约 1-2 GB。

第 2 步：解压

1. 右键下载的 .7z 文件。
2. 选择 7-Zip -> Extract to "ComfyUI_windows_portable/"。
3. 等待解压完成。

如果解压失败：右键 .7z 文件 -> 属性 -> 勾选底部的 解除锁定 -> 应用，然后重新解压。

路径建议：

• 选择有足够空间的位置，模型、输出图片和自定义节点都会占用磁盘。
• 尽量避免路径里有空格和特殊字符。
• 不要解压到 C:\Program Files、C:\Windows 或 C:\ 根目录。
• 不要用管理员身份运行 ComfyUI，除非你明确把它放在受保护的系统路径里。
• 路径尽量短，避免 Windows 长路径问题。

第 3 步：下载模型

生成图片前，至少需要一个 checkpoint 模型。把模型放到：

ComfyUI_windows_portable/
+-- ComfyUI/
    +-- models/
        +-- checkpoints/    <- 把 .safetensors 放这里

常见入门模型：

• SD 1.5 - 快，显存要求低，社区资源多
• SDXL - 质量更高，需要更多显存
• Flux Schnell - 更新一代模型，需要更多显存和磁盘空间

更多模型位置请看 下载模型。

第 4 步：运行

在解压后的便携包根目录里双击对应的 .bat 文件。

如果你下载的是 AMD 或 Intel 专用便携包，请以那个包里自带的 .bat 文件和说明为准。不要直接复制另一个便携包的命令。

启动后会打开控制台窗口。看到下面这行时：

Starting server
To see the GUI go to: http://127.0.0.1:8188

在浏览器打开 **http://127.0.0.1:8188**。

目录结构

你的文件夹名字不一定叫 ComfyUI_windows_portable。关键是相对关系：python_embeded、ComfyUI、update 和 run_*.bat 是同级目录。

ComfyUI_windows_portable/
+-- python_embeded/          # 这个便携包自带的 Python
+-- update/                  # 更新脚本
|   +-- update_comfyui.bat
|   +-- update_comfyui_stable.bat
+-- ComfyUI/
|   +-- models/
|   |   +-- checkpoints/
|   |   +-- loras/
|   |   +-- vae/
|   |   +-- controlnet/
|   |   +-- upscale_models/
|   |   +-- clip/
|   +-- custom_nodes/
|   +-- input/
|   +-- output/
|   +-- extra_model_paths.yaml
+-- run_nvidia_gpu.bat
+-- run_cpu.bat

如果文档里让你运行 .\python_embeded\python.exe，意思是从这个便携包根目录运行，不是从 ComfyUI\ 子目录里运行。

更新

更新便携包：

1. 打开便携包里的 update/ 文件夹。
2. 双击 update_comfyui.bat 或 update_comfyui_stable.bat。
3. 等待更新完成。
4. 重启 ComfyUI。

依赖更新脚本要谨慎使用。它可能重装大量 Python 包，也可能影响依赖特定版本的自定义节点。更新失败、前端异常或需要回滚时，请看 ComfyUI 无法更新或需要降级。

添加启动参数

要添加 --lowvram 等参数，用文本编辑器打开 .bat 文件，在 main.py 那一行后面加参数：

.\python_embeded\python.exe -s ComfyUI\main.py --lowvram

常见参数：

下一步

• 生成第一张图片
• 下载模型
• Safetensors 应该放在哪里
• 安装自定义节点
• ComfyUI 无法更新
• 常见问题排查

参考来源

• ComfyUI GitHub releases
• ComfyUI GitHub README