Windows 安装 Stable Diffusion WebUI 及问题解决记录

本文将详细介绍 stable diffusion webui 的下载、安装及问题解决。
Stable Diffusion 是 2022 年发布的深度学习文本到图像生成模型。它主要用于根据文本的描述产生详细图像，尽管它也可以应用于其他任务，如内补绘制、外补绘制，以及在提示词（英语）指导下产生图生图的翻译。它是一种潜在扩散模型，由慕尼黑大学的 CompVis 研究团体开发的各种生成性人工神经网络。它是由初创公司 StabilityAI，CompVis 与 Runway 合作开发的，并得到 EleutherAI 和 LAION 的支持。
其它问题请参考：
运行使用时问题《Windows 使用 Stable Diffusion 时遇到的各种问题整理》；
模型运用及参数《Stable Diffusion 个人推荐的各种模型及设置参数、扩展应用等合集》；
提示词生图咒语《Stable Diffusion 提示词词缀使用指南（Prompt）》；
不同类的模型Models说明《解析不同种类的 Stable Diffusion 模型 Models》；
绘制人物动作及手脚细节《Stable Diffusion 准确绘制人物动作及手脚细节（需 ControlNet 扩展）》；
各种风格对比及实际运用《AI绘图风格对照表/画风样稿详细研究记录及经验总结》；

一、环境准备

（一）硬件方面：

1. 显存

4G 起步，4G 显存支持生成 512*512 大小图片，超过这个大小将卡爆失败。

2. 硬盘

10G 起步，模型基本都在 5G 以上，有个 30G 硬盘不为过吧？现在硬盘容量应该不是个问题。

（二）软件方面：

1. Git

https://git-scm.com/download/win
下载最新版即可，对版本没有要求。

2. Python

https://www.python.org/downloads/
截止发稿（2023.3.6）时，最高版本只能用 3.10.*，用 3.11.* 会出问题。

3. Nvidia CUDA

https://developer.download.nvidia.cn/compute/cuda/11.7.1/local_installers/cuda_11.7.1_516.94_windows.exe
版本 11.7.1，搭配 Nvidia 驱动 516.94，可使用最新版。

4. stable-diffusion-webui

https://github.com/AUTOMATIC1111/stable-diffusion-webui
核心部件当然用最新版本~~但注意上面三个的版本的兼容性。

5. 中文语言包

https://github.com/VinsonLaro/stable-diffusion-webui-chinese
下载 chinese-all-0306.json 和 chinese-english-0306.json 文件

6. 扩展（可选）

https://github.com/Mikubill/sd-webui-controlnet
下载整个 sd-webui-controlnet 压缩包

https://huggingface.co/Hetaneko/Controlnet-models/tree/main/controlnet_safetensors
https://huggingface.co/lllyasviel/ControlNet/tree/main/models
https://huggingface.co/TencentARC/T2I-Adapter/tree/main
试用时先下载第一个链接中的 control_openpose.safetensors 或第二个链接中的 control_sd15_openpose.pth 文件

7. 模型

https://huggingface.co/models
https://civitai.com
可以网上去找推荐的一些模型，一般后缀名为 ckpt、pt、pth、safetensors ，有时也会附带 VAE（.vae.pt）或配置文件（.yaml）。

类型	文件格式	存放目录	备注
check point	.ckpt，.safetensors	\models\Stable-diffusion	文件较大
vae	名字带有 vae 的	\models\vae	细节更好地恢复，特别是眼睛和文字
Textual Inversion	*.pt	\embeddings	一般文件很小，额外的 tag
Lora	*.pt	\models\Lora	调整模型，理解为风格化也可以
Hypernetworks	.pt，.ckpt，*.safetensors	\models\hypernetworks	和 lora 工作方式相似，算法不同

这里可以学习一下模型的基本概念《解析不同种类的 Stable Diffusion 模型 Models，再也不用担心该用什么了》

二、安装流程

1. 安装 Git

就正常安装，无问题。

2. 安装 Python

建议安装在非 program files、非 C 盘目录，以防出现目录权限问题。
注意安装时勾选 Add Python to PATH，这样可以在安装时自动加入 windows 环境变量 PATH 所需的 Python 路径。

3. 安装 Nvidia CUDA

正常安装，无问题。

4. 安装 stable-diffusion-webui

国内需要用到代理和镜像，请按照下面的步骤操作：

a) 编辑根目录下 launch.py 文件
将 https://github.com 替换为 https://ghproxy.com/https://github.com，即使用 Ghproxy 代理，加速国内 Git。
如图将代码中所有类似地址都改掉（注意：不仅仅是图中所展示的这些）。

