在實際的 AI 圖像生成領域Stable Diffusion 的 WebUI 因其直觀的圖形界面而廣受歡迎但 ComfyUI 憑借其節點式、可編程的工作流設計為高級用戶和自動化流程提供了更高的靈活性與可控性。然而其全英文界面和相對復雜的配置過程讓許多中文用戶望而卻步。一個集成了常用插件、預置了中文界面、并且能一鍵安裝的整合包無疑是降低學習門檻、快速投入創作的關鍵。本文旨在為 Windows 和 macOS 用戶提供一個清晰、完整的指南幫助你從零開始完成“秋葉 ComfyUI 整合包”的下載、安裝與基礎配置。我們將不僅關注安裝步驟更會解釋每一步的目的、可能遇到的問題及其排查方法確保你能成功運行一個支持中文界面和中文提示詞輸入的 ComfyUI 環境并理解其背后的目錄結構和關鍵配置。1. 理解 ComfyUI 整合包的價值與核心組件在開始動手之前有必要先厘清“整合包”究竟整合了什么以及為什么它能極大簡化部署過程。這有助于你在后續遇到問題時能更準確地定位原因。1.1 為什么需要整合包原生 ComfyUI 是一個純凈的框架其安裝通常需要以下步驟安裝 Python 并配置環境。通過 Git 克隆 ComfyUI 倉庫。使用 pip 安裝依賴包。手動下載各種基礎模型、VAE、LoRA 等文件并放置到正確的目錄。尋找并安裝漢化插件、管理器插件等。處理可能出現的依賴沖突、路徑錯誤等問題。這個過程對新手極不友好任何一個環節出錯都可能導致啟動失敗。“整合包”的核心價值在于它將上述所有步驟打包預先配置好了一個可立即運行的環境通常包含ComfyUI 主程序特定版本的核心框架。Python 運行時內置或指定版本的 Python避免系統環境沖突。預裝插件如漢化插件、工作流管理器、節點包等?；A模型內置了如 SD 1.5、SDXL 等常用基礎模型開箱即用。啟動腳本針對 Windows 和 macOS 優化的啟動器簡化了命令行操作?！扒锶~整合包”是社區中流傳較廣、維護相對活躍的一個版本它特別強調了中文界面的支持。1.2 整合包的關鍵目錄結構了解整合包解壓后的目錄結構對于后續管理模型、插件和工作流至關重要。一個典型的整合包目錄可能如下所示ComfyUI_Windows/ ├── ComfyUI/ # ComfyUI 主程序目錄 │ ├── web/ # Web界面相關文件 │ ├── custom_nodes/ # 插件自定義節點存放目錄 │ ├── models/ # 模型目錄常鏈接到外部 │ │ ├── checkpoints/ # 大模型如 .safetensors, .ckpt │ │ ├── loras/ # LoRA 模型 │ │ ├── vae/ # VAE 模型 │ │ └── ... # 其他類型模型 │ └── ... ├── python_embeded/ # 內置的 Python 環境Windows常見 ├── update/ # 更新腳本目錄 ├── 啟動器/ # 圖形化啟動器如有 │ └── 啟動器.exe └── run_nvidia_gpu.bat # NVIDIA GPU 啟動腳本Windows對于 macOS目錄結構類似但啟動腳本通常是.sh文件并且可能沒有內置的 Python而是依賴系統已安裝的 Python 或通過 Homebrew 管理。注意不同整合包發布者的目錄組織方式可能有差異。重點是找到ComfyUI主目錄和對應的啟動腳本。2. 環境準備與整合包獲取在下載整合包之前確保你的系統滿足基本要求并選擇正確的下載渠道。2.1 系統與硬件要求項目最低要求推薦配置操作系統Windows 10 / macOS 11 (Big Sur)Windows 11 / macOS 13 (Ventura) 或更高處理器支持 AVX2 指令集的 64 位 CPU多核處理器如 Intel i5/R5 及以上內存8 GB RAM16 GB RAM 或更多顯卡支持 DirectX 12 或 Metal APINVIDIA GPU (8GB 顯存) 或 Apple Silicon (M1)存儲空間至少 20 GB 可用空間50 GB 以上用于存放模型網絡需下載整合包約 10-20 GB及后續模型穩定的網絡連接關鍵點說明顯卡ComfyUI 在 NVIDIA GPU 上利用 CUDA 加速效果最佳。macOS 上Apple Silicon (M1/M2/M3) 芯片通過 Metal Performance Shaders (MPS) 也能獲得良好支持。Intel 集成顯卡或 AMD GPU非 ROCm性能會受限。存儲整合包本身可能已包含基礎模型如 SD 1.5體積較大。后續添加更多模型需要大量空間。Windows 特定確保已安裝最新的顯卡驅動。部分整合包依賴 Visual C Redistributable如果啟動報錯可能需要手動安裝。2.2 獲取秋葉 ComfyUI 整合包由于網絡傳播的復雜性整合包的下載鏈接可能隨時變化。請通過可靠的社區論壇、視頻教程描述欄或 GitHub 倉庫發布頁獲取最新鏈接。常見的來源包括作者發布頁在 Bilibili 等平臺搜索“秋葉 ComfyUI 整合包”關注其最新動態視頻或專欄文章。網盤分享作者通常會提供百度網盤、123 云盤等下載地址注意提取碼。開源倉庫有些整合包會托管在 GitHub 或 Gitee 上方便通過 Git 克隆或下載 Release 包。下載注意事項核對版本確認下載的是適用于你操作系統Windows 或 macOS的版本。檢查完整性大型文件下載后如果提供者給出了 SHA256 或 MD5 校驗碼建議進行校驗避免文件損壞導致安裝失敗。殺毒軟件解壓或運行啟動器時Windows Defender 或第三方殺毒軟件可能會誤報?？蓪⒄习夸浱砑拥脚懦斜砘驎簳r關閉實時防護操作后請記得恢復。3. Windows 系統安裝與啟動詳解Windows 是 ComfyUI 最主要的使用平臺整合包通常為 Windows 用戶提供了最便捷的啟動方式。3.1 解壓與目錄檢查解壓文件將下載的壓縮包通常是.7z或.zip格式解壓到一個路徑中不含中文和特殊字符的目錄。例如D:\AI_Tools\ComfyUI。這是為了避免 Python 或某些插件在處理路徑時出現編碼錯誤。檢查關鍵文件解壓后進入整合包根目錄你應該能看到類似以下結構的文件run_nvidia_gpu.bat用于 NVIDIA 顯卡的啟動腳本。run_cpu.bat僅使用 CPU 運行的腳本極慢不推薦。啟動器.exe或A啟動器.exe圖形化啟動器如果整合包包含。ComfyUI文件夾核心程序目錄。python_embeded文件夾內置的 Python 環境。3.2 使用啟動腳本運行基礎方法對于沒有圖形化啟動器的整合包或者你想了解底層命令可以直接運行批處理文件。雙擊啟動腳本根據你的顯卡雙擊run_nvidia_gpu.bat。觀察命令行窗口會彈出一個命令行窗口開始加載 ComfyUI。你會看到一系列 Python 包導入信息和模型加載日志。等待成功提示當看到類似以下輸出時表示啟動成功... Starting server To see the GUI go to: http://127.0.0.1:8188打開瀏覽器復制輸出的地址通常是http://127.0.0.1:8188到瀏覽器推薦 Chrome 或 Edge中打開。你將看到 ComfyUI 的節點式界面。關鍵參數解釋run_nvidia_gpu.bat腳本內容通常類似echo off cd /d %~dp0ComfyUI python_embeded\python.exe -s ComfyUI\main.py --listen 127.0.0.1 --port 8188 pausecd /d %~dp0ComfyUI切換到 ComfyUI 主程序目錄。python_embeded\python.exe使用內置的 Python 解釋器。-s ComfyUI\main.py運行主程序。--listen 127.0.0.1只允許本地訪問。--port 8188指定服務端口為 8188。pause運行結束后暫停方便查看錯誤信息。3.3 使用圖形化啟動器推薦如果整合包提供了“啟動器.exe”它通常會簡化以下操作一鍵啟動/停止圖形化按鈕控制。選項配置方便地修改監聽 IP、端口、顯存優化等參數。插件與模型管理可能集成插件安裝、模型下載等功能。更新提供一鍵更新 ComfyUI 或整合包本身的入口。啟動器使用步驟雙擊運行啟動器.exe。在“高級選項”或“配置”中確認或調整參數初學者可先保持默認。點擊“一鍵啟動”或“啟動”按鈕。啟動器會自動打開命令行窗口并加載完成后通常會彈出瀏覽器頁面。3.4 驗證中文界面與中文提示詞成功打開 Web 界面后需要進行兩項關鍵驗證驗證界面漢化觀察界面上的按鈕、菜單、節點名稱是否為中文。通常漢化插件如ComfyUI-CN會在啟動時加載。你可以在設置或管理器界面查看已安裝的插件。如果界面仍是英文請檢查ComfyUI/custom_nodes/目錄下是否存在類似ComfyUI-CN的文件夾并確認其已正確安裝。驗證中文提示詞輸入在界面中找到一個CLIP Text Encode節點。雙擊其上的文本輸入框嘗試直接輸入中文例如“一只可愛的貓在陽光下”。連接節點并執行工作流。如果能夠正常生成符合描述的圖像說明中文提示詞支持已生效。這通常依賴于漢化插件或底層對 CLIP 模型分詞器的擴展處理。4. macOS 系統安裝與啟動詳解macOS 下的安裝流程與 Windows 類似但細節上存在差異主要圍繞 Apple Silicon 芯片的優化和終端操作。4.1 解壓與依賴檢查解壓文件使用系統自帶的“歸檔實用工具”或第三方工具如 The Unarchiver解壓下載的整合包。同樣建議放在純英文路徑下如~/Applications/ComfyUI。檢查 Python打開“終端”Terminal輸入python3 --version。ComfyUI 需要 Python 3.10 或 3.11。如果系統沒有建議通過 Homebrew 安裝# 安裝 Homebrew如果未安裝 /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) # 使用 Homebrew 安裝 Python 3.10 brew install python3.10檢查 Git終端輸入git --version確保 Git 已安裝用于后續插件管理。未安裝可通過brew install git安裝。4.2 啟動 ComfyUImacOS 整合包通常提供.sh腳本或通過終端命令啟動。方法一使用提供的啟動腳本在終端中使用cd命令導航到整合包解壓后的目錄。cd ~/Applications/ComfyUI查找啟動腳本如run.sh或webui.sh。使用ls -la命令查看文件。賦予腳本執行權限如果需要chmod x run.sh執行腳本./run.sh或者如果腳本設計為使用 Python 3python3 run.sh具體請查看腳本內的說明或注釋。方法二直接通過 Python 啟動如果整合包沒有提供腳本或你想自定義參數可以進入ComfyUI目錄直接運行cd ~/Applications/ComfyUI/ComfyUI python3 main.py --listen 127.0.0.1 --port 8188對于 Apple Silicon (M1/M2/M3) 芯片為了啟用 GPU 加速Metal需要使用--force-fp16參數并確保 PyTorch 支持 MPS。整合包通常已配置好。一個更完整的啟動命令可能如下python3 main.py --listen --port 8188 --force-fp164.3 macOS 特定優化與問題性能在 Apple Silicon 上確保使用--force-fp16參數以利用 MPS 后端這能顯著提升生成速度。內存管理macOS 使用統一內存顯存和內存共享。如果生成高分辨率圖像時崩潰可嘗試在啟動命令中添加--medvram或--lowvram參數來優化內存使用。端口占用如果 8188 端口被占用啟動時會報錯?？梢愿鼡Q端口如--port 7860。權限問題如果遇到“Permission denied”錯誤確保你對 ComfyUI 目錄有讀寫權限并使用chmod修正腳本權限。5. 核心配置與目錄管理成功啟動只是第一步合理管理模型和插件才能讓 ComfyUI 發揮最大效用。5.1 模型文件的管理模型是 ComfyUI 的核心資產。整合包可能預置了一些模型但你需要知道如何添加新的模型。模型目錄結構所有模型都應放在ComfyUI/models/下的對應子文件夾中。這是 ComfyUI 默認的查找路徑。checkpoints/存放 Stable Diffusion 大模型文件.safetensors或.ckpt。loras/存放 LoRA 模型文件。vae/存放 VAE 模型文件。controlnet/存放 ControlNet 模型文件。upscale_models/存放超分辨率模型如 ESRGAN。clip_vision/、insightface/等其他特定功能的模型。添加新模型從 Civitai、Hugging Face 等社區下載你需要的模型文件。根據模型類型將其放入上述對應的文件夾。重啟 ComfyUI或刷新瀏覽器頁面新模型就會出現在節點的下拉列表中。使用相對路徑與符號鏈接高級如果你的模型庫很大不想復制到整合包內可以修改路徑配置在ComfyUI目錄下找到或創建extra_model_paths.yaml文件指向外部模型庫目錄。創建符號鏈接適用于 Windows 和 macOS在ComfyUI/models/checkpoints目錄下創建指向外部模型文件的符號鏈接。5.2 插件的安裝與管理插件Custom Nodes極大地擴展了 ComfyUI 的功能。整合包已預裝了一些但你可能需要更多。插件安裝方式通過管理器如果整合包安裝了ComfyUI Manager插件你可以在 Web 界面中通過它搜索、安裝、更新插件。這是最推薦的方式。手動安裝將插件的 Git 倉庫克隆到ComfyUI/custom_nodes/目錄下。cd ComfyUI/custom_nodes git clone https://github.com/作者名/插件倉庫名.git安裝依賴許多插件需要額外的 Python 包。手動安裝插件后通常需要重啟 ComfyUI它會自動安裝requirements.txt中的依賴。如果失敗可能需要手動進入插件目錄運行pip install -r requirements.txt。插件沖突與排查安裝過多插件可能導致沖突或啟動變慢。如果啟動失敗可以嘗試暫時移除最近安裝的插件文件夾。查看命令行窗口的錯誤信息通常能定位到具體是哪個插件的問題。在ComfyUI/custom_nodes目錄下有些插件可能有disabled.前綴這是禁用插件的一種方式。5.3 工作流的保存與加載你的節點布局和連接就是“工作流”。整合包通常預置了一些示例工作流.json或.png文件。保存工作流在 Web 界面中點擊“Save”按鈕可以將當前工作流保存為.json文件。加載工作流點擊“Load”按鈕選擇之前保存的.json文件即可還原整個工作流。從圖片加載ComfyUI 支持將工作流信息嵌入 PNG 圖片的元數據中。你可以直接拖拽一張由 ComfyUI 生成的、包含工作流信息的圖片到界面它會自動還原工作流。這是分享工作流的常用方式。工作流存放位置你可以將常用的工作流文件整理到一個單獨的文件夾中方便管理。加載時從該文件夾選擇即可。6. 常見問題排查與解決方案即使使用整合包也可能會遇到各種問題。以下是按現象分類的排查指南。6.1 啟動階段問題問題現象可能原因檢查與解決方案雙擊.bat或.sh后窗口閃退1. 路徑包含中文/特殊字符。2. 依賴缺失如VC運行庫。3. 腳本內部錯誤。1. 將整合包移動到純英文路徑。2. (Win) 安裝最新 Visual C Redistributable 。3. 右鍵編輯.bat文件在最后一行pause前添加以便查看錯誤信息。命令行提示python不是命令系統未安裝 Python或整合包內置 Python 路徑錯誤。1. 確認整合包python_embeded目錄存在且完整。2. (Mac) 在終端使用python3命令或通過 Homebrew 安裝 Python。提示端口8188被占用已有 ComfyUI 或其他程序占用該端口。1. 關閉正在運行的 ComfyUI 進程。2. 修改啟動腳本或命令使用其他端口如--port 7860。啟動時下載模型卡住或報網絡錯誤首次啟動需要下載一些必要文件網絡連接不穩定。1. 檢查網絡。2. 可以嘗試手動下載相關文件并放置到正確目錄需根據錯誤日志判斷文件名。3. 某些整合包提供了“離線運行”模式可查閱其說明。6.2 運行與生成階段問題問題現象可能原因檢查與解決方案點擊“Queue Prompt”后無反應或提示錯誤1. 工作流節點連接有誤。2. 缺少必要的模型。3. 節點參數設置不合理。1. 檢查節點間的連線是否正確、完整特別是從 Load Checkpoint 到 VAE Decode 的主流程。2. 確認Load Checkpoint節點選擇的模型文件確實存在于models/checkpoints目錄。3. 查看命令行窗口或瀏覽器開發者工具F12控制臺的具體報錯信息。生成圖片純黑、純灰或扭曲1. VAE 模型不匹配或缺失。2. 模型本身需要特定 VAE。3. 采樣器或步數設置極端。1. 在VAE Loader節點中為你的大模型選擇合適的 VAE。許多 SD 1.5 模型使用vae-ft-mse-840000-ema-pruned.ckpt。2. 嘗試更換不同的采樣器如 Euler a, DPM 2M Karras和步數20-30。中文提示詞不生效生成結果與輸入無關1. 漢化插件未正確加載或配置。2. 使用的 CLIP 模型對中文支持不佳。1. 確認custom_nodes目錄下有漢化插件如ComfyUI-CN且無報錯。2. 嘗試在CLIP Text Encode節點前添加一個專門的中文編碼節點如果插件提供。3. 暫時使用英文提示詞測試工作流是否正常。顯存不足Out of Memory, OOM1. 生成分辨率過高。2. 同時加載了多個大模型。3. 使用了高分辨率修復Hires. fix等耗顯存功能。1. 降低生成圖像的寬高如 512x512, 768x768。2. 使用--medvram或--lowvram參數啟動 ComfyUI犧牲速度換顯存。3. 分步進行先生成小圖再用 Upscale 節點放大。6.3 界面與插件問題問題現象可能原因檢查與解決方案界面仍然是英文漢化插件未安裝、安裝失敗或未啟用。1. 檢查custom_nodes目錄下是否存在漢化插件文件夾。2. 重啟 ComfyUI觀察啟動日志是否有插件加載錯誤。3. 嘗試通過 ComfyUI Manager 重新安裝漢化插件。安裝了新插件但在節點列表找不到1. 插件安裝失敗。2. 需要刷新瀏覽器或重啟 ComfyUI。3. 插件節點位于非默認分類下。1. 重啟 ComfyUI 并查看啟動日志是否有該插件的錯誤。2. 在瀏覽器中按CtrlF5強制刷新頁面。3. 在節點搜索框中輸入插件或節點名稱的關鍵詞。瀏覽器界面卡頓、節點拖拽不流暢1. 工作流過于復雜節點太多。2. 瀏覽器硬件加速未開啟或性能不足。1. 將復雜工作流拆分成多個部分使用“組”節點進行管理。2. 在瀏覽器設置中開啟硬件加速。3. 嘗試使用更輕量的瀏覽器或關閉其他占用資源的標簽頁。7. 生產環境建議與進階方向當你熟悉了基本操作后可以考慮以下優化和進階使用讓 ComfyUI 更穩定、高效。7.1 穩定性與維護最佳實踐定期備份工作流將重要的、調試好的工作流.json文件備份到云端或本地其他位置。插件管理不要一次性安裝大量未經驗證的插件。逐個安裝測試確保穩定后再加入生產環境。模型管理建立規范的模型庫目錄使用extra_model_paths.yaml進行統一管理避免與 ComfyUI 主程序升級沖突。版本控制如果你對整合包內的ComfyUI主程序或插件進行了自定義修改考慮使用 Git 進行版本管理。日志監控養成查看啟動和運行日志的習慣。日志是排查問題的第一手資料。可以將日志重定向到文件以便查閱# 在啟動命令后添加示例 python main.py ... comfyui.log 217.2 性能優化建議Windows (NVIDIA)在run_nvidia_gpu.bat中可以添加--force-fp16使用半精度浮點數減少顯存占用并可能加速。添加--cuda-device 0指定使用哪塊 GPU多卡情況?？紤]使用xformers如果整合包已集成以優化注意力計算。macOS (Apple Silicon)務必使用--force-fp16啟動參數以啟用 MPS 后端。如果遇到內存壓力使用--medvram。關閉不必要的后臺應用為 ComfyUI 預留更多統一內存。通用優化使用LCM或TCD等快速采樣器可以極大幅度減少生成步數4-8步。對于固定尺寸的批量生成使用Empty Latent Image節點比Load Image更高效。7.3 下一步學習方向掌握核心節點深入理解KSampler,CLIP Text Encode,VAE Decode,Load Checkpoint等核心節點的每一個參數。學習工作流設計從加載圖片、使用 ControlNet如 Canny, Depth、添加 LoRA、到后期高清修復構建復雜而可控的生成管線。探索高級插件ComfyUI Manager插件生態的入口。WAS Node Suite提供大量圖像處理、文件操作工具。Impact Pack集成了人臉識別、檢測、分割等高級功能。Efficiency Nodes優化工作流執行效率。API 調用ComfyUI 支持 WebSocket 和 HTTP API學習如何通過編程方式如 Python 腳本調用工作流實現自動化生成。自定義節點開發如果你有特定需求可以學習使用 Python 為 ComfyUI 開發自己的自定義節點。整合包解決了從零到一的部署難題但 ComfyUI 真正的力量在于其無限的可組合性。從成功運行第一個中文提示詞開始逐步構建屬于你自己的、高效穩定的 AI 圖像生成工作流才是這個工具帶來的長期價值。遇到問題時善用日志、社區搜索和模塊化測試大部分技術障礙都能被系統地解決。 秋葉ComfyUI整合包安裝指南：Windows與macOS中文AI繪畫環境部署
在實際的 AI 圖像生成領域Stable Diffusion 的 WebUI 因其直觀的圖形界面而廣受歡迎但 ComfyUI 憑借其節點式、可編程的工作流設計為高級用戶和自動化流程提供了更高的靈活性與可控性。然而其全英文界面和相對復雜的配置過程讓許多中文用戶望而卻步。一個集成了常用插件、預置了中文界面、并且能一鍵安裝的整合包無疑是降低學習門檻、快速投入創作的關鍵。本文旨在為 Windows 和 macOS 用戶提供一個清晰、完整的指南幫助你從零開始完成“秋葉 ComfyUI 整合包”的下載、安裝與基礎配置。我們將不僅關注安裝步驟更會解釋每一步的目的、可能遇到的問題及其排查方法確保你能成功運行一個支持中文界面和中文提示詞輸入的 ComfyUI 環境并理解其背后的目錄結構和關鍵配置。1. 理解 ComfyUI 整合包的價值與核心組件在開始動手之前有必要先厘清“整合包”究竟整合了什么以及為什么它能極大簡化部署過程。這有助于你在后續遇到問題時能更準確地定位原因。1.1 為什么需要整合包原生 ComfyUI 是一個純凈的框架其安裝通常需要以下步驟安裝 Python 并配置環境。通過 Git 克隆 ComfyUI 倉庫。使用 pip 安裝依賴包。手動下載各種基礎模型、VAE、LoRA 等文件并放置到正確的目錄。尋找并安裝漢化插件、管理器插件等。處理可能出現的依賴沖突、路徑錯誤等問題。這個過程對新手極不友好任何一個環節出錯都可能導致啟動失敗。“整合包”的核心價值在于它將上述所有步驟打包預先配置好了一個可立即運行的環境通常包含ComfyUI 主程序特定版本的核心框架。Python 運行時內置或指定版本的 Python避免系統環境沖突。預裝插件如漢化插件、工作流管理器、節點包等?；A模型內置了如 SD 1.5、SDXL 等常用基礎模型開箱即用。啟動腳本針對 Windows 和 macOS 優化的啟動器簡化了命令行操作?！扒锶~整合包”是社區中流傳較廣、維護相對活躍的一個版本它特別強調了中文界面的支持。1.2 整合包的關鍵目錄結構了解整合包解壓后的目錄結構對于后續管理模型、插件和工作流至關重要。一個典型的整合包目錄可能如下所示ComfyUI_Windows/ ├── ComfyUI/ # ComfyUI 主程序目錄 │ ├── web/ # Web界面相關文件 │ ├── custom_nodes/ # 插件自定義節點存放目錄 │ ├── models/ # 模型目錄常鏈接到外部 │ │ ├── checkpoints/ # 大模型如 .safetensors, .ckpt │ │ ├── loras/ # LoRA 模型 │ │ ├── vae/ # VAE 模型 │ │ └── ... # 其他類型模型 │ └── ... ├── python_embeded/ # 內置的 Python 環境Windows常見 ├── update/ # 更新腳本目錄 ├── 啟動器/ # 圖形化啟動器如有 │ └── 啟動器.exe └── run_nvidia_gpu.bat # NVIDIA GPU 啟動腳本Windows對于 macOS目錄結構類似但啟動腳本通常是.sh文件并且可能沒有內置的 Python而是依賴系統已安裝的 Python 或通過 Homebrew 管理。注意不同整合包發布者的目錄組織方式可能有差異。重點是找到ComfyUI主目錄和對應的啟動腳本。2. 環境準備與整合包獲取在下載整合包之前確保你的系統滿足基本要求并選擇正確的下載渠道。2.1 系統與硬件要求項目最低要求推薦配置操作系統Windows 10 / macOS 11 (Big Sur)Windows 11 / macOS 13 (Ventura) 或更高處理器支持 AVX2 指令集的 64 位 CPU多核處理器如 Intel i5/R5 及以上內存8 GB RAM16 GB RAM 或更多顯卡支持 DirectX 12 或 Metal APINVIDIA GPU (8GB 顯存) 或 Apple Silicon (M1)存儲空間至少 20 GB 可用空間50 GB 以上用于存放模型網絡需下載整合包約 10-20 GB及后續模型穩定的網絡連接關鍵點說明顯卡ComfyUI 在 NVIDIA GPU 上利用 CUDA 加速效果最佳。macOS 上Apple Silicon (M1/M2/M3) 芯片通過 Metal Performance Shaders (MPS) 也能獲得良好支持。Intel 集成顯卡或 AMD GPU非 ROCm性能會受限。存儲整合包本身可能已包含基礎模型如 SD 1.5體積較大。后續添加更多模型需要大量空間。Windows 特定確保已安裝最新的顯卡驅動。部分整合包依賴 Visual C Redistributable如果啟動報錯可能需要手動安裝。2.2 獲取秋葉 ComfyUI 整合包由于網絡傳播的復雜性整合包的下載鏈接可能隨時變化。請通過可靠的社區論壇、視頻教程描述欄或 GitHub 倉庫發布頁獲取最新鏈接。常見的來源包括作者發布頁在 Bilibili 等平臺搜索“秋葉 ComfyUI 整合包”關注其最新動態視頻或專欄文章。網盤分享作者通常會提供百度網盤、123 云盤等下載地址注意提取碼。開源倉庫有些整合包會托管在 GitHub 或 Gitee 上方便通過 Git 克隆或下載 Release 包。下載注意事項核對版本確認下載的是適用于你操作系統Windows 或 macOS的版本。檢查完整性大型文件下載后如果提供者給出了 SHA256 或 MD5 校驗碼建議進行校驗避免文件損壞導致安裝失敗。殺毒軟件解壓或運行啟動器時Windows Defender 或第三方殺毒軟件可能會誤報?？蓪⒄习夸浱砑拥脚懦斜砘驎簳r關閉實時防護操作后請記得恢復。3. Windows 系統安裝與啟動詳解Windows 是 ComfyUI 最主要的使用平臺整合包通常為 Windows 用戶提供了最便捷的啟動方式。3.1 解壓與目錄檢查解壓文件將下載的壓縮包通常是.7z或.zip格式解壓到一個路徑中不含中文和特殊字符的目錄。例如D:\AI_Tools\ComfyUI。這是為了避免 Python 或某些插件在處理路徑時出現編碼錯誤。檢查關鍵文件解壓后進入整合包根目錄你應該能看到類似以下結構的文件run_nvidia_gpu.bat用于 NVIDIA 顯卡的啟動腳本。run_cpu.bat僅使用 CPU 運行的腳本極慢不推薦。啟動器.exe或A啟動器.exe圖形化啟動器如果整合包包含。ComfyUI文件夾核心程序目錄。python_embeded文件夾內置的 Python 環境。3.2 使用啟動腳本運行基礎方法對于沒有圖形化啟動器的整合包或者你想了解底層命令可以直接運行批處理文件。雙擊啟動腳本根據你的顯卡雙擊run_nvidia_gpu.bat。觀察命令行窗口會彈出一個命令行窗口開始加載 ComfyUI。你會看到一系列 Python 包導入信息和模型加載日志。等待成功提示當看到類似以下輸出時表示啟動成功... Starting server To see the GUI go to: http://127.0.0.1:8188打開瀏覽器復制輸出的地址通常是http://127.0.0.1:8188到瀏覽器推薦 Chrome 或 Edge中打開。你將看到 ComfyUI 的節點式界面。關鍵參數解釋run_nvidia_gpu.bat腳本內容通常類似echo off cd /d %~dp0ComfyUI python_embeded\python.exe -s ComfyUI\main.py --listen 127.0.0.1 --port 8188 pausecd /d %~dp0ComfyUI切換到 ComfyUI 主程序目錄。python_embeded\python.exe使用內置的 Python 解釋器。-s ComfyUI\main.py運行主程序。--listen 127.0.0.1只允許本地訪問。--port 8188指定服務端口為 8188。pause運行結束后暫停方便查看錯誤信息。3.3 使用圖形化啟動器推薦如果整合包提供了“啟動器.exe”它通常會簡化以下操作一鍵啟動/停止圖形化按鈕控制。選項配置方便地修改監聽 IP、端口、顯存優化等參數。插件與模型管理可能集成插件安裝、模型下載等功能。更新提供一鍵更新 ComfyUI 或整合包本身的入口。啟動器使用步驟雙擊運行啟動器.exe。在“高級選項”或“配置”中確認或調整參數初學者可先保持默認。點擊“一鍵啟動”或“啟動”按鈕。啟動器會自動打開命令行窗口并加載完成后通常會彈出瀏覽器頁面。3.4 驗證中文界面與中文提示詞成功打開 Web 界面后需要進行兩項關鍵驗證驗證界面漢化觀察界面上的按鈕、菜單、節點名稱是否為中文。通常漢化插件如ComfyUI-CN會在啟動時加載。你可以在設置或管理器界面查看已安裝的插件。如果界面仍是英文請檢查ComfyUI/custom_nodes/目錄下是否存在類似ComfyUI-CN的文件夾并確認其已正確安裝。驗證中文提示詞輸入在界面中找到一個CLIP Text Encode節點。雙擊其上的文本輸入框嘗試直接輸入中文例如“一只可愛的貓在陽光下”。連接節點并執行工作流。如果能夠正常生成符合描述的圖像說明中文提示詞支持已生效。這通常依賴于漢化插件或底層對 CLIP 模型分詞器的擴展處理。4. macOS 系統安裝與啟動詳解macOS 下的安裝流程與 Windows 類似但細節上存在差異主要圍繞 Apple Silicon 芯片的優化和終端操作。4.1 解壓與依賴檢查解壓文件使用系統自帶的“歸檔實用工具”或第三方工具如 The Unarchiver解壓下載的整合包。同樣建議放在純英文路徑下如~/Applications/ComfyUI。檢查 Python打開“終端”Terminal輸入python3 --version。ComfyUI 需要 Python 3.10 或 3.11。如果系統沒有建議通過 Homebrew 安裝# 安裝 Homebrew如果未安裝 /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) # 使用 Homebrew 安裝 Python 3.10 brew install python3.10檢查 Git終端輸入git --version確保 Git 已安裝用于后續插件管理。未安裝可通過brew install git安裝。4.2 啟動 ComfyUImacOS 整合包通常提供.sh腳本或通過終端命令啟動。方法一使用提供的啟動腳本在終端中使用cd命令導航到整合包解壓后的目錄。cd ~/Applications/ComfyUI查找啟動腳本如run.sh或webui.sh。使用ls -la命令查看文件。賦予腳本執行權限如果需要chmod x run.sh執行腳本./run.sh或者如果腳本設計為使用 Python 3python3 run.sh具體請查看腳本內的說明或注釋。方法二直接通過 Python 啟動如果整合包沒有提供腳本或你想自定義參數可以進入ComfyUI目錄直接運行cd ~/Applications/ComfyUI/ComfyUI python3 main.py --listen 127.0.0.1 --port 8188對于 Apple Silicon (M1/M2/M3) 芯片為了啟用 GPU 加速Metal需要使用--force-fp16參數并確保 PyTorch 支持 MPS。整合包通常已配置好。一個更完整的啟動命令可能如下python3 main.py --listen --port 8188 --force-fp164.3 macOS 特定優化與問題性能在 Apple Silicon 上確保使用--force-fp16參數以利用 MPS 后端這能顯著提升生成速度。內存管理macOS 使用統一內存顯存和內存共享。如果生成高分辨率圖像時崩潰可嘗試在啟動命令中添加--medvram或--lowvram參數來優化內存使用。端口占用如果 8188 端口被占用啟動時會報錯?？梢愿鼡Q端口如--port 7860。權限問題如果遇到“Permission denied”錯誤確保你對 ComfyUI 目錄有讀寫權限并使用chmod修正腳本權限。5. 核心配置與目錄管理成功啟動只是第一步合理管理模型和插件才能讓 ComfyUI 發揮最大效用。5.1 模型文件的管理模型是 ComfyUI 的核心資產。整合包可能預置了一些模型但你需要知道如何添加新的模型。模型目錄結構所有模型都應放在ComfyUI/models/下的對應子文件夾中。這是 ComfyUI 默認的查找路徑。checkpoints/存放 Stable Diffusion 大模型文件.safetensors或.ckpt。loras/存放 LoRA 模型文件。vae/存放 VAE 模型文件。controlnet/存放 ControlNet 模型文件。upscale_models/存放超分辨率模型如 ESRGAN。clip_vision/、insightface/等其他特定功能的模型。添加新模型從 Civitai、Hugging Face 等社區下載你需要的模型文件。根據模型類型將其放入上述對應的文件夾。重啟 ComfyUI或刷新瀏覽器頁面新模型就會出現在節點的下拉列表中。使用相對路徑與符號鏈接高級如果你的模型庫很大不想復制到整合包內可以修改路徑配置在ComfyUI目錄下找到或創建extra_model_paths.yaml文件指向外部模型庫目錄。創建符號鏈接適用于 Windows 和 macOS在ComfyUI/models/checkpoints目錄下創建指向外部模型文件的符號鏈接。5.2 插件的安裝與管理插件Custom Nodes極大地擴展了 ComfyUI 的功能。整合包已預裝了一些但你可能需要更多。插件安裝方式通過管理器如果整合包安裝了ComfyUI Manager插件你可以在 Web 界面中通過它搜索、安裝、更新插件。這是最推薦的方式。手動安裝將插件的 Git 倉庫克隆到ComfyUI/custom_nodes/目錄下。cd ComfyUI/custom_nodes git clone https://github.com/作者名/插件倉庫名.git安裝依賴許多插件需要額外的 Python 包。手動安裝插件后通常需要重啟 ComfyUI它會自動安裝requirements.txt中的依賴。如果失敗可能需要手動進入插件目錄運行pip install -r requirements.txt。插件沖突與排查安裝過多插件可能導致沖突或啟動變慢。如果啟動失敗可以嘗試暫時移除最近安裝的插件文件夾。查看命令行窗口的錯誤信息通常能定位到具體是哪個插件的問題。在ComfyUI/custom_nodes目錄下有些插件可能有disabled.前綴這是禁用插件的一種方式。5.3 工作流的保存與加載你的節點布局和連接就是“工作流”。整合包通常預置了一些示例工作流.json或.png文件。保存工作流在 Web 界面中點擊“Save”按鈕可以將當前工作流保存為.json文件。加載工作流點擊“Load”按鈕選擇之前保存的.json文件即可還原整個工作流。從圖片加載ComfyUI 支持將工作流信息嵌入 PNG 圖片的元數據中。你可以直接拖拽一張由 ComfyUI 生成的、包含工作流信息的圖片到界面它會自動還原工作流。這是分享工作流的常用方式。工作流存放位置你可以將常用的工作流文件整理到一個單獨的文件夾中方便管理。加載時從該文件夾選擇即可。6. 常見問題排查與解決方案即使使用整合包也可能會遇到各種問題。以下是按現象分類的排查指南。6.1 啟動階段問題問題現象可能原因檢查與解決方案雙擊.bat或.sh后窗口閃退1. 路徑包含中文/特殊字符。2. 依賴缺失如VC運行庫。3. 腳本內部錯誤。1. 將整合包移動到純英文路徑。2. (Win) 安裝最新 Visual C Redistributable 。3. 右鍵編輯.bat文件在最后一行pause前添加以便查看錯誤信息。命令行提示python不是命令系統未安裝 Python或整合包內置 Python 路徑錯誤。1. 確認整合包python_embeded目錄存在且完整。2. (Mac) 在終端使用python3命令或通過 Homebrew 安裝 Python。提示端口8188被占用已有 ComfyUI 或其他程序占用該端口。1. 關閉正在運行的 ComfyUI 進程。2. 修改啟動腳本或命令使用其他端口如--port 7860。啟動時下載模型卡住或報網絡錯誤首次啟動需要下載一些必要文件網絡連接不穩定。1. 檢查網絡。2. 可以嘗試手動下載相關文件并放置到正確目錄需根據錯誤日志判斷文件名。3. 某些整合包提供了“離線運行”模式可查閱其說明。6.2 運行與生成階段問題問題現象可能原因檢查與解決方案點擊“Queue Prompt”后無反應或提示錯誤1. 工作流節點連接有誤。2. 缺少必要的模型。3. 節點參數設置不合理。1. 檢查節點間的連線是否正確、完整特別是從 Load Checkpoint 到 VAE Decode 的主流程。2. 確認Load Checkpoint節點選擇的模型文件確實存在于models/checkpoints目錄。3. 查看命令行窗口或瀏覽器開發者工具F12控制臺的具體報錯信息。生成圖片純黑、純灰或扭曲1. VAE 模型不匹配或缺失。2. 模型本身需要特定 VAE。3. 采樣器或步數設置極端。1. 在VAE Loader節點中為你的大模型選擇合適的 VAE。許多 SD 1.5 模型使用vae-ft-mse-840000-ema-pruned.ckpt。2. 嘗試更換不同的采樣器如 Euler a, DPM 2M Karras和步數20-30。中文提示詞不生效生成結果與輸入無關1. 漢化插件未正確加載或配置。2. 使用的 CLIP 模型對中文支持不佳。1. 確認custom_nodes目錄下有漢化插件如ComfyUI-CN且無報錯。2. 嘗試在CLIP Text Encode節點前添加一個專門的中文編碼節點如果插件提供。3. 暫時使用英文提示詞測試工作流是否正常。顯存不足Out of Memory, OOM1. 生成分辨率過高。2. 同時加載了多個大模型。3. 使用了高分辨率修復Hires. fix等耗顯存功能。1. 降低生成圖像的寬高如 512x512, 768x768。2. 使用--medvram或--lowvram參數啟動 ComfyUI犧牲速度換顯存。3. 分步進行先生成小圖再用 Upscale 節點放大。6.3 界面與插件問題問題現象可能原因檢查與解決方案界面仍然是英文漢化插件未安裝、安裝失敗或未啟用。1. 檢查custom_nodes目錄下是否存在漢化插件文件夾。2. 重啟 ComfyUI觀察啟動日志是否有插件加載錯誤。3. 嘗試通過 ComfyUI Manager 重新安裝漢化插件。安裝了新插件但在節點列表找不到1. 插件安裝失敗。2. 需要刷新瀏覽器或重啟 ComfyUI。3. 插件節點位于非默認分類下。1. 重啟 ComfyUI 并查看啟動日志是否有該插件的錯誤。2. 在瀏覽器中按CtrlF5強制刷新頁面。3. 在節點搜索框中輸入插件或節點名稱的關鍵詞。瀏覽器界面卡頓、節點拖拽不流暢1. 工作流過于復雜節點太多。2. 瀏覽器硬件加速未開啟或性能不足。1. 將復雜工作流拆分成多個部分使用“組”節點進行管理。2. 在瀏覽器設置中開啟硬件加速。3. 嘗試使用更輕量的瀏覽器或關閉其他占用資源的標簽頁。7. 生產環境建議與進階方向當你熟悉了基本操作后可以考慮以下優化和進階使用讓 ComfyUI 更穩定、高效。7.1 穩定性與維護最佳實踐定期備份工作流將重要的、調試好的工作流.json文件備份到云端或本地其他位置。插件管理不要一次性安裝大量未經驗證的插件。逐個安裝測試確保穩定后再加入生產環境。模型管理建立規范的模型庫目錄使用extra_model_paths.yaml進行統一管理避免與 ComfyUI 主程序升級沖突。版本控制如果你對整合包內的ComfyUI主程序或插件進行了自定義修改考慮使用 Git 進行版本管理。日志監控養成查看啟動和運行日志的習慣。日志是排查問題的第一手資料。可以將日志重定向到文件以便查閱# 在啟動命令后添加示例 python main.py ... comfyui.log 217.2 性能優化建議Windows (NVIDIA)在run_nvidia_gpu.bat中可以添加--force-fp16使用半精度浮點數減少顯存占用并可能加速。添加--cuda-device 0指定使用哪塊 GPU多卡情況?？紤]使用xformers如果整合包已集成以優化注意力計算。macOS (Apple Silicon)務必使用--force-fp16啟動參數以啟用 MPS 后端。如果遇到內存壓力使用--medvram。關閉不必要的后臺應用為 ComfyUI 預留更多統一內存。通用優化使用LCM或TCD等快速采樣器可以極大幅度減少生成步數4-8步。對于固定尺寸的批量生成使用Empty Latent Image節點比Load Image更高效。7.3 下一步學習方向掌握核心節點深入理解KSampler,CLIP Text Encode,VAE Decode,Load Checkpoint等核心節點的每一個參數。學習工作流設計從加載圖片、使用 ControlNet如 Canny, Depth、添加 LoRA、到后期高清修復構建復雜而可控的生成管線。探索高級插件ComfyUI Manager插件生態的入口。WAS Node Suite提供大量圖像處理、文件操作工具。Impact Pack集成了人臉識別、檢測、分割等高級功能。Efficiency Nodes優化工作流執行效率。API 調用ComfyUI 支持 WebSocket 和 HTTP API學習如何通過編程方式如 Python 腳本調用工作流實現自動化生成。自定義節點開發如果你有特定需求可以學習使用 Python 為 ComfyUI 開發自己的自定義節點。整合包解決了從零到一的部署難題但 ComfyUI 真正的力量在于其無限的可組合性。從成功運行第一個中文提示詞開始逐步構建屬于你自己的、高效穩定的 AI 圖像生成工作流才是這個工具帶來的長期價值。遇到問題時善用日志、社區搜索和模塊化測試大部分技術障礙都能被系統地解決。