Stable Diffusion WebUI Forge 低显存出图指南：SDXL 与 FLUX 快速上手教程

【免费下载链接】stable-diffusion-webui-forge项目地址: https://gitcode.com/GitHub_Trending/st/stable-diffusion-webui-forge

Stable Diffusion WebUI Forge 是 Stable Diffusion WebUI 的一个重构分支，专门解决两个问题：显存不够、大模型装不下。它重写了 GPU 内存管理，支持 FLUX 这类几十 GB 的模型以 4-bit 量化方式加载，让 8GB~12GB 的显卡也能正常出图。本文从下载安装讲到 FLUX 量化加载，带你把基础流程跑通。

从下载出第一张图：三步走

两种安装方式

方式一，适合不想折腾的读者：下载官方一键安装包（推荐版自带 CUDA 12.1 + PyTorch 2.3.1 环境，git 和 Python 都已打包）。解压后先运行update.bat更新到最新版，再运行run.bat启动——跳过更新步骤可能让你跑在有 bug 的旧版本上。

方式二，适合熟悉 git 的读者，也可以作为已有原版 WebUI 环境的用户直接复用旧模型和扩展：

git clone https://gitcode.com/GitHub_Trending/st/stable-diffusion-webui-forge

启动服务并生成第一张图

Windows 双击webui-user.bat，Linux/Mac 执行bash webui-user.sh。首次启动会自动安装依赖，终端出现 running on local URL 表示就绪，浏览器会自动打开界面。

把 SD 检查点（.safetensors）放进models/Stable-diffusion/目录，重启一次让服务识别。之后进入 txt2img 标签页，输入提示词点 Generate，即可出图。注意 Forge 用的是 Gradio 4 界面，画布（比如 inpaint 涂抹）要用鼠标右键拖动。

GPU Weights：一个滑块分配显存

这个滑块管什么

打开网页顶部（左下角 UI 区域选 all 可见）会看到GPU Weights (MB)滑块：它控制模型权重占多少显存，剩下的空间留给推理时的中间张量。默认值是总显存减 1GB，也就是默认状态基本吃满显存。显存紧张时这是你最该动的参数——官方处理 FLUX 性能问题的总结就一句话：别把它拉太高，调低它能解决 99% 的问题。

按显存档位定初始值

旁边还有 Offload 相关的开关（offload 位置与方式），显存实在不够时开启，把部分权重放到内存里换速度。滑块拖完记得保存设置再重新生成。

12GB 显卡跑 FLUX：4-bit 量化加载

NF4 与 GGUF 两种格式

FLUX.1 原始权重太大，直接加载必然爆显存。Forge 原生支持两种压缩格式，配合 GPU Weights 滑块使用：

• BitsandBytes 的 NF4（NF4 即 4-bit 浮点量化）
• GGUF 的 Q8_0 / Q5_1 / Q5_0 / Q4_0 / Q4_1

两者对 FLUX 都有完整支持，下载对应的量化版模型放入模型目录即可，无需额外装扩展。采样器方面，FLUX 推荐用 simple 调度器；2024 年 9 月起还新增了 Flux Realistic 采样器。

LoRA 与文本嵌入

量化模型不是只能跑"裸模型"：NF4 与 GGUF 的 Q8_0/Q5_0/Q4_0/Q4_1 都支持挂 LoRA，在提示词里用<lora:名称:权重>语法即可。另外 Forge 的文本嵌入（Textual Inversion，训练一个自定义触发词绑定固定形象）也能配合低比特模型使用，下图就是嵌入触发词生成出的结果：

LoRA 不生效时先查两点：LoRA 的架构必须和底模匹配（SD1.5/SDXL/FLUX 不能混挂），再确认触发词写法无误。

内置 ControlNet：用线稿控制构图

原版 WebUI 里 ControlNet 是第三方扩展，Forge 把它内置了（实现见 sd_forge_controlnet 目录），预处理器和模型选择都集成在同一个面板里，不需要单独安装配置。以线稿控制为例：

预处理器: lineart_realistic 控制模型: control_v11p_sd15_lineart 权重 0.8 / 起始 0.0 / 结束 1.0

权重在 0.5~0.8 之间最稳；超过 0.9 画面容易"贴死"在线稿上，纹理和光影细节会丢失。内置的预处理器来自 forge_legacy_preprocessors，覆盖 canny、lineart、depth 等常用类型，选一个能直接跑。

故障排查：三种常见情况

页面卡死或提示连接中断：绝大多数是显存占满。把 GPU Weights 调低重试；仍不行就重启服务，这是官方排查指南里排第一的手段。

出图模糊、缺细节：开启设置里的 Hires. fix 做二次放大，或先在 512/1024 出底图再放大；提示词里补充细节描述也有帮助。追求速度时可用 20~30 步配合 Euler a / DPM++ 2M，耗时约减半、质量微降。

LoRA 不生效：核对架构与底模匹配、触发词写法；低比特模型上想让 LoRA 更精确，可以查仓库 Discussions 里关于"跳过 Patching LoRAs"的说明。

更多模块可看 GPU 内存管理系统 与 LoRA 支持模块，最新进展和已知问题记录在 NEWS.md。遇到复现不了的异常，直接去 issue 区反馈即可。

【免费下载链接】stable-diffusion-webui-forge项目地址: https://gitcode.com/GitHub_Trending/st/stable-diffusion-webui-forge