系统无法连接网络？图像处理软件卡在下载模型那一步怎么办

用 Stable Diffusion、ComfyUI 或者 Adobe Firefly 时，点开插件或加载在线模型，突然弹出「系统无法连接网络」——不是浏览器打不开网页，是软件自己连不上。这种情况特别容易发生在公司内网、校园网、或者刚重装完系统的电脑上。

先别急着重装软件

很多图像处理工具（比如 ControlNet 的预处理器、Diffusers 加载 Hugging Face 模型）默认走系统代理或直接调用系统 DNS。但 Windows/macOS 的网络设置和 Python 环境的网络行为经常不一致。你浏览器能刷小红书，不代表 Python 脚本能访问 huggingface.co。

快速自查三步

1. 看看终端能不能通
打开命令行（Windows 是 CMD/PowerShell，macOS 是 Terminal），输入：

ping huggingface.co

如果显示「请求超时」或「找不到主机」，说明系统底层就卡住了。

2. 检查是否开了代理但没全局
如果你用 Clash、Surge 或某宝买的加速器，记得确认「系统代理」已开启，且「绕过局域网和国内地址」选项没把 huggingface.co 误判成国内站（它域名是 .co，但服务器在境外）。

3. Python requests 自己试试
在 Python 中运行这段代码：

import requests
try:
    res = requests.get('https://huggingface.co', timeout=5)
    print('OK:', res.status_code)
except Exception as e:
    print('失败原因：', e)

如果报错 ConnectionError 或 Timeout，基本可以确定是网络栈问题，不是软件 Bug。

实测有效的解法

→ 临时换源（最常用）
比如用镜像站加载模型。Stable Diffusion WebUI 启动时加参数：

--huggingface-hub-cache "D:/sd/models/hub" --no-half-vae --xformers --disable-safe-unpickle --skip-torch-cuda-test

然后手动把模型文件下好扔进对应文件夹，再启动时加 --no-download 跳过联网校验。

→ 改 hosts（适合偶尔抽风）
去 https://github.com/racaljk/hosts 下最新版，替换本地 hosts 文件，重点确保 huggingface.co 和 cdn-lfs.huggingface.co 解析到正确的 IP（比如 151.101.1.217）。

→ 环境变量强制指定
在启动图像处理软件前，先设好环境变量（Windows PowerShell 示例）：

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
./webui.bat

注意端口要和你的代理工具实际监听端口一致。

顺手记两笔

某些国产图像工具（如美图秀秀专业版、稿定设计桌面端）会偷偷检测网络连通性来验证订阅状态，即使你离线也能用基础功能，它也会弹「系统无法连接网络」提醒你续费。这时候关掉软件后台进程、拔掉网线重试一次，往往就跳过了校验。

还有种情况：杀毒软件把 Python 进程或 webui-user.bat 当作可疑行为拦截了网络请求。右键点任务栏图标 → 打开防护日志，搜关键词「blocked」「connect」，找到记录后放行即可。