SD WebUI Forge：Stable Diffusion高性能WebUI分支安装与使用指南

官方信息

项目背景

Stable Diffusion WebUI（俗称A1111）是Stable Diffusion生态中最经典的Web界面，但随着SDXL、FLUX等新模型出现，A1111在显存管理、推理速度、新模型支持方面逐渐力不从心。Forge 由 ControlNet 的作者 lllyasviel（李云飞）开发，目标就是重写A1111的底层架构，解决这些痛点。

Forge 与 A1111 保持100%界面兼容——你原来的插件、模型、提示词模板、配置都可以直接搬过来用。但底层完全重写了显存管理、模型加载、注意力机制，带来了三大核心提升：

第一，显存占用大幅降低。同样跑SDXL，A1111需要12GB以上显存，Forge只需要8GB甚至6GB就能流畅运行。这是因为Forge实现了更精细的模型卸载（offloading）和注意力优化。第二，推理速度提升30%-100%。Forge重写了采样循环，引入了更高效的 attention backend，在同一张显卡上出图速度明显快于A1111。第三，原生支持最新模型。Forge是最早原生支持SD3.5、FLUX、HunyuanDiT的WebUI之一，不需要装一堆第三方插件就能跑新模型。

Forge已经成为目前AI绘画社区中最主流的WebUI选择，许多原来的A1111用户都迁移到了Forge。

核心特性

• 显存节省50%+：SDXL仅需6GB显存，FLUX仅需8GB，老显卡也能跑新模型
• 推理速度翻倍：重写采样循环+高效attention backend，同硬件出图更快
• A1111完全兼容：插件、模型、LoRA、embeddings目录结构一致，无缝迁移
• 原生新模型支持：SD1.5/SDXL/SD3.5/FLUX/HunyuanDiT/PixArt直接加载
• 内置ControlNet：lllyasviel亲自优化，ControlNet体验比A1111更流畅
• UI主题自定义：内置多种暗黑/亮色主题，可自定义配色
• 批量处理内置：无需插件即可批量出图、批量图生图

环境要求

详细部署步骤

方式一：Windows 便携包（推荐新手）

1. 下载便携包
   前往 Releases页面，下载最新的 webui-forge-win64.7z（约1.5GB）。
2. 解压
   用7-Zip解压到无中文路径的目录，例如 D:\Forge。
3. 首次启动
   双击 run.bat，首次启动会自动下载PyTorch和依赖，约5-10分钟。看到 Running on local URL: http://127.0.0.1:7860 即成功。
4. 访问界面
   浏览器打开 http://127.0.0.1:7860。

方式二：Linux 源码部署

1. 安装系统依赖

   sudo apt update
   sudo apt install python3.10 python3.10-venv git libgl1-mesa-glx libglib2.0-0 -y
   # 验证CUDA
   nvidia-smi

2. 克隆仓库

   cd /opt
   sudo git clone https://github.com/lllyasviel/stable-diffusion-webui-forge.git
   sudo chown -R $USER:$USER stable-diffusion-webui-forge
   cd stable-diffusion-webui-forge

3. 启动脚本自动配置

   bash webui.sh --listen 0.0.0.0 --port 7860

   首次启动会自动创建venv、安装PyTorch、下载所有依赖。全程无需手动操作。

4. 常用启动参数
   • --listen 0.0.0.0：允许外网访问
   • --port 7860：指定端口
   • --api：启用API接口
   • --ngrok：使用ngrok内网穿透
   • --enable-insecure-extension-access：允许远程安装插件
   • --medvram / --lowvram：低显存模式
5. 配置为系统服务

   sudo tee /etc/systemd/system/forge.service <<EOF
   [Unit]
   Description=SD WebUI Forge
   After=network.target
   
   [Service]
   User=ubuntu
   WorkingDirectory=/opt/stable-diffusion-webui-forge
   ExecStart=/bin/bash webui.sh --listen 0.0.0.0 --port 7860 --api
   Restart=always
   
   [Install]
   WantedBy=multi-user.target
   EOF
   
   sudo systemctl daemon-reload
   sudo systemctl enable --now forge

方式三：Docker 部署

