Stable Diffusion WebUI 本地部署完整教程

## Stable Diffusion WebUI 本地部署完整教程

Stable Diffusion 是目前最受欢迎的开源 AI 绘图模型之一，而 AUTOMATIC1111 开发的 **WebUI** 则是使用它的最佳界面。相比在线服务，本地部署意味着你拥有完整的控制权——无限生成次数、隐私保护、以及更灵活的模型管理。

---

## 核心概念

在开始之前，先理解几个关键术语：

- **Checkpoint 模型**：决定画风的核心文件，通常是 `.safetensors` 或 `.ckpt` 格式，体积在 2–7 GB 之间
- **VAE**：负责图像色彩和细节的解码器，搭配对应模型使用效果更佳
- **LoRA**：轻量级微调模型，用于强化特定角色、风格或概念，体积通常在 100 MB 以内
- **Sampler（采样器）**：控制图像生成算法，常用的有 `DPM++ 2M Karras` 和 `Euler a`

---

## 环境要求

| 配置项 | 最低要求 | 推荐配置 |
|--------|----------|----------|
| GPU | NVIDIA 4 GB 显存 | NVIDIA 8 GB+ 显存 |
| 内存 | 8 GB RAM | 16 GB RAM |
| 硬盘 | 20 GB 可用空间 | 50 GB+ SSD |
| 系统 | Windows 10 / Linux | Windows 11 / Ubuntu 22.04 |

> **注意**：AMD 显卡和 Apple Silicon 也可运行，但需要额外配置，本教程以 NVIDIA 显卡为主线。

---

## 安装步骤

### 第一步：安装依赖环境

首先安装 **Python 3.10.x**（注意不要用 3.11 或更高版本，兼容性存在问题），以及 **Git**。

安装完成后在终端验证：

`python --version`
`git --version`

### 第二步：克隆 WebUI 仓库

在你希望存放项目的目录下执行：

`git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git`

### 第三步：放入基础模型

从 [Hugging Face](https://huggingface.co) 或 [Civitai](https://civitai.com) 下载一个 Checkpoint 模型，将文件放入：

`stable-diffusion-webui/models/Stable-diffusion/`

没有模型文件，WebUI 无法正常启动。

### 第四步：启动 WebUI

**Windows 用户**直接双击运行 `webui-user.bat`；**Linux / macOS 用户**执行：

`bash webui.sh`

首次启动会自动下载依赖包，耗时约 5–15 分钟，取决于网络速度。启动成功后，浏览器访问 `http://127.0.0.1:7860` 即可看到界面。

---

## 实操技巧

**提示词结构**是出图质量的关键。推荐按照以下顺序组织正向提示词：

`画质词, 主体描述, 风格词, 光线/构图, 细节补充`

例如：`masterpiece, best quality, 1girl, solo, anime style, soft lighting, detailed eyes`

**负向提示词**同样重要，常用万能负向词：

`lowres, bad anatomy, bad hands, text, error, missing fingers, extra digit, fewer digits, cropped, worst quality`

**参数调优建议**：
- 分辨率从 `512×512` 或 `768×768` 开始，避免显存溢出
- Steps 设置在 **20–30** 之间，过高收益递减
- CFG Scale 保持在 **7–12**，数值越高越贴近提示词但可能过曝

---

## 常见问题排查

**显存不足（CUDA out of memory）**：在 `webui-user.bat` 中添加启动参数 `--medvram` 或 `--lowvram`，以牺牲速度换取稳定性。

**模型加载失败**：确认文件格式为 `.safetensors`，避免使用来源不明的 `.ckpt` 文件，后者存在安全风险。

**生成速度过慢**：检查任务管理器，确认 GPU 使用率是否正常拉满。若 CPU 占用更高，说明未正确调用 CUDA。

---

## 注意事项

> 请遵守模型的使用协议，部分商业模型禁止用于商业用途。生成内容涉及真实人物时，务必注意版权与肖像权问题。

本地部署的最大优势是自由，但也意味着你需要自行维护环境和更新版本。建议定期执行 `git pull` 保持 WebUI 为最新版本，同时关注官方仓库的 Release Notes，避免因版本差异导致插件失效。

掌握这套流程之后，你可以进一步探索 **ControlNet**、**img2img** 和 **Inpainting** 等进阶功能，逐步解锁 Stable Diffusion 的完整潜力。