b) 执行根目录下 webui.bat 文件
根目录下将生成 tmp 和 venv 目录。

c) 编辑 venv 目录下 pyvenv.cfg 文件
将 include-system-site-packages = false 改为 include-system-site-packages = true。

d) 配置 python 库管理器 pip
方便起见，在 \venv\Scripts 下打开 cmd 后执行如下命令：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/ # 镜像
pip freeze > requirements_versions.txt # 创建文件
pip install -r requirements_versions.txt # 执行此条命令前，请检查你的剩余磁盘空间
pip install xformer # 如果不执行此条命令，启动 Stable Diffusion 时可能会出现错误。xformer 还可以在后续使用中降低显卡占用。

xformer 会安装到 \venv\Lib\site-packages 中，安装失败可以用 pip install -U xformers 命试试。

e) 安装语言包
将文件 chinese-all-0306.json 和 chinese-english-0306.json 放到目录 \localizations 目录中。
运行 webui 后进行配置，操作方法见下。

f) 安装扩展（可选）
将 sd-webui-controlnet 解压缩到 \extensions 目录中。
将 control_sd15_openpose.pth 文件复制到 /extensions/sd-webui-controlnet/models 目录中。
不同的扩展可能还需要安装对应的系统，比如 controlnet 要正常使用则还需要安装 ffmpeg 等。

g) 安装模型
下载的各种模型放在 \models\Stable-diffusion 目录中即可。

h) 再次执行根目录下 webui.bat 文件
用浏览器打开 webui.bat 所提供的网址即可运行。

其中提供了网址：http://127.0.0.1:7860。

打开该网址后在 Settings -> User interface -> Localization (requires restart) 设置语言，在菜单中选择 chinese-all-0220（前提是已经在目录中放入了对应语言包，见上），点击 Apply Settings 确定，并且点击 Reload UI 重启界面后即可。

好了，现在可以开始使用了~~

三、问题及注意点

1. python 版本错误

错误：

ERROR: Could not find a version that satisfies the requirement torch==1.13.1+cu117
ERROR: No matching distribution found for torch==1.13.1+cu117

这是由于 python 版本不对导致的（上面提过了，截止发稿时不能追求新版本），要用 python 3.10.* 版本。
解决来源：https://github.com/AUTOMATIC1111/stable-diffusion-webui/issues/7166

2. pip版本错误

警告：

[notice] A new release of pip available: 22.3.1 -> 23.0.1
[notice] To update, run: D:\stable-diffusion-webui\venv\Scripts\python.exe -m pip install --upgrade pip

提示中已经给出了解决方案：
在 \venv\Scripts\ 目录中打开 cmd，执行

python.exe -m pip install --upgrade pip

3. 安装或执行停滞

如果在执行 webui.bat 进行包下载安装时或者生成图片时会卡很久都没反应，那么这时可以复制包名，进入 python 安装目录或 \venv\Scripts\ 目录中打开 cmd，执行

pip install 包名

也可以通过任务管理查看网络状态，如果网络在玩命下载，那么就等着吧~~

4. xFormers 安装不上

很多同学都反应 xformers 无法安装，可以用以下的方法试试：

检查 Dreambooth 要求的 Python 版本：
如果您的 Python 版本低于 3.6，请安装最新的 Python 版本，并重复尝试安装 xformers。

# 据此可以在终端中运行以下命令，以检查您的 Python 版本：
python --version

安装依赖项：xformers 有许多依赖项，如果这些依赖项没有正确安装可能会导致升级失败。您可以尝试安装以下依赖项：

pip install numpy scipy torch torchaudio transformers

清除 pip 缓存并重新安装：

# 清除 xformers 缓存：运行以下命令清除 xformers 缓存。
pip uninstall -y xformers
pip cache purge

# 更新 pip：确保您正在使用最新版本的 pip，可以运行以下命令更新 pip。
pip install --upgrade pip

# 安装 xformers：在清除了缓存并更新了 pip 之后，重新安装 xformers。
pip install xformers

手动安装 xformers 指定版本
如果上述步骤仍然无法解决问题，可尝试手动安装 Dreambooth 所需的 xformers 版本。在 Dreambooth 的文档中，可以找到 xformers 的版本要求。

pip install xformers==0.0.17.dev465

使用 conda 环境
如果您使用的是 conda 环境，请尝试在 conda 环境中安装 xformers。

