最近在折腾AI绘画时,发现很多朋友被ComfyUI繁琐的环境配置劝退。从Python版本、CUDA驱动到各种依赖插件,每一步都可能踩坑,网上教程又零散不成体系。如果你也想要一个开箱即用、稳定省心的ComfyUI环境,那么“秋叶大佬”制作的整合包绝对是你的首选。本文将以最新发布的ComfyUI V9.5整合包为例,手把手带你完成从下载、安装到基础使用的全过程,无论你是Windows还是Mac用户,无论你用的是50系、40系还是30系显卡,都能找到对应的解决方案。文章最后还会分享一些必备插件和常见问题排查思路,帮你快速上手这个强大的节点式AI绘画工具。
1. ComfyUI与秋叶整合包:为什么选择它?
在深入安装步骤之前,我们有必要先搞清楚两个核心概念:ComfyUI是什么?以及为什么秋叶整合包能极大简化我们的使用流程。
1.1 ComfyUI:节点式AI绘画的“乐高积木”
ComfyUI是一个基于节点(Node)和流程(Workflow)的Stable Diffusion图形用户界面。与WebUI(AUTOMATIC1111)这类传统界面不同,ComfyUI将图像生成的每一步——如加载模型、编写提示词、采样、解码——都抽象成一个个可连接、可配置的节点。
它的核心优势在于:
- 高度可控与可视化:你可以清晰地看到数据(如图像、潜空间特征)在整个生成流程中的流动,方便调试和优化。
- 强大的可复用性:可以将一套复杂的生成流程(工作流)保存为
.json或.png文件,分享给他人或在不同项目间复用,极大地提升了效率。 - 卓越的性能与内存管理:由于其非实时渲染的架构,ComfyUI通常比WebUI更节省显存,生成速度也可能更快,尤其适合批量出图。
- 极致的灵活性:通过连接不同的节点,你可以实现非常复杂和定制化的图像生成逻辑,这是传统UI难以做到的。
然而,强大的灵活性也带来了较高的上手门槛。新手需要手动配置Python环境、安装PyTorch(对应CUDA版本)、下载模型、管理插件,过程复杂且容易出错。
1.2 秋叶整合包:一键解决所有环境烦恼
“秋叶整合包”是国内开发者“秋葉aaaki”为ComfyUI制作的一键安装包。它完美解决了上述痛点:
- 开箱即用:整合包内置了Python、PyTorch、CUDA库、常用插件等所有必要组件。你无需关心版本兼容问题,下载解压即可运行。
- 多平台与多显卡支持:专门为Windows和macOS系统制作了对应的版本。对于Windows用户,还针对NVIDIA的不同系列显卡(如最新的50系、主流的40/30系,甚至更老的20/10系)进行了优化配置。
- 便捷的管理工具:整合包通常附带一个启动器,提供了一键更新、插件管理、模型路径设置等实用功能,大大降低了维护成本。
- 预置优化:集成了诸如
ComfyUI Manager(插件管理器)、Impact Pack等常用插件,并进行了必要的配置优化,让新手也能快速体验到ComfyUI的核心功能。
简单来说,使用秋叶整合包,你的核心任务就从“配环境”变成了“学操作和玩工作流”,可以更专注于AI绘画创作本身。
2. 环境准备与下载
在开始安装前,请做好以下准备工作,确保过程顺利。
2.1 系统与硬件要求
- 操作系统:
- Windows: Windows 10 或 Windows 11 (64位)。本文主要演示Windows下的安装。
- macOS: macOS 12 (Monterey) 或更高版本,支持Apple Silicon (M1/M2/M3) 和 Intel芯片。
- 显卡:
- NVIDIA显卡 (Windows): 这是获得最佳性能的首选。整合包已为不同架构的显卡预置了配置:
- 50/40/30系 (Ampere, Ada Lovelace 架构): 完美支持,性能最强。
- 20/16系 (Turing 架构): 良好支持。
- 10系 (Pascal 架构): 支持,但部分新特性可能受限,且需注意显存大小。
- Apple Silicon (macOS): 通过MPS(Metal Performance Shaders)支持,速度可观。
- AMD显卡 / Intel核显: 原生支持有限,可能需要通过DirectML (Windows) 或ROCM (Linux)等额外配置,整合包对此的优化较少,建议有经验的用户尝试。
- NVIDIA显卡 (Windows): 这是获得最佳性能的首选。整合包已为不同架构的显卡预置了配置:
- 存储空间:至少准备20GB的可用空间。这用于存放整合包本体、基础模型以及后续生成的图像。如果你计划下载多个大模型(如SDXL),则需要预留50-100GB或更多。
- 内存:建议16GB或以上。AI模型加载和图像处理对内存消耗较大。
2.2 获取秋叶ComfyUI整合包
由于网络传播途径多样,为了安全和使用最新版本,请务必通过可靠渠道下载。
- 推荐途径:在B站、知乎或GitHub上搜索“秋葉aaaki”,关注其官方发布动态。作者通常会在视频简介或专栏文章中提供最新的网盘下载链接和提取码。
- 版本选择:找到名为
ComfyUI-秋叶整合包-v9.5.7z或类似格式的文件(版本号可能更新,如v9.6)。注意区分Windows版和macOS版。 - 解压工具:确保电脑上安装了解压软件,如7-Zip、Bandizip或 WinRAR,用于解压
.7z或.zip格式的整合包。
3. Windows系统安装与配置详解
这是最常见的安装场景,我们将一步步拆解。
3.1 解压与目录结构
- 将下载好的
ComfyUI-秋叶整合包-v9.5.7z文件,移动到一个英文路径且空间充足的目录下。例如D:\AI_Tools\。 - 使用解压软件将其解压到当前文件夹。解压后,你会得到一个名为
ComfyUI或类似的主文件夹。 - 进入该文件夹,你会看到类似如下的结构:
核心文件就是ComfyUI_windows_portable/ ├── ComfyUI/ # ComfyUI 主程序目录 ├── python_embeded/ # 内置的Python环境 ├── update/ # 更新脚本目录 ├── 启动器.exe # **最重要的图形化启动器** └── 其他说明文件.txt启动器.exe,我们后续的所有操作都将围绕它展开。
3.2 首次运行与基础配置
- 双击运行
启动器.exe。如果系统弹出Windows Defender SmartScreen警告,选择“更多信息”,然后点击“仍要运行”。这是因为启动器是作者打包的便携程序,未经过微软官方商店签名。 - 启动器界面打开后,通常会有一个配置检测过程。它会自动识别你的显卡型号。
- 关键步骤:配置加速与模型路径
- 点击启动器上的“高级选项”或“配置”按钮。
- 加速器:根据你的网络情况选择。如果你在国内,通常选择“国内镜像源”可以显著加快插件和模型下载速度。
- 模型路径:这是非常重要的一步!ComfyUI需要加载各种模型(如checkpoint、VAE、Lora、ControlNet)。
- 如果你之前使用过Stable Diffusion WebUI,可以将其模型目录(通常是
stable-diffusion-webui/models/)链接或复制过来。 - 或者,你可以在一个空间大的盘(如D盘)新建一个文件夹,例如
D:\ai_models\,并在启动器设置中将“Stable Diffusion模型”路径指向它。后续下载的模型都放在这个统一目录下。 - 模型目录建议的子结构:
ai_models/ ├── checkpoints/ # 存放大模型 (.safetensors, .ckpt) ├── loras/ # 存放Lora模型 ├── vae/ # 存放VAE模型 ├── controlnet/ # 存放ControlNet模型 └── upscale_models/ # 存放超分辨率模型
- 如果你之前使用过Stable Diffusion WebUI,可以将其模型目录(通常是
- 保存配置。
3.3 一键启动与验证
- 回到启动器主界面,点击大大的“一键启动”按钮。
- 此时会弹出一个命令行窗口,开始加载ComfyUI。请勿关闭此窗口。首次启动会自动安装一些依赖,时间可能稍长。
- 当命令行窗口最后出现类似
Running on local URL: http://127.0.0.1:8188的信息时,表示启动成功。 - 你的默认浏览器会自动打开
http://127.0.0.1:8188这个地址。如果没自动打开,手动输入即可。
至此,你已经成功进入了ComfyUI的Web界面!一个空白的画布(工作流区域)就在你面前。
4. macOS系统安装指南
macOS的安装过程相对更简单,因为整合包已经为Apple Silicon和Intel芯片做好了适配。
- 下载和解压:下载对应的macOS整合包(通常为
.dmg或.zip格式),解压后得到一个应用程序(如ComfyUI.app)或一个文件夹。 - 放置应用:将
ComfyUI.app拖拽到“应用程序”文件夹中,或将其放在你喜欢的任何位置(建议应用程序文件夹)。 - 首次运行:
- 如果下载的是
.app,直接双击它。macOS可能会提示“无法打开,因为来自不受信任的开发者”。此时需要进入系统设置 -> 隐私与安全性,在下方找到并点击“仍要打开”。 - 如果下载的是文件夹,里面会有一个
启动.command或run.sh脚本。右键点击它,选择“打开”(或通过终端执行bash run.sh)。
- 如果下载的是
- 后续步骤:启动后,同样会打开终端窗口并启动服务。用浏览器访问
http://127.0.0.1:8188即可。模型路径的配置逻辑与Windows相同,在ComfyUI的界面中设置。
5. 初识ComfyUI界面与基本操作
成功打开界面后,你可能对满屏的空白感到茫然。别急,我们先来认识一下核心区域。
5.1 界面布局简介
- 节点面板(Node Panel):通常位于右侧或通过右键菜单唤出。这里分类列出了所有可用的节点,如
Load Checkpoint(加载模型)、CLIP Text Encode(编码提示词)、KSampler(采样器)等。 - 工作流画布(Workflow Canvas):中间最大的区域。你在这里通过拖拽和连接节点来构建图像生成流程。
- 队列按钮(Queue Prompt):点击它开始执行当前工作流。
- 工作流管理:
Load(加载)、Save(保存)、Clear(清空)工作流。
5.2 你的第一个工作流:文生图
让我们构建一个最简单的文生图流程,理解数据流向。
- 添加模型加载节点:在画布空白处右键 ->
Add Node->Loaders->Load Checkpoint。这个节点负责载入Stable Diffusion大模型。 - 添加提示词编码节点:右键 ->
Add Node->Conditioning->CLIP Text Encode (Prompt)。需要添加两个,一个用于正向提示词(positive),一个用于负向提示词(negative)。 - 添加采样器节点:右键 ->
Add Node->Sampling->KSampler。这是核心,负责扩散去噪过程。 - 添加VAE解码节点:右键 ->
Add Node->Loaders->VAE Loader加载VAE,然后连接VAE Decode节点。或者直接用Add Node->Latent->VAE Decode。 - 添加图像保存/预览节点:右键 ->
Add Node->Image->Save Image或Preview Image。 - 连接节点:
- 将
Load Checkpoint的MODEL输出,连接到KSampler的model输入。 - 将
Load Checkpoint的CLIP输出,分别连接到两个CLIP Text Encode节点的clip输入。 - 将
Load Checkpoint的VAE输出,连接到VAE Decode的vae输入。 - 将
CLIP Text Encode (positive)的CONDITIONING输出,连接到KSampler的positive输入。负向提示词同理。 - 将
KSampler的LATENT输出,连接到VAE Decode的samples输入。 - 将
VAE Decode的IMAGE输出,连接到Save Image的images输入。
- 将
- 配置节点参数:
- 在
Load Checkpoint节点中,点击选择框,加载一个你放在checkpoints文件夹中的模型(如sd_xl_base_1.0.safetensors)。 - 在两个
CLIP Text Encode节点中分别输入正向和负向提示词。 - 在
KSampler节点中设置采样步数(steps,如20)、CFG Scale(如7)、采样器(sampler_name,如euler)和调度器(scheduler,如normal)。 - 在
Save Image节点中可以设置输出图片的前缀名。
- 在
- 生成图像:点击
Queue Prompt按钮,等待右侧进度条完成。生成的图片会保存在ComfyUI输出目录(默认在ComfyUI/output)下,并在Save Image节点上显示预览。
这个过程看似复杂,但熟练后只需几十秒。你可以通过Ctrl+S保存这个工作流为.json文件,下次直接Ctrl+L加载即可。
6. 插件管理与必备插件推荐
秋叶整合包预装了ComfyUI Manager,它是管理插件的“应用商店”。
6.1 安装与管理插件
- 在ComfyUI网页界面中,你应该能看到一个
Manager按钮,点击它。 - 切换到
Install Custom Nodes标签页。 - 在这里你可以搜索、浏览海量社区插件。找到想要的插件后,点击其右侧的
Install按钮即可。 - 安装完成后,通常需要点击
Restart重启ComfyUI(在启动器上操作)来启用新插件。
6.2 新手必备插件推荐
- ComfyUI Manager:已预装,插件管理核心。
- Impact Pack:功能极其强大的综合工具包,包含众多实用节点,如人脸修复、细节提升、通配符处理、条件筛选等,几乎是必备。
- WAS Node Suite:另一个功能丰富的节点集合,提供图像处理、文本操作、逻辑判断等多种工具。
- Efficiency Nodes:提供一系列能提升工作流效率的节点,如将常用节点组打包等。
- ControlNet Preprocessors:如果你需要使用ControlNet,这个插件提供了丰富的预处理器节点(如Canny边缘检测、深度图估计等)。
- AIGODLIKE-ComfyUI-Translation:ComfyUI的汉化插件,对英文界面感到吃力的用户可以安装。
安装建议:不要一次性安装太多插件,按需安装。先掌握基础工作流,再根据创作需求逐步添加功能插件。
7. 常见问题与故障排查
即使使用整合包,也可能遇到一些问题。下面是一些常见情况的排查思路。
7.1 启动器或ComfyUI无法启动
| 问题现象 | 可能原因 | 解决思路 |
|---|---|---|
双击启动器.exe无反应 | 1. 被杀毒软件/Windows Defender拦截。 2. 运行库缺失。 | 1. 检查杀毒软件隔离区,恢复并添加信任。 2. 安装微软常用运行库合集(如VC_redist)。 |
| 启动后命令行闪退 | 1. Python环境冲突。 2. 路径包含中文或特殊字符。 3. 端口被占用。 | 1. 确保整合包放在纯英文路径下。 2. 查看闪退前命令行窗口的报错信息(可尝试在启动器高级选项中勾选“保留命令行窗口”)。 3. 默认端口 8188被占用,可在启动器配置中修改端口号。 |
| 提示“Torch not compiled with CUDA enabled” | PyTorch未能正确识别到CUDA或显卡。 | 1. 确认显卡驱动为最新。 2. 在启动器“高级选项”中,尝试切换不同的“加速方案”(如cuda、directml)。 3. 对于老显卡(如10系),可能需要选择兼容性更好的旧版PyTorch配置。 |
7.2 生成图像时报错
| 问题现象 | 可能原因 | 解决思路 |
|---|---|---|
RuntimeError: CUDA out of memory | 显存不足。这是最常见的问题。 | 1. 减少生成图片的分辨率或批量大小。 2. 使用 --lowvram或--medvram参数启动(可在启动器配置中设置)。3. 关闭其他占用显存的程序。 4. 使用Tiled VAE、分块采样等省显存技术(需对应插件)。 |
KeyError: ‘model.diffusion_model…’ | 模型文件不兼容或损坏。 | 1. 确认下载的模型文件完整,并且是ComfyUI支持的格式(.safetensors,.ckpt)。2. 模型可能与当前ComfyUI版本不兼容,尝试更换其他模型。 |
| 生成图片全黑或全灰 | VAE未正确加载或配置。 | 1. 检查工作流中是否连接了VAE解码节点。 2. 尝试在 Load Checkpoint节点后显式连接一个VAE Loader节点,并选择一个VAE模型(如vae-ft-mse-840000-ema-pruned.safetensors)。 |
7.3 插件相关错误
- 安装插件后报错:新插件可能与现有ComfyUI版本或其他插件冲突。
- 解决:在ComfyUI Manager中禁用或卸载该插件。或者,通过启动器上的“修复依赖”功能尝试修复环境。
- 找不到新安装的节点:插件未成功安装或需要重启。
- 解决:确认安装过程无报错,然后完全重启ComfyUI(关闭所有相关进程再启动)。
7.4 模型管理建议
- 模型去哪下载?:可以在Civitai、Hugging Face等模型社区网站下载。下载后,根据模型类型(大模型、Lora、VAE等)放入3.2节中设置的对应文件夹。
- 如何切换模型?:在
Load Checkpoint节点的选择框中直接点击选择即可。如果列表中没有,请检查模型文件是否已放入正确的checkpoints目录,并确认文件格式正确。
8. 最佳实践与进阶建议
当你熟悉基础操作后,以下建议能帮助你更高效、更稳定地使用ComfyUI。
8.1 工作流管理
- 善用保存与加载:将调试好的稳定工作流保存为
.json文件,并建立自己的工作流库。分享时,也可以导出为.png图片(ComfyUI支持将工作流嵌入图片元数据)。 - 模块化思维:将复杂流程中重复的部分(如高清修复、人脸修正)封装成自定义节点组(选中多个节点,按
Ctrl+G)。这能让主工作流更清晰。 - 添加注释:使用
Add Node->utils->Note节点,为工作流的关键部分添加文字说明,方便日后回顾或与他人协作。
8.2 性能优化
- 显存优化:
- 对于显存小于8GB的显卡,务必在启动器配置中启用
--medvram。 - 使用
TAESD编码器进行快速预览,它能极大降低VAE解码的显存和耗时。 - 在生成大图时,使用
Ultimate SD Upscale或Tiled Diffusion等插件进行分块生成。
- 对于显存小于8GB的显卡,务必在启动器配置中启用
- 生成速度:
- 选择合适的采样器。
Euler a速度快但可能不稳定;DPM++ 2M Karras在质量和速度上平衡较好。 - 在满足质量要求的前提下,适当降低采样步数(如从30降到20)。
- 考虑使用
LCM或Turbo等快速推理模型,能以极少的步数生成图像。
- 选择合适的采样器。
8.3 学习资源与社区
- 工作流学习:在
Civitai或OpenArt等网站搜索“ComfyUI Workflow”,下载别人分享的.json或.png文件,导入到自己的ComfyUI中学习、拆解。这是最快的学习方式。 - 问题求助:遇到复杂问题时,可以到
GitHub Issues、Reddit的r/comfyui板块或相关的Discord社群提问。提问时,最好附上你的错误日志和简单的工作流截图。
从繁琐的环境配置中解放出来,秋叶整合包让我们能更专注于ComfyUI本身强大的创作能力。本文详细走通了从下载、安装、配置到运行第一个工作流的完整闭环,并提供了插件推荐和常见问题排查指南。记住,ComfyUI的学习曲线在于理解节点间数据的流动逻辑,多拆解、多模仿优秀工作流是进步的捷径。现在,你的AI绘画“乐高工作室”已经搭建完毕,接下来就是发挥创意,拼接出属于你自己的惊艳作品了。如果在实践中遇到新的问题,不妨回到启动器的“疑难解答”功能,或者带着具体的工作流截图去社区交流,你会发现ComfyUI的生态非常活跃和友好。