跳转到主要内容

​
常见问题

​
自定义 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。 需要避免的常见错误：
问题说明
文件位置错误Manager 文件如 __init__.py 直接放在 custom_nodes 目录中
双重嵌套文件夹安装为 custom_nodes/ComfyUI-Manager/ComfyUI-Manager
文件夹名称错误安装为 custom_nodes/ComfyUI-Manager-main
压缩格式从压缩文件安装但未正确解压
如果安装不正确，ComfyUI-Manager 可能看起来可以工作，但不会被识别为可更新，并可能导致重复安装。请删除它并通过 git clone 正确重新安装。

​
网络问题

​
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
选项描述
--skip-update跳过更新 extension-node-map.json
--skip-stat-update跳过更新 github-stats.json
--skip-all跳过两个更新步骤
为避免 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 文件位于：
  • 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
级别描述
strong不允许高风险和中风险功能
normal不允许高风险功能；中风险功能可用
normal-如果指定了 --listen 且不以 127. 开头，则不允许高风险功能；中风险功能可用
weak所有功能可用

​
功能风险级别

风险级别功能
高通过 git url 安装、pip install、安装不在默认频道中的自定义节点、修复自定义节点
中卸载/更新、安装默认频道中的自定义节点、恢复/删除快照、重启
低更新 ComfyUI
要通过 git URL 或 nightly 版本安装自定义节点，请在 config.ini 中设置 security_level = weak。

​
获取帮助

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