ComfyUI安裝教程:輕鬆入門AI圖像生成,打造你的專屬工作流
歡迎來到ComfyUI的奇妙世界!如果您正在尋找一個功能強大、高度靈活且性能卓越的AI圖像生成工具,那麼ComfyUI無疑是您的理想選擇。它以其獨特的節點式工作流(Node-based Workflow)設計,讓用戶能夠以前所未有的自由度定製和優化圖像生成過程。本篇ComfyUI安裝教程將為您詳細介紹如何在不同操作系統下,從零開始搭建ComfyUI環境,讓您快速掌握AI繪畫的核心技術。
無論您是AI繪畫新手,還是經驗豐富的Stable Diffusion老用戶,ComfyUI都能為您帶來全新的體驗。我們承諾,通過這份詳盡的教程,您將能夠順利完成ComfyUI的安裝與配置,並為接下來的創意之旅做好充分準備。
安裝ComfyUI前的準備:確保你的系統就緒
在開始ComfyUI安裝之前,我們需要確保您的系統滿足基本的硬體和軟體要求。一個良好的準備工作能讓安裝過程事半功倍,避免不必要的麻煩。
1. 硬體要求:GPU是AI繪畫的核心
- 圖形處理器(GPU): ComfyUI對GPU的性能依賴性極高。強烈建議您擁有一塊支持CUDA的NVIDIA顯卡。顯存(VRAM)至少8GB,12GB及以上則更加流暢,能處理更複雜的模型和更高解析度的圖像。例如,RTX 3060/3080/4090等。
- 處理器(CPU): 現代多核CPU即可,對性能要求不高,但會影響載入速度。
- 內存(RAM): 建議16GB或以上,32GB能提供更好的體驗,尤其是在處理大型模型或多任務時。
- 存儲空間: 至少預留100GB的SSD空間。ComfyUI本身不大,但AI模型文件(如Checkpoint、LoRA、ControlNet等)非常龐大,且會持續增加。SSD能顯著提高載入和生成速度。
2. 操作系統:Windows、Linux與macOS均可
- Windows: Windows 10/11是主流選擇,安裝相對簡單。
- Linux: Ubuntu、CentOS等發行版均可,適合熟悉命令行操作的用戶。通常性能表現更優。
- macOS: 針對配備Apple Silicon(M系列晶元)的Mac電腦,ComfyUI提供了Metal後端支持,性能表現不俗。
3. 必備軟體:Python與Git
-
Python: ComfyUI基於Python運行。推薦安裝Python 3.10.x 或 3.11.x 版本。
- 如何檢查Python版本: 打開命令行(Windows: `cmd` 或 PowerShell;Linux/macOS: 終端),輸入 `python --version` 或 `python3 --version`。
- 如何安裝Python: 訪問Python官方網站 (https://www.python.org/downloads/),下載對應您操作系統的安裝包。在Windows安裝時,務必勾選「Add Python to PATH」選項。
-
Git: 用於從GitHub克隆ComfyUI項目代碼,並方便後續更新。
- 如何檢查Git版本: 打開命令行,輸入 `git --version`。
- 如何安裝Git: 訪問Git官方網站 (https://git-scm.com/downloads),下載並安裝。Windows用戶在安裝過程中保持默認選項即可。
4. 驅動程序:NVIDIA CUDA(僅限NVIDIA用戶)
-
確保您的NVIDIA顯卡驅動程序是最新版本,並已正確安裝CUDA工具包。通常,最新的顯卡驅動會包含最新的CUDA運行時庫。
- 如何更新驅動: 訪問NVIDIA官方網站 (https://www.nvidia.cn/drivers/),選擇您的顯卡型號下載並安裝最新的驅動程序。
ComfyUI安裝教程核心步驟:選擇你的安裝方式
ComfyUI提供了多種安裝方式,您可以根據自己的操作系統、習慣和需求選擇最適合的一種。
方式一:最推薦 - Git克隆安裝(Windows/Linux)
這是官方推薦的安裝方式,優點是能方便地獲取最新代碼並進行更新,環境配置靈活。
-
創建安裝目錄:
在您希望安裝ComfyUI的硬碟上創建一個新文件夾,例如 `D:ComfyUI` 或 `~/ComfyUI`。
-
打開命令行或終端:
導航到您剛剛創建的文件夾。
在Windows上,您可以在文件資源管理器中打開該文件夾,然後在地址欄輸入 `cmd` 或 `powershell` 並回車。
在Linux/macOS上,使用 `cd` 命令導航:`cd /path/to/your/ComfyUI_folder` -
克隆ComfyUI倉庫:
在命令行中執行以下命令,將ComfyUI的代碼下載到當前目錄:
git clone https://github.com/comfyanonymous/ComfyUI.git -
進入ComfyUI目錄:
代碼下載完成後,會生成一個名為 `ComfyUI` 的子文件夾。進入該文件夾:
cd ComfyUI -
安裝依賴:
ComfyUI依賴於一些Python庫。根據您的GPU類型選擇對應的安裝命令:
-
對於NVIDIA顯卡用戶(推薦):
pip install -r requirements.txt --extra-index-url https://download.pytorch.org/whl/cu121或根據您的CUDA版本(例如cu118):
pip install -r requirements.txt --extra-index-url https://download.pytorch.org/whl/cu118
如果不確定CUDA版本,可以嘗試不帶 `--extra-index-url` 參數的命令,它會嘗試安裝CPU或默認GPU版本:
pip install -r requirements.txt -
對於AMD顯卡用戶(Linux):
pip install -r requirements.txt --extra-index-url https://download.pytorch.org/whl/rocm5.7 -
對於Apple Silicon (M系列) Mac用戶:
pip install -r requirements.txt --extra-index-url https://download.pytorch.org/whl/nightly/cpuComfyUI會自動檢測並使用Metal後端。
-
對於純CPU運行(不推薦,速度極慢):
pip install -r requirements.txt --extra-index-url https://download.pytorch.org/whl/cpu
注意: 如果您遇到 `pip` 命令許可權問題,可以嘗試 `python -m pip install ...`。
-
對於NVIDIA顯卡用戶(推薦):
-
運行ComfyUI:
安裝完成後,您就可以啟動ComfyUI了。在 `ComfyUI` 文件夾內執行:
python main.py第一次運行可能需要下載一些必要的組件。成功啟動后,ComfyUI會在您的瀏覽器中自動打開(通常是 `http://127.0.0.1:8188`)。
方式二:便捷之選 - 獨立便攜包安裝(Windows)
此方式適合不想折騰Python環境的用戶。ComfyUI官方或第三方會提供預打包的便攜版,包含了Python環境和所有依賴。
-
下載便攜包:
訪問ComfyUI的GitHub發布頁面或相關社區提供的下載鏈接,尋找帶有「portable」字樣的壓縮包(通常是`.7z`或`.zip`格式)。
例如:`ComfyUI_windows_portable_nvidia_cu121_and_cpu.7z` -
解壓文件:
將下載的壓縮包解壓到您希望安裝ComfyUI的目錄,例如 `D:ComfyUI_Portable`。
注意: 避免解壓到路徑中包含中文或特殊字元的目錄,這可能導致一些未知問題。 -
運行ComfyUI:
進入解壓后的文件夾,您會找到一個名為 `run_nvidia_gpu.bat` (NVIDIA用戶) 或 `run_cpu.bat` (CPU用戶) 的批處理文件。雙擊執行即可。
如果是AMD顯卡或MAC用戶,可能會有對應的 `run_amd_gpu.bat` 或 `run_mac_gpu.sh` 等腳本。優勢: 安裝簡單,無需手動配置Python和Git。
劣勢: 便攜包可能不會及時更新到ComfyUI的最新版本,且對自定義配置的靈活性較低。
方式三:進階 - Conda/Miniconda環境安裝(通用)
對於需要管理多個Python項目環境的用戶,使用Conda或Miniconda創建獨立的ComfyUI環境是一個非常好的選擇。
-
安裝Miniconda/Anaconda:
如果尚未安裝,請訪問Miniconda (https://docs.conda.io/en/latest/miniconda.html) 或 Anaconda 官網下載並安裝。
-
創建並激活Conda環境:
打開Conda命令行(Anaconda Prompt)或終端,執行以下命令:
conda create -n comfyui python=3.10conda activate comfyui -
克隆ComfyUI倉庫並安裝依賴:
激活環境后,接下來的步驟與「Git克隆安裝」方式的步驟3、4、5、6相同。
例如:git clone https://github.com/comfyanonymous/ComfyUI.gitcd ComfyUIpip install -r requirements.txt --extra-index-url https://download.pytorch.org/whl/cu121python main.py優勢: 環境隔離,避免不同項目間的Python庫衝突;方便管理和切換版本。
方式四:macOS安裝(針對M系列晶元)
macOS用戶,特別是M系列晶元用戶,ComfyUI通過PyTorch的MPS (Metal Performance Shaders) 後端提供原生加速。
-
安裝Homebrew(如果未安裝):
Homebrew是macOS的包管理器,非常方便。打開終端執行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" -
安裝Python和Git:
通過Homebrew安裝最新版本的Python和Git:
brew install python git注意: Homebrew安裝的Python版本通常是最新版,可能與系統自帶的Python共存。建議使用 `python3` 命令來調用Homebrew安裝的Python。
-
克隆ComfyUI倉庫並安裝依賴:
與「Git克隆安裝」方式類似,但安裝Python依賴時,請使用針對CPU/Metal的指令:
git clone https://github.com/comfyanonymous/ComfyUI.gitcd ComfyUIpip install -r requirements.txt --extra-index-url https://download.pytorch.org/whl/nightly/cpupython3 main.pyComfyUI會自動檢測並使用Metal加速。
首次運行與模型下載:AI創作的第一步
成功安裝ComfyUI后,還需要下載必要的AI模型才能開始生成圖像。
1. 啟動ComfyUI
無論您選擇哪種安裝方式,最終都是通過執行 `python main.py`(或便攜包中的批處理文件)來啟動ComfyUI。啟動后,請耐心等待,直到命令行窗口顯示 `http://127.0.0.1:8188` 等字樣,這表示ComfyUI已在您的本地瀏覽器中打開。
2. 下載基礎模型
ComfyUI本身不包含任何AI模型,您需要手動下載。如果您之前使用過Stable Diffusion WebUI,那麼恭喜您,ComfyUI可以直接使用WebUI的模型文件!
-
Checkpoint模型(大模型):
這是AI生成圖像的基礎模型,通常以 `.safetensors` 或 `.ckpt` 為後綴。
存放路徑: 將下載的模型文件放到 `ComfyUI/models/checkpoints/` 目錄下。
推薦下載: civitai.com, huggingface.co 等網站。例如,SDXL系列的 `sd_xl_base_1.0.safetensors` 或 `sd_xl_refiner_1.0.safetensors` 是很好的起點。 -
VAE模型:
用於解碼生成圖像的細節和色彩,通常與Checkpoint模型配套使用,後綴為 `.safetensors` 或 `.vae.pt`。
存放路徑: `ComfyUI/models/vae/` 目錄下。 -
LoRA模型:
用於微調圖像風格或生成特定對象,後綴為 `.safetensors`。
存放路徑: `ComfyUI/models/loras/` 目錄下。 -
ControlNet模型:
用於精確控制圖像構圖、姿態等,需要與對應的預處理器一起使用。
存放路徑: `ComfyUI/models/controlnet/` 目錄下。
溫馨提示: 模型文件通常非常大(幾GB甚至幾十GB),請確保您的網路環境良好且硬碟空間充足。
ComfyUI進階:安裝自定義節點(Custom Nodes)
ComfyUI的強大之處還在於其豐富的自定義節點生態。這些節點擴展了ComfyUI的功能,例如更強大的圖像處理、視頻生成、特定模型的支持等。
-
安裝ComfyUI Manager(推薦):
ComfyUI Manager是一個非常方便的自定義節點,它能幫助您圖形化地安裝、管理和更新其他自定義節點。
- 打開ComfyUI安裝目錄下的 `ComfyUI/custom_nodes/` 文件夾。
-
在該文件夾內打開命令行/終端,執行:
git clone https://github.com/ltdrdata/ComfyUI-Manager.git - 重啟ComfyUI(關閉命令行窗口,再執行 `python main.py`)。
- 重啟后,您會在ComfyUI界面的右側看到一個「Manager」按鈕。點擊它即可進入管理器界面,輕鬆搜索和安裝其他自定義節點。
-
手動安裝自定義節點(如果管理器不支持或您偏愛手動):
大多數自定義節點項目的GitHub頁面都會提供詳細的安裝指南。通常步驟如下:
-
在 `ComfyUI/custom_nodes/` 目錄下,使用 `git clone` 命令克隆目標節點的倉庫。
例如:`git clone https://github.com/someuser/ComfyUI-AwesomeNode.git` -
進入新克隆的節點文件夾(例如 `ComfyUI-AwesomeNode`),查看是否有 `requirements.txt` 文件。如果有,執行:
以安裝該節點所需的額外Python依賴。pip install -r requirements.txt - 重啟ComfyUI。
-
在 `ComfyUI/custom_nodes/` 目錄下,使用 `git clone` 命令克隆目標節點的倉庫。
ComfyUI更新與維護
由於ComfyUI社區活躍,項目更新頻繁,定期更新ComfyUI是獲取新功能和修復bug的好習慣。
-
更新ComfyUI核心:
如果您是Git克隆安裝,只需在 `ComfyUI` 目錄下打開命令行/終端,執行:
git pull這會拉取最新的代碼。之後可能還需要重新運行依賴安裝命令 `pip install -r requirements.txt` 以確保所有依賴都是最新版本。
-
更新自定義節點:
如果安裝了ComfyUI Manager,直接通過管理器進行更新。
如果是手動安裝的節點,則進入每個節點各自的文件夾,執行 `git pull`。 -
便攜包更新:
便攜包通常需要下載新的完整包進行替換,無法像Git一樣進行增量更新。
常見問題(FAQ)
1. 如何解決ComfyUI啟動報錯,提示缺少CUDA或顯存不足?
這通常意味著您的NVIDIA顯卡驅動未正確安裝、CUDA版本不兼容或顯存不足。請檢查:
- 確保已安裝最新的NVIDIA顯卡驅動。
- 在安裝ComfyUI依賴時,確認使用了正確的 ` --extra-index-url https://download.pytorch.org/whl/cuXXX ` 參數,匹配您的CUDA版本。
- 嘗試降低生成圖像的解析度或批次大小,或嘗試使用更小的Checkpoint模型,以減少顯存佔用。
- 在Windows上,確保您的系統電源模式設置為「高性能」。
2. 為何我的ComfyUI界面顯示空白或載入緩慢?
如果ComfyUI啟動后瀏覽器界面顯示空白或載入非常慢,可能有以下原因:
- 瀏覽器緩存問題: 嘗試清除瀏覽器緩存,或更換一個瀏覽器訪問 `http://127.0.0.1:8188`。
- 埠佔用: 默認埠 `8188` 可能被其他程序佔用。您可以在啟動ComfyUI時指定一個不同的埠,例如 `python main.py --port 8189`。
- 模型未下載: 如果沒有下載任何Checkpoint模型,ComfyUI可能無法正確初始化工作流,導致界面異常。
- 依賴未完全安裝: 確保 `pip install -r requirements.txt` 命令執行成功,且沒有報錯。
3. 如何將Stable Diffusion WebUI的模型導入ComfyUI?
非常簡單!ComfyUI和Stable Diffusion WebUI共享大部分模型文件格式。
- 找到WebUI的 `stable-diffusion-webui/models/Stable-diffusion` 目錄下的Checkpoint模型,將其複製到ComfyUI的 `ComfyUI/models/checkpoints` 目錄下。
- 將WebUI的 `stable-diffusion-webui/models/VAE` 目錄下的VAE模型複製到ComfyUI的 `ComfyUI/models/vae` 目錄下。
- LoRA、ControlNet等模型也同樣,找到WebUI對應的模型目錄,複製到ComfyUI相應的 `ComfyUI/models/loras` 或 `ComfyUI/models/controlnet` 目錄下即可。
4. ComfyUI安裝后如何安裝ControlNet模型?
ControlNet模型需要下載到 `ComfyUI/models/controlnet/` 目錄下。此外,ControlNet通常還需要配套的預處理器(Preprocessors)。
- 模型文件: 從Civitai或HuggingFace下載 `.safetensors` 格式的ControlNet模型,放入 `ComfyUI/models/controlnet/`。
- 預處理器: 大多數ControlNet預處理器是作為自定義節點的一部分提供的。安裝 `ComfyUI-Manager` 后,可以通過它來安裝常用的ControlNet預處理器節點(例如 `ComfyUI_IPAdapter_plus` 或 `ComfyUI_ControlNet_Aux` 等)。安裝完成後,重啟ComfyUI即可在節點列表中找到它們。
5. ComfyUI和Stable Diffusion WebUI有什麼區別?為何我需要ComfyUI?
ComfyUI和Stable Diffusion WebUI是兩種不同的AI繪圖前端,各有側重:
- ComfyUI: 採用節點式工作流,提供了極高的靈活性和透明度。用戶可以自由組合、連接不同的模塊(如載入模型、文本編碼、採樣器、VAE解碼等),構建複雜的生成流程。其優點是性能通常優於WebUI(尤其是在低顯存環境下),資源佔用更少,適合進階用戶和科研。缺點是初期學習曲線相對陡峭。
- Stable Diffusion WebUI (Automatic1111/Forge): 提供直觀的Web界面,功能集成度高,操作簡便,插件生態豐富。優點是入門簡單,各種功能一應俱全。缺點是性能不如ComfyUI精簡,且在構建複雜工作流時,其固定的UI框架可能限制創意。
結語
通過本篇詳盡的ComfyUI安裝教程,相信您已經成功地在自己的電腦上搭建起了ComfyUI環境,並對ComfyUI的基本運作和模型管理有了初步了解。從現在開始,您就可以踏上ComfyUI的創意之旅了!
ComfyUI的強大之處在於它的可定製性和無限擴展性。不要害怕嘗試各種節點組合,探索不同的工作流。隨著您對ComfyUI的深入了解,您會發現它能幫助您實現前所未有的AI圖像生成效果。祝您創作愉快,盡情釋放您的無限創意!

