一、前置硬件环境要求
表格
| 硬件 | 最低配置 | 推荐配置 |
| 显卡 | NVIDIA 4G 显存 | NVIDIA RTX 3060/4060 及以上,≥6G 显存 |
| 系统 | Windows10/11 64 位 | Windows11 64 位 |
| 硬盘 | 剩余空间 20G | NVMe 固态硬盘,预留 50G 以上(存放模型) |
⚠️重要限制:AMD 显卡可以运行,但需要额外修改环境;本文教程基于 NVIDIA 显卡 CUDA 环境。 ❗解压路径禁止包含中文、空格、特殊符号,例如
D:\AI\秋叶ComfyUI正确;D:\AI工具\ComfyUI秋叶错误。
二、整合包安装部署步骤
- 下载资源打开夸克网盘链接,下载秋叶 ComfyUI-v9.5 完整压缩包。下载完成后,关闭杀毒软件(部分杀毒会误隔离依赖文件)。
- 解压文件使用 WinRAR 或 7-Zip 解压到纯英文路径。解压完成,进入根目录。
- 启动 WebUI双击根目录
start_comfyui.bat启动脚本。 首次运行会自动校验依赖、加载环境,等待终端日志输出To see the GUI go to: http://127.0.0.1:8188复制地址在浏览器打开,即可进入 ComfyUI 节点画布界面。
手动启动指令(CMD 终端方式,适合调试)
cd /d D:\AI\ComfyUI python main.py
三、显存优化配置(解决 OOM 显存溢出)
显存不足是本地部署最常见问题,分两种优化方式:修改启动脚本参数。
方案 1:修改 start_comfyui.bat 增加启动参数
右键编辑start_comfyui.bat,在启动命令后追加参数:
python main.py --lowvram --cuda-malloc --disable-xformers
参数说明:
--lowvram:低显存模式,适合 4G-6G 显卡,模型显存分片加载--cuda-malloc:启用 CUDA 内存分配优化,减少内存碎片--disable-xformers:关闭 xformers 加速,部分老显卡兼容报错时开启
显存≥8G 推荐参数(速度优先)
python main.py --xformers
方案 2:模型精度优化
在 ComfyUI 节点中,加载 Checkpoint 模型时,将模型加载类型设置fp16,不要使用 fp32,显存占用直接减半。
四、Python API 批量出图代码实战
适用场景:批量生成漫剧配图、批量测试提示词,无需手动点击生成按钮。 前提:ComfyUI 保持运行(http://127.0.0.1:8188),提前保存好工作流 JSON 文件。
import requests import json import os # ComfyUI服务地址 COMFYUI_URL = "http://127.0.0.1:8188" # 读取已经导出的工作流json with open("workflow.json", "r", encoding="utf-8") as f: workflow = json.load(f) # 批量提示词列表 prompt_list = [ "masterpiece,best quality,girl,outdoor,sunset", "masterpiece,best quality,boy,forest,soft light", "masterpiece,best quality,modern house,night scene" ] for idx, pos_prompt in enumerate(prompt_list): # 修改正向提示词节点,根据你自己工作流的节点ID替换 workflow["6"]["inputs"]["text"] = pos_prompt payload = {"prompt": workflow} res = requests.post(f"{COMFYUI_URL}/prompt", json=payload) print(f"任务{idx}提交成功,任务ID:{res.json()['prompt_id']}") print("全部绘图任务提交完成,请在ComfyUI查看生成结果")
使用说明:
- 在 ComfyUI 画布做好工作流,点击保存,导出为
workflow.json放到脚本同目录; - 修改代码里的节点 ID(示例中节点 6 是正向提示词节点);
- 直接运行脚本,批量提交绘图任务。
五、常用插件安装指令
ComfyUI 插件存放在 ComfyUI\custom_nodes可以用 git 命令快速拉取插件(需要提前安装 git)
cd custom_nodes git clone https://github.com/ltdrdata/ComfyUI-Manager.git
ComfyUI-Manager 是插件管理器,重启 ComfyUI 之后,可在网页端一键安装各类节点插件。
六、常见问题排查
- 启动闪退
- 检查路径是否存在中文;
- 关闭杀毒软件,重新解压整合包;
- 更新 NVIDIA 显卡驱动。
- OOM 显存不足添加
--lowvram启动参数,使用 fp16 模型,降低图片分辨率。 - 网页打不开 127.0.0.1:8188查看 CMD 终端日志,如果端口占用,可以更换端口启动:
python main.py --port 8189
- 图片生成慢显卡显存充足时,开启
--xformers加速,更换 SSD 存放模型文件。
七、小结
秋叶 ComfyUI-v9.5 整合包极大降低节点式 AI 绘图的本地部署门槛,不需要复杂的环境配置。配合 API 脚本可以实现自动化批量出图,非常适合 AI 素材批量生产。合理使用显存启动参数,4G 显存显卡也可以正常运行出图。后续可以搭配自定义工作流、ControlNet 插件,实现人物固定、姿态控制等高级 AI 绘图能力。