文档 /
自定义节点 /
发布到 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 指南。