部署前先明确环境与适用场景

Stable Diffusion WebUI 适合需要在本地生成图片、调试模型、管理提示词和扩展插件的用户。

它的优势是界面直观、生态成熟、支持多种模型格式，也便于在个人电脑或工作站上做离线测试。

部署前，请先确认硬件条件：

• 建议使用具备独立显卡的设备。显存越大，可承载的分辨率、批量数量和模型类型越多。
• 仅使用 CPU 也能运行，但速度较慢，更适合作为功能验证。

软件环境方面：

• 常见组合是 Windows 10/11 或主流 Linux 发行版。
• Python 建议使用项目兼容版本，Git 用于拉取和更新代码。
• 显卡用户还要安装匹配的驱动与计算组件。

部署前不要把 WebUI 目录放在中文路径、空格过多的路径或权限受限目录下。建议使用类似 D:AIstable-diffusion-webui 这样的独立目录，后续升级、备份和排错都会更清晰。

快速安装与首次启动步骤

第一步：安装 Python

安装时勾选“Add Python to PATH”。完成后，在命令行输入 python --version 确认版本可用。

第二步：安装 Git

完成后输入 git --version 检查是否生效。

第三步：拉取代码

在目标目录打开命令行，执行 git clone 项目地址，将 Stable Diffusion WebUI 代码拉取到本地。如果网络环境不稳定，可以稍后重试，避免下载一半后直接强行改动目录。

第四步：准备基础模型

将下载好的模型文件放入 models/Stable-diffusion 目录，常见格式包括 .ckpt 和 .safetensors。建议优先选择来源清晰、说明完整的模型文件，并保留文件名中的版本信息，便于以后排查兼容性问题。

第五步：启动 WebUI

Windows 用户通常运行 webui-user.bat，Linux 用户运行 webui.sh。首次启动会自动安装依赖，耗时较长。看到本地访问地址后，再打开浏览器。

默认后台管理入口通常是 http://127.0.0.1:7860 或 http://localhost:7860。这里的“后台”指本机 Web 操作界面，可进行模型切换、参数设置、图片生成、扩展管理和系统信息查看。

如果端口被占用，可在启动参数中指定其他端口，例如加入 --port 7861。若只是个人本机使用，不建议开放到公网，也不要随意把访问地址发送给不可信对象。

常用配置项与上手建议

初次进入界面后，先在左上角选择基础模型，再设置采样方法、采样步数、宽高、批量数量和随机种子。

新手可从 512×512 或 768×768 开始，步数设置在 20 到 30 之间。先保证能稳定出图，再逐步提高分辨率。

显存不足时，可降低宽高、关闭高分辨率修复、减少批量数量，或在启动参数中加入低显存相关选项。

常见启动参数可写入 webui-user.bat 中的 COMMANDLINE_ARGS：

• 需要开启局域网内访问，可使用 --listen，但必须配合访问控制、可信网络和必要的口令设置。
• 需要固定端口可使用 --port。
• 显存较小可尝试 --medvram 或 --lowvram。

参数不是越多越好，建议每次只改一项，确认稳定后再继续调整。

扩展插件建议少量安装、逐个验证。插件能增强提示词管理、图像处理和工作流能力，但也可能带来版本冲突。安装扩展前记录当前 WebUI 版本、插件名称和安装时间，出现启动异常时就能快速定位。不要把未知脚本直接放入启动目录，也不要运行来源不明的安装文件。

更新升级的标准流程

升级前最重要的是备份。至少备份以下内容：

• models 目录
• outputs 目录
• embeddings 目录
• extensions 目录
• config.json、ui-config.json
• webui-user.bat 或 webui-user.sh

模型和输出图片体积较大，可以按实际需要分开备份；配置文件体积小，但恢复时非常关键。建议建立“日期+版本号”的备份文件夹，例如 backup-2026-01-15。

确认备份后，在 WebUI 目录打开命令行，执行 git status 查看本地是否有改动。如果显示存在修改，先判断是否为自己调整过的文件。可将自定义内容复制保存，再执行更新操作。常见升级方式是在项目目录执行 git pull，拉取最新代码。更新完成后重新运行启动脚本，系统会根据需要更新依赖。

