跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonVScodeAI大前端

Stable Diffusion WebUI 本地部署教程

这篇教程围绕 Windows 下 AUTOMATIC1111 版 Stable Diffusion WebUI 的本地部署展开,覆盖了 Python、Git 和显卡环境准备,项目克隆,webui-user.bat 启动,pip 镜像与 GitHub 下载加速,模型目录放置,以及 HuggingFace 代理和 tokenizer 本地加载等常见问题处理。最后还说明了如何访问本地 WebUI、切换模型并进行首次出图测试。

奇形怪状发布于 2026/1/24更新于 2026/7/2318 浏览
Stable Diffusion WebUI 本地部署教程

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 会自动拉取一些依赖模型,比如:

  • gfpgan
  • clip
  • open-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}", )
"gfpgan"

clip_package、open_clip_package 也按同样方式处理。保存后关闭命令行,再重新运行 webui-user.bat。

如果你的版本里没有 launch.py,也可以在 launch_utils.py 里搜索 run_pip(...),思路是一样的,只是文件位置可能变了。

方式二:加速 GitHub 文件下载

有些版本在启动时还会从 GitHub 拉取文件,这时可以给原始地址套一层加速前缀,比如把:

https://github.com/...

改成:

https://github.moeyy.xyz/https://github.com/...

如果你在 launch.py 或 launch_utils.py 里看到相关 URL,也可以按这个思路统一替换。

五、首次加载模型

第一次进入 WebUI 时,它通常会自动下载一个默认模型,例如 v1-5-pruned-emaonly.ckpt。这个文件体积不小,约 4GB,下载时间完全取决于你的网络情况。

如果你已经有本地模型,也可以直接放到下面这个目录:

stable-diffusion-webui\models\Stable-diffusion\

支持的格式通常是 .ckpt 或 .safetensors。

遇到 ProxyError

如果启动时出现类似下面的错误:

ProxyError: ('Unable to connect to proxy', FileNotFoundError(2, 'No such file or directory'))

或者:

requests.exceptions.ProxyError: (MaxRetryError(...))

这类问题大多是代理配置残留导致的。处理方式很直接:

  • 关闭系统代理
  • 关闭你在 WebUI 中设置过的代理参数
  • 退出命令行后重新运行 webui-user.bat

重新启动后,程序会按正常网络路径继续尝试连接。

命令行卡住不动

有时候下载过程看起来像'死机'一样,其实只是网络慢或者某个环节在重试。

这时可以直接关闭命令行窗口,再重新运行 webui-user.bat。很多情况下,程序会接着之前的进度继续,或者跳过已经完成的部分。

六、设置代理加速 HuggingFace 下载

如果你在加载模型时看到类似下面的报错:

OSError: Can't load tokenizer for 'openai/clip-vit-large-patch14'

这通常说明程序需要从 HuggingFace 下载 tokenizer 文件,但网络没通。

方法一:在 webui-user.bat 中设置代理

你可以在 webui-user.bat 开头加上环境变量,示例如下:

:: 启用代理(如 Clash 使用 HTTP 代理 7890 端口)
set HTTP_PROXY=http://127.0.0.1:7890
set HTTPS_PROXY=http://127.0.0.1:7890

:: 如果你用的是 SOCKS5 代理(如 V2Ray、Trojan)
:: set ALL_PROXY=socks5://127.0.0.1:1080

保存后重新运行即可。一般来说,本地代理工具配合 HTTP 端口使用会更省事。

方法二:把 CLIP Tokenizer 手动放到本地

如果你不想依赖在线下载,也可以直接把 tokenizer 文件下载到本地。

需要准备这 4 个文件:

  • vocab.json
  • merges.txt
  • tokenizer_config.json
  • special_tokens_map.json

然后把它们放到下面这个目录:

stable-diffusion-webui\models\clip-vit-large-patch14\

接着打开 ldm\modules\encoders\modules.py,找到:

self.tokenizer = CLIPTokenizer.from_pretrained(version)

改成:

self.tokenizer = CLIPTokenizer.from_pretrained("models/clip-vit-large-patch14")

这样一来,程序就会优先从本地读取 tokenizer,而不是每次都去联网拉取。若你需要确认文件来源,可以在 HuggingFace 的对应模型页面查看文件列表并手动下载。

七、切换其他模型

如果你手头还有别的 .ckpt 或 .safetensors 模型,直接放进这个目录就行:

