Stable Diffusion WebUI 本地部署指南
本指南基于 Windows 系统,适合 AI 绘画爱好者或初学者。我们将直接从环境配置开始,到运行界面,并重点解决国内网络环境下的常见下载问题。
环境准备
首先确保系统已安装以下依赖:
- Python 3.10.x:建议官网下载最新版,安装时勾选 Add Python to PATH。
- Git:用于拉取项目代码。
- 显卡驱动 + CUDA:NVIDIA 用户请更新驱动至最新,CUDA 版本需与 WebUI 要求匹配。
安装完成后,打开命令行输入 python --version 和 git --version 确认环境变量生效。
克隆项目仓库
使用 Git 命令拉取 AUTOMATIC1111 的官方仓库:
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
常见问题:连接重置错误
若遇到 OpenSSL SSL_read: Connection was reset, errno 10054,通常是网络证书验证问题。可关闭 HTTPS 证书验证后重试:
git config --global http.sslVerify false
再次执行 clone 命令即可。
启动与依赖安装
进入项目目录,双击运行 webui-user.bat 脚本。程序会自动创建虚拟环境并下载基础依赖库。
提示升级 pip?
若控制台提示需要升级 pip,复制报错中的命令在新窗口执行。例如:
H:\AI\stable-diffusion-webui\venv\Scripts\python.exe -m pip install --upgrade pip
注意路径需根据你的实际安装位置调整。升级完成后,重新运行 webui-user.bat。
国内网络环境优化
首次运行时,WebUI 会尝试自动安装 gfpgan、clip 等模型依赖。在国内网络下容易超时卡住,建议提前配置镜像源。
方法一:修改 pip 安装源
编辑 launch.py 文件,找到类似以下的代码段:
run_pip(f"install {gfpgan_package}", "gfpgan")
将其改为指定国内镜像源:
run_pip(f"install -i https://pypi.douban.com/simple/ {gfpgan_package}", "gfpgan")
同样方式修改 clip_package 和 open_clip_package。保存后重启脚本。
方法二:加速 GitHub 下载
若卡在 GitHub 资源下载,可在 launch.py 或 中涉及 GitHub 的 URL 前添加代理前缀。例如将 改为 。


