v0.45.0 · GPL-3.0下载
首页/节点文档

comfyui文档 - 节点速查、目录结构与自定义节点

models 目录用途、十个核心节点、工作流 JSON 与 /prompt 接口、自定义节点管理。

01目录结构:模型该放哪

comfyui文档 里最常被翻的就是这张表——界面下拉框读不到模型,九成是放错了目录。

路径放什么备注
models/checkpoints主模型(.safetensors / .ckpt)最大,优先放 SSD
models/lorasLoRA 风格权重按风格分文件夹更易管理
models/vaeVAE 编解码器部分模型需外挂 VAE
models/controlnetControlNet 控制模型姿态、线稿、深度图
models/clip文本编码器FLUX / SD3 常用独立 CLIP
models/upscale_models放大模型ESRGAN 等
custom_nodes第三方节点包ComfyUI-Manager 安装位置
user/default/workflows保存的工作流 JSON升级前建议备份
output生成图片与中间产物按日期或项目归档
input图生图 / 局部重绘的上传素材拖入画布的图片也在此
路径基准:便携版里这些目录位于 ComfyUI_windows_portable/ComfyUI/ 下面, 源码部署则在仓库根目录。改完文件后回到界面点刷新按钮,或重启服务让下拉列表重建。

官方还支持用 extra_model_paths.yaml 把模型库指到别的硬盘, 适合与其他 AI 工具共用一份权重,避免同一个几 GB 的文件存三份。改完配置需重启。

02十个核心节点速查

节点作用
Load Checkpoint加载主模型,一次性带出 MODEL / CLIP / VAE 三个输出
CLIP Text Encode把正向、反向提示词编码成条件向量
Empty Latent Image设定分辨率与批量张数,生成空潜空间
KSampler采样核心:步数、CFG、采样器、调度器、种子都在这里
VAE Decode把潜空间结果解码成像素图像
Save Image输出到 output 目录,同时可在界面预览
Load Image / VAE Encode图生图入口,把图片编码回潜空间
Load LoRA挂接风格权重,可串联多个并分别设强度
ControlNetApply接入姿态 / 线稿 / 深度等控制条件
Upscale Model Loader调用放大模型做高清修复

理解节点的关键是数据类型的颜色与形状:MODEL、CLIP、VAE、CONDITIONING、LATENT、IMAGE 各有固定接口,只有同类型才能连。比如 CLIP Text Encode 输出的是 CONDITIONING, 接到 KSampler 的 positive / negative 输入;VAE Decode 输出 IMAGE,才能接 Save Image。 连不上时先看接口类型,而不是找参数。

03工作流文件与接口

名称含义
Workflow JSON界面保存格式,含节点位置、连线、参数与界面状态,用于人工编辑
API Format JSON接口格式,节点按编号索引,供 /prompt 提交
Prompt / Queue一次生成任务;Queue Prompt 把当前流程压入队列
Seed / CFG / Steps随机种子、提示词遵循强度、采样步数,都在 KSampler 里
Sampler / Scheduler采样器与调度器,决定去噪路径,常见的有 euler、dpmpp_2m 等
Denoise图生图重绘幅度,越低越贴近原图,一般 0.4–0.7
Custom Nodes社区扩展节点,装在 custom_nodes,缺了会显示红框

把流程当接口用是 comfyui 的一大优势:在界面里把参数调好, 用「Save (API Format)」导出 JSON,脚本里 POST 到 /prompt 就能批量出图, 配合 /history、/view 取回结果。注意接口格式与界面格式不通用, 别把 API JSON 拿去菜单里 Open。具体场景链路见工作流页。

04自定义节点与 ComfyUI-Manager

社区节点生态是 comfyui 可扩展性的来源。推荐先装 ComfyUI-Manager: 它提供节点列表管理、一键更新、以及导入工作流时最实用的「Install Missing Custom Nodes」—— 遇到红色节点时不用再逐个去 GitHub 搜仓库。手动安装则是把仓库 clone 进 custom_nodes, 装好依赖后重启服务。

操作位置 / 命令
安装 Managerclone 到 custom_nodes/ComfyUI-Manager 后重启
补齐缺失节点Manager → Install Missing Custom Nodes
手动装节点git clone <repo> custom_nodes/<name>
装节点依赖用便携版内置的 python 跑该节点的 requirements.txt
禁用某节点把目录改名加 .disabled 后缀后重启
提醒:自定义节点是第三方代码,会在本机执行。 只装自己了解来源的仓库,升级后若出现界面报错,先怀疑节点与新版前端不兼容,而不是急着重装整个程序。

完整官方手册在 docs.comfy.org, 源码与 Issue 在 GitHub; 中文速查与常见问题可继续看FAQ和从零教程。