docker run -d --name forge \
  --gpus all \
  -p 7860:7860 \
  -v /data/forge-models:/opt/stable-diffusion-webui-forge/models \
  -v /data/forge-outputs:/opt/stable-diffusion-webui-forge/output \
  -v /data/forge-extensions:/opt/stable-diffusion-webui-forge/extensions \
  reg.ghcr.io/lllyasviel/stable-diffusion-webui-forge:latest

模型与插件配置

1. 放置模型
   Forge目录结构与A1111完全一致：

   models/
   ├── Stable-diffusion/    # 底模（SD1.5/SDXL/FLUX等）
   ├── Lora/               # LoRA模型
   ├── VAE/                # VAE
   ├── ControlNet/         # ControlNet模型
   ├── embeddings/         # 文本反转embedding
   └── upscale_models/     # 放大模型

2. 从A1111迁移
   直接把A1111的 models/ 和 extensions/ 目录复制到Forge对应位置即可，99%的插件兼容。
3. 安装插件
   打开WebUI → 顶部"Extensions"标签 → "Available" → 点击"Load from:"按钮 → 搜索插件 → Install → 重启UI。

使用方法

基础文生图

1. 顶部"Stable Diffusion checkpoint"下拉框选择底模（例如 SDXL_base_1.0）
2. 在"Prompt"框输入正向提示词，例如 masterpiece, best quality, 1girl, white dress, garden, sunshine
3. 在"Negative prompt"框输入负向提示词
4. 设置宽高：SDXL推荐1024×1024，SD1.5推荐512×768
5. 采样器推荐 DPM++ 2M Karras，步数20-30
6. Batch count=1，Batch size=1
7. 点击"Generate"，等待出图

FLUX模型在Forge中使用

1. 下载FLUX的Forge版本单文件（flux1-dev-fp8.safetensors）
2. 放到 models/Stable-diffusion/ 目录
3. 重启Forge，在checkpoint下拉框选择FLUX
4. Forge会自动识别FLUX架构，调整为FLUX专用界面（guidance scale设为3.5，步数20-50）

ControlNet使用

1. 下载ControlNet模型（如control_v11p_sd15_openpose）放到 models/ControlNet/
2. 在txt2img页面展开"ControlNet"面板
3. 勾选"Enable"，上传控制图（姿态图/深度图/线稿）
4. 选择对应的预处理器（preprocessor）和模型
5. Weight设为0.8-1.0，点击Generate

常见问题（FAQ）

Q1: Forge和A1111有什么区别？我需要迁移吗？

Forge是A1111的高性能重写版，界面几乎一样但速度更快、显存更省。如果你现在用A1111跑得很流畅可以不迁；但如果想跑SDXL/FLUX或显存不够用，强烈建议迁移，模型和插件都能直接复用。

Q2: 启动时报错 "Cannot connect to GPU" 怎么办？

检查：1）显卡驱动是否正常（nvidia-smi）；2）CUDA版本是否匹配；3）是否被其他程序占用显存。关闭其他占显存的程序（如另一个WebUI）再试。

Q3: 插件不兼容怎么办？

大多数A1111插件在Forge上兼容，但少数深度改动UI的插件可能出错。可以到Extensions页面禁用出错的插件，或寻找Forge专用版本。Forge自带的功能已经覆盖了大部分常见插件需求。

Q4: 如何远程访问？

启动时加 --listen 0.0.0.0 --api --enable-insecure-extension-access，开放防火墙7860端口。注意安全，建议加Nginx反向代理+密码。

Q5: FLUX模型在Forge里怎么用最省显存？

下载FP8量化版的FLUX单文件（约12GB），Forge会自动使用FP8推理，8GB显存即可跑dev版。配合 --medvram 启动参数效果更好。

跳转链接

• GitHub 仓库：https://github.com/lllyasviel/stable-diffusion-webui-forge
• Releases下载：https://github.com/lllyasviel/stable-diffusion-webui-forge/releases
• ControlNet仓库：https://github.com/lllyasviel/ControlNet
• 模型下载（Civitai）：https://civitai.com
• HuggingFace模型库：https://huggingface.co/models?library=stable-diffusion