便攜包

便攜包是 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