故障排除

常见问题

自定义 git 可执行文件路径

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

1. 安装 ComfyUI-Manager 并运行一次 ComfyUI
2. 打开 <USER_DIRECTORY>/default/ComfyUI-Manager/config.ini
3. 在 git_exe = 中指定包含文件名的完整路径

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

ComfyUI-Manager 更新失败

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

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

Windows：Overlapped Object 错误

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

编辑 config.ini 并添加：

windows_selector_event_loop_policy = True

SSL 证书验证失败

如果遇到 SSL: CERTIFICATE_VERIFY_FAILED 错误：

编辑 config.ini 并添加：

bypass_ssl = True

安装问题

安装路径不正确

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

需要避免的常见错误：

网络问题

GitHub 访问问题

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

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

Hugging Face 访问问题

如果您对 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

如果您想指定 ~/.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 文件位于：

• ComfyUI v0.3.76+：<USER_DIRECTORY>/__manager/config.ini
• 旧版本：<USER_DIRECTORY>/default/ComfyUI-Manager/config.ini

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

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

security_level = normal

功能风险级别

获取帮助

如果您仍然遇到问题：

1. 查看 ComfyUI-Manager GitHub issues 寻找类似问题
2. 查看启动日志消息以获取错误详情
3. 加入 ComfyUI Discord 获取社区支持