ComfyPilotComfyPilot
文档 / 自定义节点 / 发布到 Manager

发布到 Manager

了解如何将自定义节点发布到 ComfyUI Manager 数据库,包括 git 要求和 custom-node-list.json 注册流程。

自定义节点 manager 更新于 2026-11-15

查看官方原文

发布到 Manager

了解如何将自定义节点发布到 ComfyUI Manager 数据库,包括 git 要求和 custom-node-list.json 注册流程。

使用 ComfyUI Manager

要让你的自定义节点通过 ComfyUI Manager 提供,你需要将其保存为 git 仓库(通常在 github.com), 然后在 ComfyUI Manager 的 git 仓库提交一个 Pull Request,在其中编辑 custom-node-list.json 以添加你的节点。 详细说明。

当用户安装节点时,ComfyUI Manager 会:

1. Git 克隆

git clone 该仓库,

2. 安装 Python 依赖

安装自定义节点仓库下 requirements.txt 中列出的 pip 依赖(如果存在),

pip install -r requirements.txt
提示 与所有 pip 情况一样,你的节点依赖可能会与其他自定义节点冲突。不要让你的 requirements.txt 比实际需要的更严格。

3. 运行安装脚本

如果自定义节点仓库中存在 install.py,则执行它。 \[!TIP] install.py 会从自定义节点的根路径执行

ComfyUI Manager 文件

如上所述,ComfyUI Manager 会使用一些文件和脚本来管理自定义节点的生命周期。这些都是可选的。

  • requirements.txt - 如上所述的 Python 依赖
  • install.py, uninstall.py - 安装或卸载自定义节点时执行 \[!TIP] 用户可以直接删除目录,因此不能依赖 uninstall.py 一定会被执行
  • disable.py, enable.py - 可选钩子。只有旧的 git-clone 流程在禁用或重新启用节点时会执行它们;现在界面的禁用/启用只是移动目录,因此不要依赖这两个脚本 \[!TIP] enable.py 只会在禁用的节点被重新启用时运行——它应仅用于撤销 disable.py 所做的更改 \[!TIP] 禁用自定义节点时,其目录会被移动到 ComfyUI/custom_nodes/.disabled/,存放期间 Comfy 会忽略该模块
  • node_list.json - 仅当自定义节点的 NODE\_CLASS\_MAPPINGS 模式不符合常规时才需要。

官方详情请参见 ComfyUI Manager 指南。