# 创建 conda 环境
conda create --name myenv

# 激活 conda 环境并安装 xformers
conda activate myenv
pip install xformers

网络问题
如果已经配置好了代理，就不要考虑这个了。
检查网络连接：请确保您的计算机与互联网连接，并且网络连接没有被防火墙或代理服务器阻止：

# 检查网络连接是否正常
ping google.com

非必要
你确定需要使用 xformers 么？如果不需要，可以在 webui-user.bat 中把 --xformers 去掉试试。
其它
如果上述方法还是无法解决问题，请尝试在 OpenAI 的论坛或者 Dreambooth 的 GitHub 页面上寻求更多帮助。-_-!

5. 其他安装问题

删除 /tmp 和 /venv 目录后重启 webui.bat 试试。

6. 硬件问题

一般显卡不达标，就会爆卡，解决办法就是编辑根目录下 webui-user.bat 文件，试一下修改参数 COMMANDLINE_ARGS 即可。

以下几个设置逐一测试看看哪个适合自己。

set COMMANDLINE_ARGS=--lowvram --precision full --no-half --skip-torch-cuda-test
set COMMANDLINE_ARGS=--lowvram --precision full --no-half
set COMMANDLINE_ARGS=--lowvram

本机显存 4G，使用最后一个配置方法，可以烧出 2048*1080 的图，前两种方法反而会在最后爆卡。

最后，预祝各位成功~~

dog drink~~ where is dog?

在这里插入图片描述

参考：
【AI 繪畫】Stable-Diffusion 通過骨架分析插件 ControlNet 來製作超有意境的圖片
 Stable Diffusion 2.1 + WebUI 的安装与使用（极详细）
低配显卡想玩 Stable Diffusion？修改一个配置就行
 整合包

暂

转自暂时先用这个名字 3 年前

6,977

页面错误！请稍后再试～

页面错误！请稍后再试～
ThinkPHP V*.*.* { 十年磨一剑-为API开发设计的高性能框架 }

排查方法：查看 /runtime/log 中的 log 日志

xoyozo 4 年前

3,393

LigerShark.WebOptimizer.Core 对比 BuildBundlerMinifier

	LigerShark.WebOptimizer.Core	BuildBundlerMinifier