升级后要做三项检查：

1. 页面能否正常打开。
2. 基础模型能否加载并生成小尺寸图片。
3. 常用插件是否报错。

不要一升级就运行复杂工作流，先用最小参数做验证。若控制台出现依赖冲突、模块缺失、插件加载失败等信息，应优先查看最近升级的插件和 WebUI 版本变动，再决定修复还是回退。

升级回滚操作教程

回滚的核心思路是把代码恢复到已知可用的版本，同时保留模型和输出文件。

最稳妥的做法是在每次升级前记录当前提交编号。可在项目目录执行 git rev-parse HEAD，将输出的编号保存到备份说明中。升级后如果出现严重问题，就能按编号回到旧版本。

需要回滚时，先关闭 WebUI 进程，避免文件被占用。进入项目目录后执行 git log --oneline 查看历史记录，找到之前记录的版本编号，再执行 git checkout 版本编号。回到旧版本后重新启动 WebUI。如果依赖也在升级过程中发生变化，可能需要删除 venv 目录，让启动脚本按旧版本重新创建环境。删除 venv 前请确认其中没有自己额外保存的文件。

如果使用的是压缩包部署，而不是 Git 方式安装，回滚方式应以目录备份为准：关闭程序，将当前目录改名保留，再把升级前备份目录恢复为原目录名称。模型目录可单独迁移，避免重复复制大文件。对于生产或团队环境，建议采用 “新目录验证、旧目录保留” 的方式，确认新版本稳定后再切换，减少停机时间。

后台管理入口与访问控制说明

WebUI 启动成功后，控制台会显示 Running on local URL，后面的地址就是后台管理入口。默认只允许本机访问，适合个人电脑使用。

如果部署在局域网服务器上，需要使用 --listen 让其他设备访问，再通过服务器 IP 加端口打开页面。此时必须确认网络范围可控，并设置访问口令，避免未授权人员操作模型、查看历史输出或修改配置。

如果需要设置账号口令，可在启动参数中加入 --gradio-auth 用户名:口令。口令不要使用简单数字、生日或常见单词，也不要和其他重要账号重复。若只是临时演示，演示结束后应关闭 --listen 参数并重启服务。outputs 目录中可能包含生成记录，分享设备或迁移目录前要先清理不需要的文件。

常见问题与排查办法

• 问题一：启动窗口闪退。通常是 Python 未加入 PATH、版本不兼容或依赖安装中断。可在命令行手动运行启动脚本，这样能看到完整报错。
• 问题二：提示找不到 Git。说明 Git 未安装或环境变量未生效，重新安装后关闭命令行再打开。
• 问题三：页面能打开但无法出图。先检查模型是否放在 models/Stable-diffusion 目录，再确认模型文件是否完整。可以换一个小尺寸参数测试，排除显存不足。
• 问题四：升级后插件报错。先禁用最近安装或最近更新的插件，把 extensions 中的对应目录临时移走，再启动验证。
• 问题五：端口被占用。将启动参数改为 --port 7861 或其他未占用端口即可。
• 问题六：速度明显变慢。检查是否误用 CPU 运行、显卡驱动是否异常、分辨率是否过高、批量数量是否过大。若近期安装了多个插件，也可能增加启动和推理负担，可逐个排查。
• 问题七：回滚后仍报错。通常是依赖环境残留导致，可在备份确认后重建 venv，并保持模型目录不动。

安全边界与维护建议

Stable Diffusion WebUI 本质上是本地 AI 图像生成与管理工具，部署时应遵守软件许可、模型许可和素材授权要求。

不要使用来源不清的模型、脚本和插件。不要处理未经授权的个人照片、商业素材或敏感数据。团队使用时应建立模型来源登记、版本变更记录和输出文件清理规则。

日常维护建议采用“三件套”：固定可用版本、定期备份配置、谨慎更新插件。个人用户可每月检查一次更新；工作流稳定后，不必追求每天升级。遇到重大版本变化时，优先在副本目录测试，确认模型、插件、参数和后台管理入口都正常，再替换主环境。这样既能享受新功能，也能把升级风险控制在可恢复范围内。