ComfyUI Manager 加载插件列表时长时间转圈，通常意味着请求 GitHub 的 REST API 没有正常返回。这个过程的链路并不复杂：Manager 启动后向 api.github.com 请求插件索引与仓库元数据，如果当前 IP 的匿名请求次数已经超过 GitHub 限制，服务端会返回 403 或 429 状态码，Manager 只能显示为空或持续加载。接下来从限流判断、Token 配置和代理设置三个方向解决问题。
一、先确认是不是 GitHub API 限流
GitHub 对未认证的 REST API 请求有严格的频率限制。通过 curl 直接请求一个轻量接口可以快速判断：
curl -i https://api.github.com/rate_limit
返回内容里如果 x-ratelimit-remaining 为 0，或者 message 中包含 API rate limit exceeded，说明当前网络出口的 IP 已经触发限制。未认证请求每小时只有 60 次，而 ComfyUI Manager 一次刷新可能调用搜索、标签、仓库详情等多个接口，连续几次操作就会耗尽。注意这个限额是按出口公网 IP 统计，不是按电脑或 ComfyUI 实例统计。家庭宽带、公司网络、机房 NAT 共享出口时，只要有其他用户也在请求 GitHub API，限制会更快到来。
常见状态码与处理方向可以参考下表：
| 状态码 | 含义 | 处理方向 |
|---|---|---|
| 403 | API rate limit exceeded | 配置 Token 或更换出口 IP |
| 429 | 请求过于频繁 | 降低刷新频率，加入重试间隔 |
| 401 | Token 无效或过期 | 重新生成并更新配置文件 |
| 502 / 504 | 网关错误或超时 | 检查代理节点与镜像可用性 |
还有一种情况是请求没有到达 GitHub，而是被本地网络或者 DNS 干扰。此时 curl 会卡住、超时或返回连接重置，与限流表现不同。可以先执行 curl -v https://api.github.com 查看 TLS 握手是否完成。若长时间停留在 Connecting，说明代理或 DNS 才是主要问题，需要优先处理网络链路。
二、配置 GitHub Personal Access Token 提升配额
解决限流最直接的办法是让 Manager 使用认证请求。登录 GitHub，进入 Settings、Developer settings、Personal access tokens，生成一个经典 token。权限不需要勾选仓库写权限，只需要公开仓库的读取能力即可。生成后复制 token，注意 token 只显示一次，关闭页面后就无法再次查看。
ComfyUI Manager 支持在界面中填写 GitHub Token，也可以写入配置文件。配置文件通常位于 ComfyUI 根目录下的 ComfyUI-Manager/config.ini，在 [default] 段增加或修改：
[default] github_token = ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
保存后重启 ComfyUI。已经认证的请求配额会从每小时 60 次提升到 5000 次，足够日常刷新与安装插件。不要将 token 提交到公开仓库，也不要截图分享。若使用容器部署，token 应通过环境变量注入，避免写死在镜像中。注意 ComfyUI Manager 在较新版本中可能优先读取界面设置，配置文件不生效时可以打开 Manager 设置面板，检查是否存在独立的 token 输入框。
三、为 Git 与 ComfyUI 配置代理
如果网络无法稳定访问 api.github.com，仅靠 token 仍然无法完成请求。此时需要让 ComfyUI 和 Git 都走本地代理。常见代理软件会在本机监听 HTTP 或 SOCKS5 端口，例如 127.0.0.1:7890。为当前终端设置环境变量后启动 ComfyUI：
# Linux / macOS export HTTP_PROXY=http://127.0.0.1:7890 export HTTPS_PROXY=http://127.0.0.1:7890 python main.py
Windows 使用 PowerShell 时：
$env:HTTP_PROXY = "http://127.0.0.1:7890" $env:HTTPS_PROXY = "http://127.0.0.1:7890" python main.py
如果 ComfyUI 内有插件调用 Git 命令，还需要单独配置 Git 代理：
git config --global http.proxy http://127.0.0.1:7890 git config --global https.proxy http://127.0.0.1:7890
如果 ComfyUI 运行在 WSL2 或 Docker 容器中，本机代理地址不能使用 127.0.0.1，因为容器内部回环地址指向容器自身。此时需要改为宿主机在虚拟网络中的地址，例如 http://172.17.0.1:7890，并确保代理软件开启了允许局域网连接。
对于无法使用代理的环境，可以尝试替换 ComfyUI Manager 的 GitHub 镜像基础地址。部分镜像会缓存 GitHub API 响应，但需要注意 token 会随请求发送到镜像服务方，敏感环境应避免使用第三方镜像。若有自建网关，可以部署一个转发服务，仅代理 api.github.com 与 raw.githubusercontent.com 两个域名。
四、验证修复并避免再次限流
完成 token 或代理配置后，重新打开 ComfyUI Manager 的插件列表，观察是否在数秒内出现内容。还可以在命令行再次请求 rate_limit，此时剩余次数应显示接近 5000，并带有认证信息。
长期使用建议定期检查代理端口是否变化，因为代理软件更新或重启后本地端口可能不同。如果再次出现加载失败，优先查看 ComfyUI 控制台日志，重点搜索 403、429、connection reset 等关键字。对于共享出口 IP 的用户，token 仍然是性价比最高的方案，因为它不受其他用户请求影响；代理主要用于解决链路阻断，两者结合可以覆盖大部分 ComfyUI Manager 插件列表加载异常。
ComfyUI ManagerGitHub API限流代理配置修改时间：2026-08-25 15:22:05