知仓学习社知仓学习社
设了监听还是进不去：--listen 0.0.0.0 后局域网/手机仍无法访问 8188 / 全站资源搜索
搜索 更新 2026-10-02
报错 077 网络、下载与访问（含国内网络环境） 有来源可查

设了监听还是进不去：--listen 0.0.0.0 后局域网/手机仍无法访问 8188

报错原文（原样） 
both --listen and --listen 0.0.0.0
检索关键词 --listen 0.0.0.0、listen argument does not work、unrecognized arguments: --listen、8188 端口、局域网无法访问、To see the GUI go to、防火墙
先看这一句 为了从手机/平板/另一台电脑访问，加了 --listen 0.0.0.0 启动，但对方浏览器依旧打不开 8188；有的版本甚至直接报 unrecognized arguments: --listen 无法启动。
适用版本 全版本通用；--listen 不带参数时的默认值在较新版本为 0.0.0.0,::（同时监听 IPv4 与 IPv6） · 核实日期 2026-09-26 · 状态 已核实
适用环境：Windows 便携版、秋叶/绘世整合包、ComfyUI Desktop、Linux + 云 GPU、Docker/服务器

现象与触发场景

常见触发场景：

  • Windows 防火墙拦截了入站 8188 端口
  • 参数写在了错误位置或旧版本不支持该参数写法
  • 便携版没改 bat，而是改了别的启动方式
  • 云服务器/容器安全组未放行该端口

根因

  • 服务端监听 0.0.0.0 只是让进程接受所有网卡的连接，是否可达还取决于主机防火墙与网络路径；Windows 默认会弹窗询问是否允许，误点「取消」后就一直被拦。
  • 参数位置错误会导致 argparse 报 unrecognized arguments（有用户在 --listen 前后混用别的方式时遇到），必须写在 main.py 之后、且 --listen 不带值时会默认监听 0.0.0.0,::。
  • 云平台/容器环境还有一层安全组或端口映射，光改 ComfyUI 参数不够。

解决步骤

已按「最可能有效」排序。请从上往下做，每做完一步用「验证」确认，不要一次改五处。

  1. 确认启动参数写对了并看到监听提示
    在 main.py 之后加 --listen 0.0.0.0 --port 8188（或直接 --listen，此时按 CLI 定义默认 0.0.0.0,::）。启动日志会打印可访问地址；把日志里给出的地址原样在局域网设备上打开。便携版请改 run_nvidia_gpu.bat，不要用其他入口启动。
    python main.py --listen 0.0.0.0 --port 8188
    # 便携版 bat 中追加参数
    .\python_embeded\python.exe -s ComfyUI\main.py --listen 0.0.0.0 --windows-standalone-build
  2. 放行 Windows 防火墙入站规则
    在本机用 ipconfig 查到局域网 IPv4 地址，然后从另一台设备 ping/telnet 该地址的 8188。telnet 不通基本就是防火墙问题。为 Windows 防火墙添加入站规则允许 TCP 8188（建议把配置文件限定为专用网络，避免在公共网络暴露服务）。
    netsh advfirewall firewall add rule name="ComfyUI 8188" dir=in action=allow protocol=TCP localport=8188 profile=private
    # 排查连通性
    Test-NetConnection -ComputerName <本机局域网IP> -Port 8188
  3. 云服务器/容器还要放行安全组与端口映射
    在云主机上除了服务监听，还要在控制台安全组放行端口；Docker 运行时需要用 -p 8188:8188 做端口映射，否则容器内监听 0.0.0.0 也无法从宿主机外访问。
    docker run -p 8188:8188 <镜像>
  4. 需要 HTTPS 时配对使用 TLS 参数
    通过 --tls-keyfile 与 --tls-certfile 同时指定密钥和证书才能启用 HTTPS，二者缺一不可（CLI 定义中明确写有 requires 关系）；只给其一会启动异常。
    python main.py --listen 0.0.0.0 --tls-keyfile key.pem --tls-certfile cert.pem

验证是否修好

在同一局域网的另一台设备浏览器打开 http://<本机局域网IP>:8188，能看到 ComfyUI 界面；手机端同样可开。若走 HTTPS，地址应为 https:// 且证书被浏览器接受。

补充说明

issue #3043 正文只有一张截图与一句 "both --listen and --listen 0.0.0.0"，无解决方案，故解决方案取自 CLI 参数定义（--listen 默认值与 --tls-keyfile/--tls-certfile 的依赖关系已从源码确认）与通用防火墙排查。把服务暴露到 0.0.0.0 会带来未授权访问风险，官方文档也提示 --listen 场景下 Manager 安全级别会相应收紧。

来源

按可信度排列：官方 issue / 官方文档 > 节点仓库 issue > 社区帖 > 中文社区文章。 链接以纯文本给出（本站不做站外跳转），需要核对时请自行复制到浏览器打开。
  1. [180] （官方 issue）　listen argument does not work · Issue #3043 · Comfy-Org/ComfyUI　https://github.com/Comfy-Org/ComfyUI/issues/3043
  2. [181] （官方 issue）　unrecognized arguments: --listen · Issue #781 · Comfy-Org/ComfyUI　https://github.com/Comfy-Org/ComfyUI/issues/781
  3. [29] （社区）　Recommended approach to enable local network access doesn't work - Com　https://forum.comfy.org/t/recommended-approach-to-enable-local-network-access-doesnt-work/1747
  4. 前端界面、浏览器与工作流加载（11 条）

这条报错要用到的东西

按本条报错所属的类别（网络、下载与访问（含国内网络环境））列出站内相关的下载包与板块入口。 它们不是「必须下载才能修好」，而是这一类问题里最常要动到的东西；具体怎么做，以上面的解决步骤为准。

ComfyUI 权重库（167 个文件 / 约 1187 GB）按 ComfyUI 的 models 目录分好类的 167 个权重文件 / 每个文件一份说明（放哪、被哪些工作流引用） 待挂载
模型档案按仓库看体积，估一下要下多久 板块

同一类别的其他条目

【067】启动或加载工作流时连不上 huggingface.co，控制台报最大重试次数已超过 有来源 【068】SSL 证书校验失败：CERTIFICATE_VERIFY_FAILED unable to get local issuer certificate 有来源 【069】transformers 报 We couldn't connect to 'https://huggingface.co' to load this file 有来源 【070】huggingface_hub 本地找不到文件：LocalEntryNotFoundError / EntryNotFoundError 含未核实 【071】Gated 仓库无权访问：需要登录并同意协议（Llama / Flux 等） 含未核实
这个解法对你有效吗 记录只存在你自己的浏览器里，不需要注册账号。

返回报错库