ValueError: When localhost is not accessible, a shareable link must be created. Please set share=True or check your proxy settings to allow access to localhost.

这个报错通常出现在启动 Stable Diffusion WebUI Forge 时,Gradio 无法访问 localhost,于是要求创建 shareable link。优先排查本机代理设置,尤其是 no_proxy 是否包含 localhost 与 127.0.0.1。

快速结论:这个报错通常出现在启动 Stable Diffusion WebUI Forge 时,Gradio 无法访问 localhost,于是要求创建 shareable link。优先排查本机代理设置,尤其是 no_proxy 是否包含 localhost 与 127.0.0.1。

适用环境:Issue 中确认的是 Stable Diffusion WebUI Forge;涉及的启动脚本为 webui-user.bat;Issue 讨论中提到的依赖为 pydantic。Issue 未提供操作系统、Python、CUDA、PyTorch、显卡等具体版本信息。

最快修复方案:Issue 评论中给出的做法是:用 Visual Studio 等代码阅读/编辑器打开 webui-user.bat,手动加入 set no_proxy=localhost, 127.0.0.1, ::1。

注意事项:该做法来自社区评论,属于用户自行验证可行的绕过方式,不是官方结论;若同时存在系统级代理、HTTP_PROXY/HTTPS_PROXY 或其他网络工具,仍可能影响 Gradio 访问 localhost。评论中另提到可尝试降级 pydantic==2.10.6,但 Issue 未确认这一步能解决本问题,可优先尝试。

问题场景

用户在启动 Stable Diffusion WebUI Forge 时,Gradio 启动阶段检测到无法访问 localhost,抛出 ValueError 并中止。该问题与启动脚本、代理环境以及 Gradio 本机回环访问有关,不涉及具体的模型、采样节点或生成流程。

报错原文

ValueError: When localhost is not accessible, a shareable link must be created. Please set share=True or check your proxy settings to allow access to localhost.

原因分析

最可能的原因是当前环境中的代理设置没有把 localhost、127.0.0.1 和 ::1 排除在代理之外,导致 Gradio 无法直接访问本机回环地址。Issue 评论中引用了 TaskMatrix 的相关讨论,并指出需要在 webui-user.bat 中显式设置 no_proxy。另有评论提到 pydantic 版本可能相关,并建议尝试 pydantic==2.10.6,但该方向在 Issue 中没有被明确确认。

环境排查

  • 确认启动脚本:是否使用 webui-user.bat 启动 Stable Diffusion WebUI Forge。
  • 确认代理变量:检查系统中是否设置了 HTTP_PROXY、HTTPS_PROXY 或类似代理变量。
  • 确认 no_proxy:检查 no_proxy 是否包含 localhost、127.0.0.1、::1。
  • 确认依赖版本:Issue 评论提到 pydantic,可检查当前 pydantic 版本是否与评论中的 2.10.6 不一致;但 Issue 未给出该版本必然有效的结论。
  • 确认编辑器方式:Issue 评论建议用 Visual Studio 等代码阅读程序打开脚本,而不是仅用记事本,以便正确编辑启动脚本。

解决步骤

  1. 用 Visual Studio 或其他代码编辑器打开 Stable Diffusion WebUI Forge 目录下的 webui-user.bat。
  2. 在脚本中手动加入:set no_proxy=localhost, 127.0.0.1, ::1。Issue 评论指出,这正是用户需要手动补充的内容。
  3. 保存脚本并重新运行 webui-user.bat,观察 Gradio 是否仍抛出该 ValueError。
  4. 如果问题仍然存在,可优先尝试评论中提到的降级 pydantic 到 2.10.6,但需注意这并非 Issue 已确认的因果修复。

验证方法

重新启动 Stable Diffusion WebUI Forge 后,如果不再出现 ValueError: When localhost is not accessible, a shareable link must be created. Please set share=True or check your proxy settings to allow access to localhost.,并且 Gradio 能正常启动本地 WebUI 界面,即可认为该问题已解决。若仍报错,说明代理或依赖层面可能还有其他因素。

参考来源

lllyasviel/stable-diffusion-webui-forge #1479

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 25744

发表回复

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