快速结论:这个报错通常发生在远程服务器上运行 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 已确认根因。
解决步骤
- 先判断服务运行位置:若 WebUI 在远程服务器,不要在本地浏览器直接打开
http://127.0.0.1:7860,因为该地址指向本地电脑。 - 可优先尝试:在远程服务器启动时加上
--share,用 Gradio 输出的公网链接访问。Issue 中有用户反馈./start_linux.sh --share --listen可行;也可只加--share生成分享链接。 - 若只在同一局域网内访问,可尝试
--listen,并使用服务器的局域网地址(例如192.168.x.x:7860)访问;同时确认防火墙放行该端口。 - 若在远程 Jupyter Notebook 环境,按维护者建议使用 SSH 端口转发:把远程 Gradio 端口(默认 7860,端口被占用时可能为 7861 等)转发到本机端口,再在本地浏览器打开对应本地端口。
- WSL2 场景参考 WSL 安装指南中的端口转发说明,将 WSL2 内服务端口映射到 Windows 本机后再访问。
- 若使用 Nginx 反向代理,先确认后端服务确实在监听、代理目标端口正确,再检查
proxy_pass与防火墙;Issue 中该路径未确认解决。 - 若所有网络访问方式都失败,可尝试加载更小模型排除显存不足,但该方向未经 Issue 证实。
验证方法
重新启动 WebUI 后,确认终端给出的访问地址与你的访问方式匹配:使用 --share 时能打开 Gradio 分享链接;使用 --listen 时能从同网段设备访问服务器 IP 加端口;使用 SSH 端口转发时,本地浏览器访问转发后的本地端口能看到 WebUI 页面,而不是 127.0.0.1 refused to connect。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。
![[Bug]: aiohttp_openai drops `service_tier` from chat completion responses](https://www.chat-gpts.plus/wp-content/uploads/2026/10/47258-28448113-768x403.jpg)
![[Bug]: /v1/images/edits with no `image` part returns 500 with a raw Python TypeError instead of 400](https://www.chat-gpts.plus/wp-content/uploads/2026/10/42185-37908672-768x403.jpg)
