ComfyUI Manager 故障排除

解决常见的 ComfyUI-Manager 问题，包括自定义 git 可执行文件路径、数据库错误、更新失败等。

常见问题

如果您的 git.exe 安装在系统默认位置以外的特定位置：

git_exe = C:\Program Files\Git\bin\git.exe

如果更新 ComfyUI-Manager 本身失败，请进入 ComfyUI-Manager 目录并运行：

git update-ref refs/remotes/origin/main a361cc1 && git fetch --all && git pull

如果遇到 Overlapped Object has pending operation at deallocation on ComfyUI Manager load：

编辑 config.ini 并添加：

windows_selector_event_loop_policy = True

如果遇到 SSL: CERTIFICATE_VERIFY_FAILED 错误：

编辑 config.ini 并添加：

bypass_ssl = True

ComfyUI-Manager 文件必须位于 ComfyUI/custom_nodes/comfyui-manager。

需要避免的常见错误：

问题	说明
文件位置错误	Manager 文件如 `__init__.py` 直接放在 `custom_nodes` 目录中
双重嵌套文件夹	安装为 `custom_nodes/ComfyUI-Manager/ComfyUI-Manager`
文件夹名称错误	安装为 `custom_nodes/ComfyUI-Manager-main`
压缩格式	从压缩文件安装但未正确解压

[!WARNING] 如果安装不正确，ComfyUI-Manager 可能看起来可以工作，但不会被识别为可更新，并可能导致重复安装。请删除它并通过 git clone 正确重新安装。

如果您对 GitHub 的访问受限，请设置 GITHUB_ENDPOINT 环境变量：

GITHUB_ENDPOINT=https://mirror.ghproxy.com/https://github.com

如果您对 Hugging Face 的访问受限，请设置 HF_ENDPOINT 环境变量：

HF_ENDPOINT=https://some-hf-mirror.com

运行 scan.sh 脚本时：

它通过拉取或克隆 custom-node-list.json 中列出的自定义节点到 ~/.tmp/default 来更新 extension-node-map.json
它使用 GitHub API 更新 github-stats.json

[!TIP] 为避免 GitHub API 速率限制，请设置您的令牌：export GITHUB_TOKEN=your_token_here

如果您想指定 ~/.tmp/default 以外的不同路径，请直接运行 python scanner.py [path] 而不是 scan.sh。

如果您在通过 git URL 安装自定义节点或使用 nightly 版本时遇到错误 This action is not allowed with this security level configuration，您需要在 config.ini 文件中调整安全级别。

config.ini 文件位于：

其中 <USER_DIRECTORY> 默认为 ComfyUI/user。详情请参阅配置。

在 config.ini 中配置安全级别：

security_level = normal

级别	描述
`strong`	不允许高风险和中风险功能
`normal`	不允许高风险功能；中风险功能可用
`normal-`	如果指定了 `--listen` 且不以 `127.` 开头，则不允许高风险功能；中风险功能可用
`weak`	所有功能可用

风险级别	功能
高	通过 git url 安装、pip install、安装不在默认频道中的自定义节点、修复自定义节点
中	卸载/更新、安装默认频道中的自定义节点、恢复/删除快照、重启
低	更新 ComfyUI

[!TIP] 要通过 git URL 或 nightly 版本安装自定义节点，请在 config.ini 中设置 security_level = weak。

如果您仍然遇到问题：