跳转到主要内容

​
常见问题

​
自定义 git 可执行文件路径

如果您的 git.exe 安装在系统默认位置以外的特定位置：
  1. 安装 ComfyUI-Manager 并运行一次 ComfyUI
  2. 打开 <USER_DIRECTORY>/default/ComfyUI-Manager/config.ini
  3. 在 git_exe = 中指定包含文件名的完整路径

​
ComfyUI-Manager 更新失败

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

​
Windows：Overlapped Object 错误

如果遇到 Overlapped Object has pending operation at deallocation on ComfyUI Manager load： 编辑 config.ini 并添加：

​
SSL 证书验证失败

如果遇到 SSL: CERTIFICATE_VERIFY_FAILED 错误： 编辑 config.ini 并添加：

​
安装问题

​
安装路径不正确

ComfyUI-Manager 文件必须位于 ComfyUI/custom_nodes/comfyui-manager。 需要避免的常见错误：
如果安装不正确，ComfyUI-Manager 可能看起来可以工作，但不会被识别为可更新，并可能导致重复安装。请删除它并通过 git clone 正确重新安装。

​
网络问题

​
GitHub 访问问题

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

​
Hugging Face 访问问题

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

​
扫描器故障排除

运行 scan.sh 脚本时：
  • 它通过拉取或克隆 custom-node-list.json 中列出的自定义节点到 ~/.tmp/default 来更新 extension-node-map.json
  • 它使用 GitHub API 更新 github-stats.json
为避免 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 中配置安全级别：

​
功能风险级别

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

​
获取帮助

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