1. 背景与核心概念
对于想要深入探索AI绘画和图像生成的开发者与爱好者来说,Stable Diffusion WebUI(如Automatic1111)提供了一个直观的起点。然而,当你的创作需求从简单的文生图转向更复杂、更可控的流程化生成时,一个更强大、更灵活的工具就显得尤为重要。ComfyUI正是为此而生,它通过节点式、可视化的编程界面,将Stable Diffusion的每一步生成过程都拆解开来,让你能够像搭积木一样构建复杂的工作流。
ComfyUI是什么?简单来说,ComfyUI是一个基于节点图的Stable Diffusion图形用户界面。它将图像生成的每个步骤(如加载模型、编写提示词、采样、放大等)封装成一个个独立的“节点”(Node),用户通过连接这些节点来定义整个生成流程。这种方式带来了无与伦比的灵活性、可重复性和对生成过程的深度控制。
为什么需要“整合包”?ComfyUI本身是一个开源项目,其安装和配置过程涉及Python环境、PyTorch、CUDA、各种依赖库以及模型文件的放置,对于新手或希望快速上手的用户来说,步骤繁琐且容易出错。尤其是在处理不同操作系统(Windows/macOS)和不同显卡(NVIDIA/AMD/Apple Silicon)的兼容性问题时,门槛较高。
“秋叶ComfyUI整合包”正是为了解决这些问题而诞生的。它由国内知名的AI工具整合者“秋叶aaaki”制作发布,将ComfyUI的核心程序、必要的Python环境、常用插件、基础模型以及启动器全部打包在一起。其核心价值在于:
- 开箱即用:用户无需自行配置Python、安装依赖,解压后即可运行。
- 跨平台支持:明确支持Windows和macOS系统,覆盖了绝大多数个人用户的使用场景。
- 广泛的硬件兼容:特别强调支持NVIDIA的50、40、30系列显卡,同时也为AMD显卡和Mac的Apple Silicon芯片提供了启动选项,降低了硬件门槛。
- 中文优化与易用性:整合包通常内置了汉化插件、优化的启动器界面,并预装了如
ComfyUI Manager(插件管理器)等实用工具,极大提升了中文用户的使用体验。
本文将围绕“秋叶ComfyUI整合包”,为你提供一份从下载、安装、配置到基础使用的完整实战指南。无论你是刚接触ComfyUI的新手,还是从WebUI迁移过来的用户,都能通过本文快速搭建起属于自己的AI绘画工作站。
2. 环境准备与版本说明
在开始之前,请确保你的计算机满足以下基本要求,并了解整合包的基本构成。
硬件与操作系统要求:
- Windows: Windows 10 或 Windows 11 64位操作系统。确保有足够的磁盘空间(建议预留30GB以上用于存放整合包和后续的模型)。
- macOS: macOS 12 (Monterey) 或更高版本,建议使用Apple Silicon (M1/M2/M3) 芯片以获得最佳性能,Intel芯片Mac也可运行。
- 显卡:
- NVIDIA显卡(Windows): 推荐GTX 10系列及以上,显存至少4GB,8GB或以上体验更佳。整合包特别优化了对RTX 30/40/50系列的支持。
- AMD显卡(Windows): 支持通过DirectML后端运行,性能可能低于CUDA,但可用。
- Apple Silicon(macOS): 原生支持,使用MPS(Metal Performance Shaders)加速。
- 内存: 建议16GB或以上。
- 磁盘空间: 整合包本身约10-20GB,还需为下载的模型预留大量空间(基础大模型约2-7GB每个,LoRA等小模型几十到几百MB)。
整合包内容概览:一个典型的秋叶ComfyUI整合包解压后,目录结构大致如下(具体可能因版本略有差异):
ComfyUI_windows/ 或 ComfyUI_macos/ ├── ComfyUI/ # ComfyUI主程序目录 │ ├── models/ # 模型存放目录(初始可能为空或含示例模型) │ │ ├── checkpoints/ # 放置大模型(.safetensors, .ckpt) │ │ ├── loras/ # 放置LoRA模型 │ │ ├── vae/ # 放置VAE模型 │ │ └── ... # 其他类型模型目录 │ ├── output/ # 生成图片的输出目录 │ ├── input/ # 用于图生图等功能的输入图片目录 │ ├── custom_nodes/ # 自定义插件(节点)目录 │ └── ... # 其他ComfyUI核心文件 ├── python_embeded/ # 内置的便携Python环境(Windows版) │ └── ... # Python解释器及依赖库 ├── 启动器.exe # Windows图形化启动器(关键!) ├── run_nvidia_gpu.bat # Windows NVIDIA显卡启动脚本 ├── run_amd_gpu.bat # Windows AMD显卡启动脚本 ├── run_cpu.bat # Windows CPU启动脚本 └── 使用说明.txt # 简要的说明文档重要版本说明:本文的讲解基于“秋叶ComfyUI整合包”的通用结构和原理。由于ComfyUI及其插件生态更新迅速,整合包也会持续迭代。请务必以你下载到的整合包内附的“使用说明”为准,本文提供的是通用的方法和思路。如果遇到步骤不一致,优先遵循整合包自带的说明。
3. 下载与安装全流程
3.1 获取整合包资源
由于网络传播的复杂性,整合包的下载链接可能经常变更。最可靠的方式是关注原作者“秋叶aaaki”在B站、知乎或GitHub等平台发布的动态。通常,整合包的发布文章或视频简介中会提供网盘(如百度网盘、123云盘)的下载链接和提取码。
下载注意事项:
- 确认系统:下载时注意区分
Windows版本和macOS版本,不要下错。 - 检查完整性:下载完成后,核对文件大小是否与发布信息一致。对于分卷压缩包,确保所有分卷都已下载完整。
- 解压工具:建议使用最新版的
Bandizip、7-Zip或WinRAR进行解压,避免使用系统自带的解压功能可能出现的编码错误。
3.2 Windows系统安装与启动
Windows版本是整合包的主力,其“一键启动”的特性最为突出。
步骤一:解压与放置
- 将下载好的压缩包(例如
ComfyUI_秋叶整合包_vX.X.7z)解压到一个路径中不含中文和特殊字符的目录。例如D:\AI_Tools\ComfyUI\。这一点非常重要,可以避免后续许多潜在的路径错误。 - 解压后,进入解压目录,你会看到
启动器.exe、run_nvidia_gpu.bat等文件。
步骤二:启动与配置
- 首次启动:直接双击运行
启动器.exe。启动器会自动进行一些初始化检测。 - 配置模型路径(关键步骤):启动器界面通常有一个“模型路径配置”或类似的选项。你需要将你从其他地方(如Civitai、HuggingFace)下载的模型文件,按照类型放入整合包对应的目录中,并在此处确认路径。
- 大模型(Checkpoint): 放入
ComfyUI/models/checkpoints/ - LoRA模型: 放入
ComfyUI/models/loras/ - VAE模型: 放入
ComfyUI/models/vae/ - ControlNet模型: 放入
ComfyUI/models/controlnet/ - 启动器里通常有“扫描模型”或“刷新列表”按钮,点击后你的模型就会出现在ComfyUI的对应节点下拉菜单中。
- 大模型(Checkpoint): 放入
- 选择运行配置:
- NVIDIA显卡用户:在启动器中选择“NVIDIA GPU”模式,这是性能最好的方式。
- AMD显卡用户:选择“AMD GPU (DirectML)”模式。
- 仅CPU运行:如果你的显卡不支持或出现问题,可以选择此模式,但速度会非常慢。
- 一键启动:点击启动器上的“启动”或“运行”按钮。首次启动会相对较慢,因为需要加载环境。启动成功后,你的默认浏览器会自动打开一个地址为
http://127.0.0.1:8188的页面,这就是ComfyUI的Web操作界面。
备用启动方式: 如果启动器出现问题,你也可以尝试直接运行根目录下的脚本文件:
run_nvidia_gpu.bat: 双击此文件,会打开一个命令行窗口并启动ComfyUI。成功后会显示“To see the GUI go to: http://127.0.0.1:8188”,此时手动在浏览器输入该地址即可。
3.3 macOS系统安装与启动
macOS版本的整合包同样追求解压即用,主要针对Apple Silicon芯片优化。
步骤一:解压与放置
- 将下载的macOS版整合包(如
.dmg镜像或.zip压缩包)解压/拖拽到“应用程序”(Applications)文件夹或其他你习惯的位置。 - 同样确保路径没有中文。
步骤二:启动与权限
- 找到解压后的目录,通常会有一个名为
启动ComfyUI或run.command的脚本文件。 - 首次运行需授予权限:在macOS上,首次运行来自非App Store的脚本或应用时,系统可能会阻止。你需要:
- 在“访达”(Finder)中右键点击该脚本文件。
- 选择“显示简介”。
- 在“通用”部分,如果看到“已阻止”提示,勾选“解除锁定”。
- 或者,在终端中先为该文件添加执行权限:打开“终端”(Terminal),输入以下命令(将路径替换为你的实际路径):
chmod +x /path/to/你的ComfyUI文件夹/run.command
- 双击启动:双击
run.command脚本。系统可能会再次询问是否打开,选择“打开”。 - 一个终端窗口会弹出,开始加载环境。首次启动会下载一些必要的依赖。加载完成后,终端会显示访问地址(通常是
http://127.0.0.1:8188),浏览器会自动打开或需要你手动输入该地址。
M芯片性能优化:整合包通常已配置为使用MPS后端,这是Apple Silicon的专用加速框架,性能远优于CPU模式。
4. ComfyUI界面与基础工作流搭建
成功启动并打开浏览器后,你将看到ComfyUI的界面。它可能看起来有些复杂,但遵循逻辑后会发现其强大之处。
4.1 界面初识
- 节点图区域:中间最大的空白区域,是你搭建工作流的地方。
- 节点菜单:右键点击节点图区域,会弹出所有可用的节点分类菜单。
- 节点:每个功能块,有输入和输出“插座”。
- 连接线:从一个节点的输出“插座”拖拽到另一个节点的输入“插座”,以传递数据。
- 队列按钮:界面上的“Queue Prompt”按钮,用于执行当前工作流。
- 工作流管理:可以保存(Save)当前节点布局为
.json文件,或加载(Load)已有的工作流。
4.2 构建你的第一个文生图工作流
让我们手动搭建一个最基础的文生图流程,来理解核心节点的作用。
步骤1:加载模型
- 在节点图区域右键 ->
Loaders->Checkpoint Loader。 - 这个节点用于加载大模型。点击节点上的“ckpt_name”下拉框,你应该能看到之前放入
checkpoints文件夹的模型列表,选择一个(例如sdXL_v10.safetensors)。
步骤2:编写提示词
- 右键 ->
Conditioning->CLIP Text Encode (Prompt)。 - 这个节点用于处理正面提示词。你会创建两个这样的节点,一个用于正面提示词(
positive),一个用于负面提示词(negative)。 - 在节点的
text输入框内输入描述,例如正面输入“masterpiece, best quality, a cute cat”,负面输入“worst quality, lowres”。
步骤3:设置采样器
- 右键 ->
Sampling->KSampler。 - 这是控制图像生成算法的核心节点。需要连接和设置几个关键参数:
model: 连接到Checkpoint Loader节点的MODEL输出。positive: 连接到正面CLIP Text Encode节点的CONDITIONING输出。negative: 连接到负面CLIP Text Encode节点的CONDITIONING输出。latent_image: 暂时空着,下一步创建。- 参数设置:
steps(采样步数,如20),cfg(提示词相关性,如7.5),sampler_name(采样器,如euler),scheduler(调度器,如normal)。
步骤4:创建初始潜空间
- 右键 ->
Latent->Empty Latent Image。 - 这个节点定义了生成图片的尺寸和批次。设置
width(宽度,如512),height(高度,如512),batch_size(批次,如1)。 - 将其
LATENT输出连接到KSampler节点的latent_image输入。
步骤5:解码潜空间为图像
- 右键 ->
Latent->VAE Decode。 - 采样器输出的是“潜空间”数据,需要用VAE解码成像素图像。
samples: 连接到KSampler节点的LATENT输出。vae: 连接到Checkpoint Loader节点的VAE输出。
步骤6:保存图像
- 右键 ->
Image->Save Image。 - 这个节点将图像保存到
ComfyUI/output目录。images: 连接到VAE Decode节点的IMAGE输出。- 你可以设置
filename_prefix来定义保存图片的前缀名。
最终连接图: 你的节点连接顺序应该是:Checkpoint Loader-> (CLIP Text Encodex2) ->KSampler<-Empty Latent Image->VAE Decode->Save Image。
步骤7:生成图像
- 点击右上角的
Queue Prompt按钮。 - 稍等片刻,生成完成后,点击
Save Image节点上出现的预览图,或直接去ComfyUI/output文件夹查看生成的图片。
4.3 使用预置工作流与导入
手动搭建是学习的好方法,但效率不高。整合包和社区提供了大量现成的工作流(.json文件或.png图片)。
加载工作流文件:
- 在ComfyUI界面,点击右侧的
Load按钮。 - 选择你从网上下载的
.json工作流文件,或整合包可能自带的示例工作流。 - 加载后,完整的节点图就会出现在画布上。你需要检查并重新配置模型路径,因为工作流中记录的模型名称可能与你本地的不一致。点击各个
Checkpoint Loader、Lora Loader等节点,从下拉菜单中选择你本地已有的对应模型。 - 配置好后,点击
Queue Prompt即可运行。
从图片加载工作流: ComfyUI有一个强大功能:可以将工作流元数据嵌入生成的图片中。
- 将一张由ComfyUI生成且包含元数据的图片拖入节点图区域。
- 它会自动还原出生成该图片的完整工作流节点图。这是学习和分享工作流的绝佳方式。
5. 插件管理与进阶使用
整合包通常预装了ComfyUI Manager,这是管理插件的核心工具。
5.1 安装与管理插件
- 在ComfyUI界面,你应该能看到一个
Manager按钮或标签页,点击进入。 - 安装插件:在
Install Custom Nodes标签页,你可以搜索或浏览社区插件列表,找到后点击Install即可。安装后需要重启ComfyUI。 - 更新插件/ComfyUI:在
Update标签页,可以一键更新所有已安装的插件或ComfyUI本体到最新版本。注意:更新可能有风险,建议在更新前备份你的custom_nodes文件夹或整个整合包。
5.2 推荐必备插件
除了管理器,以下插件能极大提升体验,整合包可能已预装:
ComfyUI-Impact-Pack: 功能极其强大的工具箱,包含细节修复、人脸修复、分段、检测器等大量实用节点。efficiency-nodes-comfyui: 提供各种效率节点,如通配符处理、提示词调度等。ComfyUI-Advanced-ControlNet: 更强大的ControlNet节点集。WAS Node Suite: 另一个功能丰富的扩展节点包。ComfyUI-Custom-Scripts: 允许用户自定义脚本。
5.3 模型管理与放置
高效的模型管理是流畅使用ComfyUI的关键。
- 分类清晰:严格按照
models下的子文件夹分类存放模型。 - 使用别名:对于文件名很长的模型,可以在
ComfyUI/models目录下创建一个custom_nodes/comfyui-art-venture/之类的文件夹(如果支持),或者使用支持别名管理的插件来为模型设置简短易记的名称。 - 定期清理:模型文件非常占用空间,定期清理不再使用或效果不佳的模型。
6. 常见问题与排查思路
即使使用整合包,也可能遇到一些问题。以下是常见问题的排查指南。
| 问题现象 | 可能原因 | 解决思路 |
|---|---|---|
| 启动器点击“启动”无反应或闪退 | 1. 路径包含中文/特殊字符。 2. 杀毒软件/防火墙拦截。 3. 端口被占用(默认8188)。 4. 运行库缺失(Windows)。 | 1. 将整合包移动到纯英文路径。 2. 暂时关闭杀毒软件,或将启动器加入白名单。 3. 在启动器设置中更改端口号,或关闭占用8188端口的程序。 4. 安装微软常用运行库合集(如VC Redist)。 |
浏览器打开http://127.0.0.1:8188无法连接 | 1. ComfyUI服务未成功启动。 2. 启动脚本报错退出。 | 1. 检查启动器或命令行窗口是否在运行,有无错误信息。 2. 尝试使用备用启动脚本(如 run_nvidia_gpu.bat),观察命令行中的具体报错。 |
| 节点图中加载模型下拉列表为空 | 1. 模型未放入正确的文件夹。 2. 模型路径未在启动器中正确配置或刷新。 | 1. 确认模型文件已放入ComfyUI/models/checkpoints/等对应目录。2. 在启动器中找到“模型配置”或“扫描模型”功能,点击刷新。重启ComfyUI。 |
生成图片时报错,提示CUDA out of memory | 显存不足。 | 1. 在KSampler中降低图片分辨率(如从1024降到768)。2. 减少 batch_size(如从4降到1)。3. 使用 TAESD等轻量VAE。4. 启用 VAE的tiling功能(如果支持)。5. 使用 ComfyUI Manager安装ComfyUI-Impact-Pack,并使用其中的“PatchModelAddDownscale”等显存优化节点。 |
| 加载工作流后,节点显示为红色或报错 | 1. 缺少必要的插件(自定义节点)。 2. 工作流中引用的模型本地不存在。 | 1. 查看错误信息,通常会提示缺失的节点类型。使用ComfyUI Manager搜索并安装对应插件。2. 逐个检查工作流中的模型加载节点,确保选择的模型名称与你本地文件一致。 |
| 生成速度非常慢 | 1. 使用了CPU模式。 2. 图片分辨率设置过高。 3. 采样步数(steps)设置过高。 4. macOS上未正确使用MPS。 | 1. 确认启动时选择了正确的GPU模式(NVIDIA/AMD/DirectML/MPS)。 2. 适当降低分辨率。 3. 尝试使用更高效的采样器(如 dpmpp_2m),步数可降至20-30。4. 确保macOS版本支持,并查看启动日志确认使用了 “Using MPS”后端。 |
| 如何更新整合包? | 直接覆盖可能导致配置丢失。 | 1.推荐:备份你的ComfyUI/models/文件夹和ComfyUI/custom_nodes/文件夹。2. 下载新版整合包,解压到新目录。 3. 将备份的 models和custom_nodes文件夹复制到新整合包的对应位置。4. 使用新的启动器启动。 |
7. 最佳实践与工程建议
为了更稳定、高效地使用ComfyUI进行创作和开发,遵循以下实践会大有裨益。
项目与工作流管理
- 保存工作流:任何有用的工作流,都要及时通过
Save按钮保存为.json文件。建议建立专门的文件夹进行分类管理(如工作流/人像生成/、工作流/场景构建/)。 - 使用模板:将常用的、稳定的流程部分(如高清修复、人脸增强链)保存为子工作流(
Ctrl+S可将选中的节点组保存为模板),方便在不同项目中复用。 - 注释节点:对于复杂工作流,善用
Add Note功能为关键节点或参数添加文字说明,便于日后理解和修改。
- 保存工作流:任何有用的工作流,都要及时通过
模型与资产管理
- 建立本地模型库:使用
Civitai Helper等插件或工具,有计划地下载和管理模型,并为其添加预览图和详细标签。 - 版本控制:对于自己训练或调整的LoRA等模型,做好版本记录。模型文件名可以包含版本号和日期(如
my_style_lora_v1_20240515.safetensors)。 - 输出管理:ComfyUI默认输出到
output文件夹。可以定期按日期或项目创建子文件夹,或在Save Image节点中使用动态文件名前缀(如%date:yyyy-MM-dd%/project_name_%count)来自动整理生成结果。
- 建立本地模型库:使用
性能优化
- 显存优化:对于大分辨率出图,优先使用
“PatchModelAddDownscale”(Impact Pack)或“Upscale Model (with Tiled VAE)”等工作流,它们能有效分解计算任务,避免显存溢出。 - 使用预览节点:在调试复杂工作流时,在关键步骤后插入
Preview Image节点,可以实时查看中间结果,避免跑完整个流程才发现问题,节省时间。 - 关闭不必要的节点:在最终渲染前,可以暂时禁用(右键节点 ->
Disable)一些用于调试的预览节点,以减少不必要的计算和显存占用。
- 显存优化:对于大分辨率出图,优先使用
学习与探索
- 从图片加载工作流:这是最快的学习方式。多去Civitai、OpenArt等社区下载别人分享的优秀作品图片,拖入ComfyUI分析其工作流结构。
- 分解复杂工作流:遇到复杂工作流时,不要试图一次性理解全部。可以逐个模块(如提示词处理、ControlNet控制、高清修复链)进行隔离、测试和理解。
- 参与社区:GitHub、Discord、相关中文论坛是解决问题的好地方。提问时,最好能提供你的工作流
.json文件、错误日志截图和已尝试的解决步骤。
通过秋叶整合包,你获得了一个强大且易用的ComfyUI入口。但真正的力量来自于你对节点工作流逻辑的理解和掌握。从模仿一个简单的工作流开始,逐步尝试修改参数、替换模型、增加新的控制节点,你会发现ComfyUI为你打开的是一扇通往可控、可编程AI艺术创作的大门。