Stable Diffusion WebUI代理服务器强制使用问题分析

问题背景

在使用Stable Diffusion WebUI时，部分用户可能会遇到一个特殊问题：WebUI会强制使用系统配置的网络中转服务，即使该服务并未在浏览器或系统网络设置中显式配置。这种情况尤其影响那些需要通过特殊方式访问互联网但中转服务不允许本地主机连接的用户，导致WebUI启动失败。

问题现象

当用户启动Stable Diffusion WebUI时，系统会抛出错误信息："When localhost is not accessible, a shareable link must be created. Please set share=True or check your network settings to allow access to localhost"。这表明WebUI尝试通过中转服务访问本地主机，但由于网络配置不允许此类连接，导致启动失败。

根本原因分析

经过深入调查，发现该问题与Gradio框架（WebUI使用的Web界面框架）处理网络连接的方式有关。Gradio会自动检测并使用系统中设置的"http_network"环境变量，而不会考虑用户是否在浏览器或系统网络设置中禁用了中转服务。

在Windows系统中，某些应用程序（如PHP Composer）会在安装过程中创建"http_network"环境变量。即使用户在网络设置中禁用了中转服务，这个环境变量仍然存在，导致Gradio错误地认为应该使用网络中转服务。

解决方案

要解决此问题，用户可以采取以下步骤：

1. 打开系统环境变量设置（通过控制面板或搜索"环境变量"）
2. 在用户变量部分查找"http_network"变量
3. 如果存在，删除该变量
4. 确认更改并重启系统（某些情况下需要重启才能使更改生效）

技术细节

Gradio框架在处理网络连接时，会优先检查以下网络相关环境变量：

• http_network
• HTTP_NETWORK
• https_network
• HTTPS_NETWORK

这些环境变量的存在会覆盖系统级别的网络设置，导致Gradio强制使用网络中转服务。这种行为在大多数网络环境下是有益的，但在需要直接访问本地主机的情况下会产生问题。

预防措施

为避免类似问题，建议：

1. 在安装可能修改网络设置的软件时，注意其配置选项
2. 定期检查系统环境变量设置
3. 了解常用开发工具的网络行为特性
4. 在遇到网络连接问题时，首先检查环境变量设置

总结

Stable Diffusion WebUI强制使用网络中转服务的问题源于Gradio框架对环境变量的处理方式。通过理解这一机制，用户可以有效地诊断和解决相关问题。这一案例也提醒我们，在复杂的开发环境中，各种配置可能会以意想不到的方式相互影响，保持系统配置的清晰和简洁是避免问题的关键。