ComfyUI「Failed to Fetch Server Logs」：VPN、代理与防火墙修复指南
通过检查后端终端、127.0.0.1、VPN、代理、防火墙、浏览器请求和自定义节点，修复 ComfyUI「failed to fetch server logs」问题。
如果你搜索了 ComfyUI failed to fetch server logs、failed to fetch server logs comfy ui、ComfyUI failed to fetch，或页面显示 failed to fetch server logs，请先从浏览器外部着手排查。首先打开 ComfyUI 终端或启动窗口，寻找真正的后端错误。
浏览器消息通常意味着界面尝试从服务器读取日志时请求失败。在很多情况下，这只是第二层症状——真正的原因可能是后端崩溃、VPN/代理/防火墙/浏览器扩展或局域网路由拦截了请求路径，或者是某个自定义节点破坏了 UI。
如果 Manager 具体提示 failed to get custom node list，请使用 ComfyUI Failed to Get Custom Node List。如果主要症状是 Reconnecting...，请使用 ComfyUI Reconnecting Error。
最新的 GSC 数据显示，此查询有时会与 Manager 注册表错误混淆。区分方法很简单：server logs 指浏览器无法从正在运行或已崩溃的本地服务器读取后端日志；custom node list 指 ComfyUI Manager 无法获取注册表数据。
如果界面只显示 Failed to fetch，但你不确定失败的是 server logs、Manager、WebSocket 还是 workflow draft，请先看 ComfyUI "Failed to Fetch" 选择正确分支。
快速解答
如果你搜索了 "ComfyUI failed to fetch server logs" 或 failed to fetch server logs，请先完成以下检查：
- 打开 ComfyUI 终端或启动窗口，查找第一个真实的错误回溯。
- 在测试局域网 IP、代理 URL 或远程设备之前，先在本地测试
http://127.0.0.1:8188。 - 如果问题在安装或更新节点后出现，请先禁用自定义节点重启一次。
不要因为浏览器出现这条消息就重新安装 ComfyUI。先确认 Python 服务器是否仍在运行。
如果页面同时卡在重连状态，请使用 ComfyUI Reconnecting Error。如果问题具体出现在插件操作后的 Manager 中，请使用 ComfyUI Failed to Get Custom Node List。
精确错误日志
如果你的浏览器或终端界面显示以下任何错误消息，本指南适合你：
failed to fetch server logs
failed to fetch该错误通常是什么
| 搜索词或症状 | 通常含义 | 从这里开始 |
|---|---|---|
ComfyUI failed to fetch server logs | 浏览器无法从后端读取日志 | 检查 Python 服务器是否崩溃 |
启用 VPN 或代理时出现 failed to fetch | 请求路径被拦截或阻断 | 先关闭代理测试 http://127.0.0.1:8188 |
安装节点后出现 failed to fetch server logs | 自定义节点或前端扩展可能破坏了启动或 UI 路由 | 禁用自定义节点后启动一次 |
failed to fetch server logs 同时出现 Reconnecting... | 后端崩溃、WebSocket 失败或本地请求被阻断 | 检查终端后使用重连指南 |
failed to fetch versions from ComfyRegistry 或 Manager 注册表获取失败 | Manager 或注册表网络问题 | 使用 ComfyUI Failed to Get Custom Node List |
failed to fetch server logs 且 Manager 也无法加载列表 | 两个 fetch 问题可能共享同一个代理/防火墙原因 | 分别测试 127.0.0.1、原始 GitHub、VPN 和防火墙 |
快速诊断
| 现象 | 可能含义 | 第一步 |
|---|---|---|
| 浏览器显示"failed to fetch server logs"且 ComfyUI 离线 | 服务器可能已崩溃 | 检查终端或便携版启动窗口 |
| ComfyUI 仍可运行但日志无法加载 | 浏览器/API 请求失败 | 检查 DevTools 的 Network 和 Console |
| 安装自定义节点后开始出现 | 自定义节点或前端扩展冲突 | 禁用自定义节点后启动 |
| 仅通过局域网、代理、VPN 或远程访问时出现 | 网络、绑定地址、防火墙或认证问题 | 从 http://127.0.0.1:8188 测试 |
| 终端显示真实的错误回溯 | 回溯才是真正的问题 | 修复终端中的第一个错误 |
第一步：不要将浏览器消息视为根本原因
ComfyUI 有两个部分：
- Python 服务器和终端日志
- 浏览器界面
即使真正的问题在其他地方，浏览器也可能无法获取日志。始终先查找 Python 端的原始错误。
对于便携版安装，真实的启动日志通常在由 run_nvidia_gpu.bat 或 run_cpu.bat 打开的控制台窗口中。
对于手动安装，日志在你运行以下命令的终端中：
python main.py对于 Windows 上的 ComfyUI Desktop，ComfyUI 官方故障排查指南将用户指向以下路径下的桌面日志：
C:\Users\<username>\AppData\Roaming\ComfyUI\logs第二步：确认服务器仍在运行
打开：
http://127.0.0.1:8188如果无法加载，则日志获取消息是次要问题。服务器已离线、崩溃，或在不同的端口上监听。
如果你更改了端口，请检查实际使用的端口。在 Windows 上：
netstat -ano | findstr :8188如果没有任何进程在 8188 上监听，请重启 ComfyUI 并从头观察终端输出。
第三步：检查浏览器请求路径
如果 ComfyUI 页面仍然打开，按 F12 并检查：
- Console 选项卡中的 JavaScript 或 WebSocket 错误
- Network 选项卡中的失败请求
- 请求是否发往
127.0.0.1、localhost、局域网 IP 或代理域名
然后测试最简单的本地地址：
http://127.0.0.1:8188如果本地访问正常但局域网或代理访问失败，问题很可能与网络有关，而非 ComfyUI 安装损坏。
第四步：检查防火墙、杀毒软件、VPN 或代理工具
部分用户在本地安全工具、代理、远程隧道或浏览器扩展后面运行 ComfyUI。即使 Python 仍在运行，这些工具也可能阻断浏览器与 ComfyUI 之间的请求。
请尝试：
- 临时禁用 VPN 或代理工具
- 在干净的浏览器配置文件中测试
- 禁用激进的浏览器扩展
- 在 Windows 防火墙中放行 Python 或 ComfyUI
- 先在同一台机器上测试，再测试其他设备
如果允许 ComfyUI 通过防火墙能解决问题，说明环境本身并没有损坏，只是浏览器无法访问本地服务器端点。
第五步：禁用自定义节点后启动
自定义节点可以添加前端扩展、API、路由和依赖项。一个损坏的扩展可能导致 UI 的部分功能失效，而 ComfyUI 其他部分看起来仍在部分运行。
对于手动安装：
python main.py --disable-all-custom-nodes对于 Windows 便携版，复制你的启动 .bat 文件并添加：
--disable-all-custom-nodes如果消息消失了，使用二分法：
- 重新启用一半的自定义节点。
- 重启 ComfyUI。
- 如果问题重现，有问题的节点在那一半中。
- 重复直到找到该节点或前端扩展。
如需完整的插件排查路径，请使用 How to Fix ComfyUI Plugin Import Failed Errors。
如果同一台机器还显示 Manager 错误（例如注册表缺失或节点列表获取失败），请查阅 ComfyUI Failed to Get Custom Node List。
第六步：同步更新前端和依赖项
如果错误在更新后出现，请避免出现半更新状态的环境。
从 Git 更新 ComfyUI 时：
git pull不要盲目运行 pip install -r requirements.txt。
- 确认当前激活的是哪个 Python 环境（
where python或which python） - 检查
requirements.txt—— 确认它是否锁定了 torch、numpy 或 opencv 的版本 - 尽可能只安装缺失的包：
pip install <package-name> - 安装后运行
pip check验证没有引入冲突
如果你使用便携版 ComfyUI，请通过便携版文件夹中的嵌入式 Python 运行 pip。将包安装到系统 Python 中不会修复便携版环境。
更广泛的更新问题，请参见 ComfyUI Dependency Conflicts。
第七步：在修改之前保存真实日志
在重新安装或更新更多包之前，请保存：
- 完整的终端输出
- 浏览器 Console 错误
- 浏览器 Network 请求失败详情
- ComfyUI 版本
- Python 和 PyTorch 版本
- 自定义节点列表
- 触发问题的工作流
ComfyUI 官方故障排查指南在报告 Bug 时要求提供同类信息：系统信息、完整错误文本、浏览器控制台错误、截图、自定义节点和复现步骤。
干净基准环境示例
一次干净的 GitHub Windows 便携版测试达到了以下状态：
ComfyUI version: 0.20.1
ComfyUI frontend version: 1.42.15
Starting server
To see the GUI go to: http://127.0.0.1:8188同一环境报告了以下版本信息。你的 Python、PyTorch、CUDA、前端和 GPU 版本可能因下载的发布资产不同而有所差异：
Python version: 3.12.10
pytorch version: 2.11.0+cu126
Device: cuda:0 NVIDIA GeForce RTX 4070 Ti SUPER如果你的日志从未到达 Starting server，请先解决启动错误。浏览器无法从一个未完成启动的服务器获取日志。
按触发原因选择下一步
| 触发原因 | 最佳下一步指南 |
|---|---|
| 页面同时持续重连 | ComfyUI Reconnecting Error |
| Manager 大约同时出现问题 | ComfyUI Failed to Get Custom Node List |
启动始终未到达 Starting server | ComfyUI Startup Failed? How to Diagnose and Recover Faster |
| 错误在插件变更后开始出现 | How to Fix ComfyUI Plugin Import Failed Errors |
| 更新一次性修改了多个包 | ComfyUI Dependency Conflicts |
重新安装代价过高时
如果环境中包含真实的工作成果，不要从重装开始。完全重装可能让你损失：
- 模型路径
- 自定义节点配置
- 工作流假设
- 本地包修复
- 数小时的重新下载时间
请先判断失败原因是：
- 服务器离线
- 浏览器请求被阻断
- 自定义节点前端问题
- 依赖项漂移
- 端口或防火墙冲突
实用原则
如果 ComfyUI 仍能从 127.0.0.1 启动，请保留环境并调试请求路径，而不是直接重新安装。
Wonderful Launcher 的帮助
当环境变得难以分析时，Wonderful Launcher 非常有用：
- 安装了多个自定义节点
- 依赖项更新修改了 Python 包
- 终端日志包含多个警告
- 浏览器错误未显示第一个 Python 失败
- 你需要保留现有的模型和工作流
如果你在浏览器错误和终端日志之间陷入困境，下载 Wonderful Launcher，将其作为以恢复为导向的工具层使用，而不是先清除整个环境。
相关指南
- ComfyUI Reconnecting Error
- ComfyUI Startup Failed? How to Diagnose and Recover Faster
- ComfyUI Failed to Get Custom Node List
- ComfyUI Dependency Conflicts
来源参考
先按上面的步驟定位根因。还卡住时，可以下载 Wonderful Launcher 检查目前机器；启动器原生修复、任务日誌和執行階段检查会集中在一起。credits 只用於图片生成和按量工具。
下载 Wonderful Launcher查看 credits 方案这篇文件解決了你的問题嗎？
你的回饋会帮助我们優先補強真實 ComfyUI 排障文件。