特点	在运行时捆绑和缩小 CSS 和 JavaScript 文件具有完整的服务器端和客户端缓存，以确保高性能可禁用缩小支持使用通配模式标记帮助程序与缓存破坏支持内联支持 SCSS	将 CSS、JavaScript 或 HTML 文件捆绑到单个输出文件中保存源文件会自动触发重新捆绑支持通配模式支持 CI 方案的 MSBuild 支持缩小单个或捆绑的 CSS、JavaScript 和 HTML 文件每种语言的缩小选项是可定制的打开生成的文件时显示水印任务运行程序资源管理器集成命令行支持快捷更新解决方案中所有捆绑包禁止生成输出文件转换为 Gulp
注入（Program.cs）	services.AddWebOptimizer(); app.UseWebOptimizer();
指定捆绑的项目	在运行时自动缩小 css 和 js，也可以在 AddWebOptimizer 中自定义。默认情况下，生成的文件不会保存到磁盘，而是保存在缓存中。	手动编辑 bundleconfig.json 文件来指定需要合并和缩小的文件
功能配置	{ "webOptimizer": { // 确定是否应设置 HTTP 标头以及是否应支持条件 GET （304）请求。在开发模式下禁用此功能可能会有所帮助。cache-control "enableCaching": true, // 确定是否用于缓存。在开发模式下禁用可能会有所帮助。IMemoryCache "enableMemoryCache": true, // 确定管道资产是否缓存到磁盘。这可以通过从磁盘加载 pipline 资产而不是重新执行管道来加快应用程序重新启动的速度。在开发模式下禁用可能会有所帮助。 "enableDiskCache": true, // 设置资产将存储的目录 ifistrue。必须为读/写。enableDiskCache "cacheDirectory": "/var/temp/weboptimizercache", // 确定元素是否应指向捆绑路径或应为每个源文件创建引用。这在开发模式下禁用很有帮助。 "enableTagHelperBundling": true, // 是一个绝对 URL，如果存在，它会自动为页面上的任何脚本、样式表或媒体文件添加前缀。注册标记帮助程序后，标记帮助程序会自动添加前缀。在此处查看如何注册标记帮助程序。 "cdnUrl": "https://my-cdn.com/", // 确定捆绑包的源文件中没有内容时的行为，默认情况下，请求捆绑包时将引发 404 异常，设置为 true 以获取包含空内容的捆绑包。 "allowEmptyBundle": false } }	在 bundleconfig.json 捆绑时设置 [ { "outputFileName": "output/bundle.css", "inputFiles": [ "css/lib/*/.css", // globbing patterns are supported "css/input/site.css" ], "minify": { "enabled": true, "commentMode": "all" } }, { "outputFileName": "output/all.js", "inputFiles": [ "js/.js", "!js/ignore.js" // start with a ! to exclude files ] }, { "outputFileName": "output/app.js", "inputFiles": [ "input/main.js", "input/core/.js" // all .js files in input/core/ ] } ]
热重载（在开发模式中保存文件自动更新浏览器效果）		VS 安装扩展，方法：菜单 - 扩展 - 管理扩展 - 联机搜索“Bundler & Minifier”
其它资料	ASP.NET 官方文档

xoyozo 4 年前

5,024

bundleconfig.json 使用技巧

[
  {
    "outputFileName": "wwwroot/js/Admin/Blog/List.js",
    "inputFiles": [
      "Areas/Admin/Views/Blog/List.cshtml.js"
    ]
  }
]

JS 源文件在视图目录，独立于 .cshtml 文件，又折叠于 .cshtml 文件。

输出目录在 wwwroot 中，若文件名不以“.min.js”结尾，那么会自动生成“.js”和“.min.js”两个文件，分别在开发模式和生产模式的视图中引用。

缺点：只更改 JS 内容，执行“生成解决方案”项目不会重新编译更新 wwwroot 中的 .js 和 .min.js 文件，这时使用“重新生成解决方案”可以解决这个问题。

xoyozo 4 年前

5,071

Could not load file or assembly 'Microsoft.EntityFrameworkCore.Relational, Version=6.0.x.0, Culture=

开发环境正常，发布到 IIS 报错

Could not load file or assembly 'Microsoft.EntityFrameworkCore.Relational, Version=6.0.x.0, Culture=neutral, PublicKeyToken=adb9793829ddae60'. 系统找不到指定的文件。

尝试在 UI 层安装 Pomelo.EntityFrameworkCore.MySql 无果。

最终，在发布时文件发布选项中，去掉“启用 ReadyToRun 编译”就正常了。

当然这种情况不是在所有启用了 ReadyToRun 编译的项目中遇到，但该项目改为不启用 ReadyToRun 后恢复正常了，原因暂时未知。

xoyozo 4 年前

5,334

微信网页分享失效

今天发现在开发新项目时，微信分享失效了，开启 debug = true 后，在微信开发工具中提示：

{"errMsg":"updateTimelineShareData:fail, the permission value is offline verifying"}

在真机上提示：

{"errMsg":"config:ok"}
{"errMsg":"updateAppMessageShareData:ok"}
{"errMsg":"updateTimelineShareData"}

仍然找不出原因。

尝试打开已上线的项目，分享功能均正常。

偶然发现，当打开使用 JS-SDK 分享后的图文框的页面，能够正常分享，而直接点开链接的页面，没有分享按钮。

这难免不让人联想到最近GJ出的新政，新版微信已经开放淘宝、抖音等平台的链接打开权限，只是当点击链接的时候会出现一个风险提示页面：

而一旦由这个页面进入的网页，分享功能均不能正常。

另外还测试了以下几种情况的分享功能也能正常：

公众号推送的图文或链接、公众号菜单、个人发送到公众号的链接、通过扫一扫打开的页面等。

-- 2021.9

xoyozo 5 年前

21,958

ASP.NET 5 打开页面抛出 500 异常的一个奇葩原因

如果你的视图页面（.cshtml）是由另一个视图页面复制而来的，就有可能出现开发调试时正常，发布到服务器后打开报 500 错误。

解决方法是：新建一个 .cshtml 页面，将代码移植到这个文件上，删除原来的页面，更改刚创建的文件名。

你也可以直接修改项目文件将视图页面重新包含到项目中。

xoyozo 5 年前

2,952

如何升级 ASP.NET Core 小版本

当 ASP.NET 发布一个新的小版本更新时（以 .NET 5.0.10 为例），生产环境服务器端可以直接下载安装 .NET 5.0.10 来自动替换 .NET 5.0.9。

倘若这时直接使用 VS 将 nuget 中版本为 5.0.9 的组件更新到 5.0.10 发布到服务器上的话，可能会发生错误：

HTTP Error 500.30 - ASP.NET Core app failed to start

这里我们可以在 nuget 回滚相关组件的版本至 5.0.9，等 VS 发现新的版本更新时，更新 VS 开发工具后，再更新 nuget 组件并进行发布即可。

着急的小伙伴可以直接前往 Microsoft .NET 网站下载安装包含 Runtime 5.0.10 的 SDK：

该情况同样发生在 ASP.NET Core 3.1 等大版本上。

若仍未生效，请重启服务器。

----------------

后注：安装完成后重启服务器可避免以上烦恼！

xoyozo 5 年前

3,002

地图开发文档

天地图：https://map.tianditu.gov.cn/

开放平台：http://lbs.tianditu.gov.cn/

控制台：https://console.tianditu.gov.cn/

版本	类参考	代码示例
JavaScript API 4.0	类参考	代码示例
JavaScript API 4.0 开源库	资源引用、类参考及示例

若不显示地图，请添加域名白名单。

坐标系：CGCS 2000（国家大地坐标系）

高德地图：https://www.amap.com/

开放平台：https://lbs.amap.com/

控制台：https://console.amap.com/

版本	参考手册	示例中心
JS API v2	参考手册	示例中心
JS API v1	参考手册	示例中心

更多：坐标获取

坐标系：GCJ-02（火星坐标、国测局坐标系）

百度地图：https://map.baidu.com/

开放平台：http://lbsyun.baidu.com/

控制台：http://lbsyun.baidu.com/apiconsole/center

版本	类参考	示例DEMO
JavaScript API GL	类参考	示例DEMO
JavaScript API v3.0	类参考	示例DEMO

更多：拾取坐标系统

坐标系：BD-09（百度坐标）

腾讯地图：https://map.qq.com/

PC端于2022年11月11日停止服务

开放平台（腾讯位置服务）：https://lbs.qq.com/

控制台：https://lbs.qq.com/dev/console

版本	参考手册	示例
JavaScript API GL	参考手册	示例

更多：位置服务

坐标系：GCJ-02（火星坐标、国测局坐标系）

附：常见地图经纬度坐标系及转换

xoyozo 5 年前

19,941

百度地图 JavaScript API v3.0 与 JavaScript API GL 有什么区别

JavaScript API GL v1.0 是基于 WebGL 全新开发的地图 API 接口。为了方便开发者迁移升级，大部份接口向下兼容。目前 GL v1.0 版本接口包含了 3D 地图的渲染、基本控件、覆盖物。在后面的版本中，将对原 v2.0、v3.0 中的核心功能进行补全。

JavaScript API GL 版本对手机性能要求较高，不建议在移动端调用。若涉及移动端 JS 服务调用，请使用 JavaScript API v3.0 版本。

JavaScript API GL v1.0 基于 WebGL 开发，对于用户的浏览器环境有兼容性要求。需要完整支持 WebGL 的现代浏览器来支持渲染。对于 WebGL 支持欠佳的浏览器会降级为 Canvas 绘制，若仍然存在兼容性问题，则会降级到瓦片图渲染。确保不同浏览器环境的用户都可以完成地图的基本渲染。

参考：http://lbsyun.baidu.com/index.php?title=jspopularGL/guide/usage

xoyozo 5 年前

10,305

1 2 3 4 5

一、环境准备

（一）硬件方面：

1. 显存

2. 硬盘

（二）软件方面：

1. Git

2. Python

3. Nvidia CUDA

4. stable-diffusion-webui

5. 中文语言包

6. 扩展（可选）

7. 模型

二、安装流程

1. 安装 Git

2. 安装 Python

3. 安装 Nvidia CUDA

4. 安装 stable-diffusion-webui

三、问题及注意点

1. python 版本错误

2. pip版本错误

3. 安装或执行停滞

4. xFormers 安装不上

5. 其他安装问题

6. 硬件问题

大家在看

最新发布

查询 / 检测

编程

前端

行业

本站 API

博客 (99)

一、环境准备

（一）硬件方面：

1. 显存

2. 硬盘

（二）软件方面：

1. Git

2. Python

3. Nvidia CUDA

4. stable-diffusion-webui

5. 中文语言包

6. 扩展（可选）

7. 模型

二、安装流程

1. 安装 Git

2. 安装 Python

3. 安装 Nvidia CUDA

4. 安装 stable-diffusion-webui

三、问题及注意点

1. python 版本错误

2. pip版本错误

3. 安装或执行停滞

4. xFormers 安装不上

5. 其他安装问题

6. 硬件问题

大家在看

最新发布