Stable Diffusion WebUI 本地部署指南
本教程基于 Windows 系统，适合 AI 绘画爱好者或初学者。我们将从克隆项目、配置环境到运行界面，并附上常见网络问题的解决方案。
一、准备工作
在开始之前，请确保你的环境满足以下要求：
- Python 3.10.x
- Git（推荐官网下载最新版）
- 显卡驱动 + CUDA（NVIDIA 用户，建议驱动更新到最新版）
安装完成后，记得检查 Python 和 Git 是否已加入系统环境变量。
二、克隆项目仓库
使用如下命令克隆 AUTOMATIC1111 的 Web UI 项目：
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
🚧 常见问题：OpenSSL SSL_read: Connection was reset, errno 10054
这是网络导致的 Git 连接失败问题，通常是因为证书验证被阻断。
✅ 解决方法：
关闭 Git 的 HTTPS 证书验证：
git config --global http.sslVerify false
然后重新执行 clone 命令即可成功。
三、运行项目
1. 进入项目目录，双击运行：
stable-diffusion-webui\webui-user.bat
运行后会自动创建虚拟环境并下载依赖库。
🚧 问题：提示升级 pip？
✅ 解决方法：
根据提示复制升级命令，在新命令行中执行（路径根据你的安装位置可能不同）：
H:\AI\stable-diffusion-webui\venv\Scripts\python.exe -m pip install --upgrade pip
升级完成后，重新运行 webui-user.bat。
四、解决国内网络环境下载失败的问题
在首次运行时，WebUI 会自动安装一些依赖模型，例如：
gfpganclipopen-clip
若下载失败，你会在命令行中看到安装卡住或超时的报错，解决方案如下：
方法一：修改 pip 安装源为国内镜像
打开 stable-diffusion-webui\launch.py 文件，找到安装失败的部分。
例如：
run_pip(f"install {gfpgan_package}", "gfpgan")
改为：
run_pip(f"install -i https://pypi.douban.com/simple/ ", )
