The url http://127.0.0.1:7860 cannot be opened in local browser

这个报错通常发生在远程服务器上运行 TextGen WebUI 后,用本机浏览器打开日志里打印的 http://127.0.0.1:7860 。127.0.0.1 只指向浏览器所在的这台电脑,不是远程服务器;应优先确认服务监听地址,以及是否做了端口转发或隧道。

快速结论:这个报错通常发生在远程服务器上运行 TextGen WebUI 后,用本机浏览器打开日志里打印的 http://127.0.0.1:7860。127.0.0.1 只指向浏览器所在的这台电脑,不是远程服务器;应优先确认服务监听地址,以及是否做了端口转发或隧道。

适用环境:Issue 已确认涉及远程服务器运行 TextGen WebUI(server.py 或 start_linux.sh)、WSL2、Gradio,Python 3.10(来自用户日志中的路径)。其余 PyTorch、CUDA、显卡、节点版本在 Issue 中未给出。

最快修复方案:Issue 中有用户反馈 ./start_linux.sh --share --listen 可行;也有人用 --share 生成 Gradio 链接访问。若在远程 Jupyter 环境,维护者建议用 SSH 端口转发,把 Gradio 默认端口映射到本机后再用浏览器打开。

注意事项:--share 会生成公网可访问链接,注意数据与访问权限;--listen 会让服务监听非回环地址,需自行配置防火墙;上述方案来自不同用户场景,并非官方针对该 Issue 的统一验证结论,仍无本地可直接复现的修复。

问题场景

用户把 TextGen WebUI 部署在远程服务器上,运行 server.py 且模型已加载成功,终端显示 Running on local URL: http://127.0.0.1:7860。随后在本地浏览器访问该地址失败。类似情况也出现在 WSL2 中,以及尝试用本地 IPv4、--listen、Nginx 反向代理访问时。

报错原文

The url http://127.0.0.1:7860 cannot be opened in local browser

Loaded the model in 14.64 seconds.
Running on local URL:  http://127.0.0.1:7860

To create a public link, set `share=True` in `launch()`.

部分用户还出现:

Could not create share link. Please check your internet connection or our status page: https://status.gradio.app.

原因分析

可能原因一:127.0.0.1 的语义被误解。127.x.x.x 只指向“本机”。在远程服务器上启动服务后,本地浏览器里的 127.0.0.1 指向的是你自己的电脑,而不是远程服务器,因此连不上。

可能原因二:服务只监听回环地址。Gradio 默认以 local URL 形式启动,未开放到局域网或公网地址;在 WSL2 场景下,Windows 本地浏览器与 WSL2 内部网络之间还需要端口转发。

可能原因三:远程环境网络隔离。远程服务器、WSL2、Nginx 代理或防火墙可能阻断 7860 端口,导致即使改了访问地址仍然拒绝连接。Issue 中有用户提到 Nginx 配置通过 nginx -t,但访问仍提示 localhost refused to connect,说明问题不一定只在 WebUI 本身。

其他用户的主观猜测:有评论认为显存不足也可能导致页面打不开,建议换小模型(如 2.7b)。该说法在 Issue 中没有被验证,可作为低优先级排查方向。

环境排查

  • 确认 WebUI 是运行在本机、远程 Linux 服务器,还是 WSL2 内。
  • 确认终端打印的是 local URL 还是 public/share URL,以及端口是 7860 还是 7861(端口被占用时 Gradio 会递增)。
  • 检查启动参数中是否包含 --share、--listen,或 launch() 中是否设置了 share=True、server_name、server_port。
  • WSL2 场景需确认是否已配置端口转发;Issue 引用了 WSL 安装指南的端口转发章节。
  • 远程服务器场景需确认安全组、防火墙、Nginx 反向代理是否放行对应端口。
  • 检查 Python 环境路径是否与日志一致;Issue 日志中出现过 Python 3.10 路径。
  • 如怀疑显存不足,可观察模型加载与推理日志,但这并非本 Issue 已确认根因。

解决步骤

  1. 先判断服务运行位置:若 WebUI 在远程服务器,不要在本地浏览器直接打开 http://127.0.0.1:7860,因为该地址指向本地电脑。
  2. 可优先尝试:在远程服务器启动时加上 --share,用 Gradio 输出的公网链接访问。Issue 中有用户反馈 ./start_linux.sh --share --listen 可行;也可只加 --share 生成分享链接。
  3. 若只在同一局域网内访问,可尝试 --listen,并使用服务器的局域网地址(例如 192.168.x.x:7860)访问;同时确认防火墙放行该端口。
  4. 若在远程 Jupyter Notebook 环境,按维护者建议使用 SSH 端口转发:把远程 Gradio 端口(默认 7860,端口被占用时可能为 7861 等)转发到本机端口,再在本地浏览器打开对应本地端口。
  5. WSL2 场景参考 WSL 安装指南中的端口转发说明,将 WSL2 内服务端口映射到 Windows 本机后再访问。
  6. 若使用 Nginx 反向代理,先确认后端服务确实在监听、代理目标端口正确,再检查 proxy_pass 与防火墙;Issue 中该路径未确认解决。
  7. 若所有网络访问方式都失败,可尝试加载更小模型排除显存不足,但该方向未经 Issue 证实。

验证方法

重新启动 WebUI 后,确认终端给出的访问地址与你的访问方式匹配:使用 --share 时能打开 Gradio 分享链接;使用 --listen 时能从同网段设备访问服务器 IP 加端口;使用 SSH 端口转发时,本地浏览器访问转发后的本地端口能看到 WebUI 页面,而不是 127.0.0.1 refused to connect。

参考来源

oobabooga/textgen #985

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 30798

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注