Stable Diffusion WebUI 本地部署教程(AUTOMATIC1111 版)
这篇内容以 Windows 环境为例,目标很明确:把 AUTOMATIC1111 的 Stable Diffusion WebUI 从下载安装到能够正常出图,尽量把常见的网络、依赖和模型加载问题一次讲透。
一、准备工作
在开始之前,先把基础环境准备好:
- Python 3.10.x
- Git
- NVIDIA 显卡驱动及 CUDA 环境(如果你使用的是 NVIDIA 显卡)
安装完成后,确认 Python 和 Git 已经加入系统环境变量。否则后面即使命令写对了,也可能因为找不到可执行文件而卡住。
二、克隆项目仓库
先把 WebUI 项目拉到本地:
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,一般就能继续下载了。下载完成后,如果你习惯更严格的网络策略,也可以再把这个设置恢复掉。
三、运行项目
进入项目目录后,直接双击运行:
stable-diffusion-webui\webui-user.bat
第一次启动时,它会自动创建虚拟环境,并开始安装依赖。这个阶段耗时会比较明显,耐心等一下很正常。
提示升级 pip 怎么办
如果命令行提示你升级 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/ {gfpgan_package}", )