stable-diffusion-webui\models\Stable-diffusion\

放好之后,打开 WebUI,在右上角的模型下拉框里切换即可。这个过程没有什么额外技巧,关键是路径别放错。

八、部署成功后的使用与测试

当命令行出现下面这行内容时,说明服务已经起来了:

Running on local URL: http://127.0.0.1:7860

这时候直接打开浏览器访问这个地址,就能进入 WebUI 页面。

试着生成一张图

页面里最核心的输入框是 Prompt。你可以先用一个简单的测试提示词验证环境是否正常,例如:

Official portrait of Groot as substitute teacher

如果页面能正常返回图片,说明本地部署已经跑通了。

常用参数怎么理解

第一次上手时,不必把所有参数都调得很复杂。下面几个先记住就够了:

  • Sampler:采样器,默认即可,常见如 Euler a、DDIM
  • Steps:步数,通常 20~30 就能得到不错的结果;越高越慢,也可能更细
  • Width / Height:分辨率,常见从 512×512 起步,显存紧张时适当调低
  • Seed:种子,默认随机;固定一个值后,可以复现相似结果
  • CFG Scale:引导强度,通常 7~9 比较常用,数值越高越'听话',但也可能更僵硬

点击生成

参数填好后,点一下生成按钮,等几秒到几十秒,图片就会出现在页面中。速度主要取决于显卡性能、显存大小和当前模型负载。

附录:常见问题速查

问题原因处理方式
OSError: Can't load tokenizer for openai/clip-vit-large-patch14HuggingFace 网络不通本地下载 tokenizer,或配置代理
ProxyError系统代理配置残留关闭系统代理并清理相关环境变量
命令行卡住不动下载缓慢或连接受限关闭窗口后重启,通常可以继续
xformers 报错未安装非必要模块缺失可先忽略,或按需安装

如果前面几个环节都正常,WebUI 本地部署基本就算完成了。后续你只需要把模型放进正确目录,按需调整参数,就可以开始做自己的出图实验。

目录

  1. Stable Diffusion WebUI 本地部署教程(AUTOMATIC1111 版)
  2. 一、准备工作
  3. 二、克隆项目仓库
  4. 遇到 OpenSSL SSL_read: Connection was reset, errno 10054
  5. 三、运行项目
  6. 提示升级 pip 怎么办
  7. 四、国内网络环境下的下载处理
  8. 方式一:给 pip 换国内镜像
  9. 方式二:加速 GitHub 文件下载
  10. 五、首次加载模型
  11. 遇到 ProxyError
  12. 命令行卡住不动
  13. 六、设置代理加速 HuggingFace 下载
  14. 方法一:在 webui-user.bat 中设置代理
  15. 方法二:把 CLIP Tokenizer 手动放到本地
  16. 七、切换其他模型
  17. 八、部署成功后的使用与测试
  18. 试着生成一张图
  19. 常用参数怎么理解
  20. 点击生成
  21. 附录:常见问题速查
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • KingbaseES 从 HTAP 到 AI 加速的未来演进之路
  • spdlog 日志库嵌入式 Linux C++使用指南
  • SenseVoice-Small 语音识别模型 Gradio 前端定制与 API 扩展
  • GitNexus:零服务器代码智能引擎,为 AI Agent 构建代码库知识图谱
  • 全栈分页方案:MyBatisPlus 与 Thymeleaf 整合实现
  • 2024 年全职 AI 产品经理转型时机分析
  • Stable Diffusion v1.5 创意设计师指南:嵌入 Figma/PS 工作流
  • Python+AI 入门指南:从零基础到实战落地
  • Python 异步编程与协程实战指南
  • Spring Boot 考试安排管理系统设计与实现
  • SketchUp STL 插件实战:优化 3D 打印模型导出流程
  • Python 金融数据 API 实战:Finnhub 接入与优化
  • 深度视觉赋能足式机器人极限运动与跑酷技术解析
  • 项目实战:使用 three.js+vue3+ts 完成 VR 全景看房应用
  • Java static 避坑:静态与非静态访问规则全解析
  • Python 从入门到精通的学习计划与进阶指南
  • 蓝桥杯 C/C++ 组备考:C++ 基础知识入门(上)
  • Amazon Q 深度解析:生成式 AI 驱动的企业级智能助手与开发辅助
  • 华为 OD 机试:补种未成活胡杨
  • Git 原理与使用详解(上):版本控制核心架构与基础操作

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online