无法连接 127.0.0.1:8188：先确认服务实际在哪里运行

现象与适用范围

浏览器或脚本无法连接 ComfyUI。localhost 指的是发起访问的那台设备；本机、容器、Notebook、远程服务器和手机之间的地址含义不同，不能只复制一段固定 URL。

检索用原文或片段（具体编号、数值和文件名随环境变化）：

Connection refused
ECONNREFUSED
Failed to fetch

已核对的依据

官方 Portable 教程要求启动进程并使用其输出地址。原生 API 路由属于运行中的 ComfyUI 服务器；连接被拒绝是网络层现象，还没有进入 prompt 校验。 P07 D06 D09

需要区分的情况

1. 后端因依赖或显卡错误退出，浏览器只是访问了一个无人监听的端口。

2. 后端使用了不同端口、监听地址，或运行在容器/远程实例中。

3. 反向代理、端口映射、防火墙或平台访问入口没有对应实际服务。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 查看终端最早的启动错误和最终监听地址，确认进程仍存活，而非只看到启动脚本窗口。

第 2 步。 在服务所在机器先做本地访问，再检查容器或平台提供的映射入口，逐层缩小网络范围。

第 3 步。 脚本、浏览器和 WebSocket 分别核对主机、端口与协议；HTTPS 页面不要混用不安全的 HTTP/WS 路径。

第 4 步。 确需远程访问时使用带身份验证的受控入口，按平台文档配置；不要把未保护的 ComfyUI 直接暴露到公网。

如何判断处理有效

在目标客户端能够读取服务的轻量接口，再提交小任务验证；主页能打开但 WebSocket 不通仍需另查。

注意事项与尚未确认的部分

Failed to fetch 也可能表示 CORS 或证书问题，不只表示端口关闭。本文不代替特定云平台的公网入口配置。

资料核对日期：2026-09-21。本站未执行此工作流，未进行 GPU、最低显存或耗时测试。

原始资料

• P07 · Python errno。核对：2026-09-21。
• D06 · ComfyUI Portable Windows。核对：2026-09-21。
• D09 · ComfyUI Server API routes。核对：2026-09-21。

相关排查与操作

• Address already in use：查清占用端口的进程再启动
• WebSocket 有连接却收不到结果：按 prompt_id 跟踪终止状态
• 把工作流接入原生 API：从正确导出到取得 prompt_id