
Stable Diffusion WebUI Forge 完整部署与使用教程从环境配置到量化模型加载【免费下载链接】stable-diffusion-webui-forge项目地址: https://gitcode.com/GitHub_Trending/st/stable-diffusion-webui-forgeStable Diffusion WebUI Forge 是构建在 Stable Diffusion WebUI 之上的平台当前基于上游 1.10.1 版本Gradio 4 界面主要解决三件事降低 GPU 显存门槛、加速推理、让实验性功能如 ControlNet 集成、FreeU V2开箱可用。适合已在使用 A1111 WebUI 想换轻量方案的用户以及显存 4GB 起步、想跑 Flux 量化模型的用户。环境要求Python、CUDA 与显存最低配置项目最低要求推荐配置Python3.83.10CUDA11.812.1PyTorch2.02.3.1官方推荐包为 CUDA 12.1 PyTorch 2.3.1 组合GPU 显存约 4GB加载 GGUF Q4_0 量化模型8GB可跑 BF16 或 Q8_0 量化依赖文件—requirements_versions.txt已锁版本gradio 4.40.0、transformers 4.46.1、diffusers 0.31.0 等NVIDIA GPU 为推荐硬件依赖版本已锁手动升级 torch 或 transformers 容易破坏兼容性不建议改。三步完成 Stable Diffusion WebUI Forge 安装部署主线路径只有三步git clone https://gitcode.com/GitHub_Trending/st/stable-diffusion-webui-forge cd stable-diffusion-webui-forge ./webui-user.shWindows / macOS 对应命令为webui-user.bat它会自动创建venv虚拟环境并安装依赖首次启动耗时较长属正常。需要额外启动参数时在运行脚本前设置COMMANDLINE_ARGS环境变量Linux 示例export COMMANDLINE_ARGS--port 7862。已有 A1111 WebUI 环境、熟悉 Git 的用户也可以将 Forge 作为 SD-WebUI 的分支安装来复用旧模型与扩展其余安装方式一键安装包等均可跳过以上述命令为准。能完成什么事四大能力与代码依据文生图 / 图生图入口 webui.py 启动 Gradio 界面默认监听 7860 端口仅 API 模式--nowebui则落在 7861 端口。量化模型加载原生支持 BitsandBytes NF4 与 GGUF 的 Q8_0 / Q5_0 / Q5_1 / Q4_0 / Q4_1 五个精度级别其中 NF4、Q8_0、Q4_0、Q4_1 带 LoRA 支持。显存精细管理设置页提供 GPU Weight 滑块GPU 常驻权重比例、Queue / Async Swap 换页模式切换、换页位置选择让低显存卡也能承载大模型。内置扩展生态extensions-builtin/下预置 ControlNet、IP-Adapter、FreeU V2实现见 extensions-builtin/sd_forge_freeu/scripts/forge_freeu.py、多种预处理器marigold、tile、revision 等无需再单独装扩展。第一次拿到生成结果的最小路径将 checkpoint / GGUF 模型放入models/Stable-diffusion/VAE可选放入models/VAE/。浏览器访问http://127.0.0.1:7860/选择模型在 txt2img 页填写提示词、尺寸、步数。点击 Generate 出图img2img 页可复用同一流程做图生图。一个必须知道的界面差异Gradio 4 画布移动必须使用鼠标右键拖拽这是从 A1111 迁移后最容易踩的交互变化。常见故障与性能调优排查现象启动报 Press any key to continue 或终端卡住。原因依赖仍在安装 / 下载或端口被占用。处理等待完成仍失败则关闭占用 7860 的进程或用--port换端口。现象Flux 推理卡死、进度不动或 OOM。原因GPU Weight 设置过高权重常驻 GPU 超出显存。处理把 GPU Weight 调低——官方讨论区结论是降低该值可解决绝大多数此类问题。现象低比特模型NF4 / Q4_0上 LoRA 效果弱。处理使用 Forge 针对低比特模型的 LoRA 精度优化并开启仅加载一次 LoRA以避免每次生成重复 patch。现象API 调用 Flux 相关端点表现异常。原因API 层 Flux 支持仍在完善属已知边界而非配置错误。适用场景与边界适合低显存机器跑 Flux / SDXL / SD1.5 文生图、图生图用量化模型压缩显存依赖内置 ControlNet 与 IP-Adapter 做可控生成。不适合 / 尚未实现Flux 专用 ControlNet 与 ControlNet Union 均未实现截至 2024-08-26 官方状态OFT LoRA 曾处于待修复状态Microsoft Surface 的画布压感支持曾标记为 Broken。上游 SD-WebUI 目前基本停止更新Forge 按每 90 天或遇重要修复时同步一次上游长期项目需留意同步节奏。资源与版本说明模型目录models/Stable-diffusion/、models/VAE/、models/text_encoder/内置扩展目录extensions-builtin/第三方扩展放入extensions/发布说明NEWS.md仓库状态表与更新计划见该文件依赖锁定清单requirements_versions.txt本文基于 Forge 2.0.1底层 SD-WebUI 1.10.1Gradio 4.40.0编写功能与界面可能随版本更新而变化。【免费下载链接】stable-diffusion-webui-forge项目地址: https://gitcode.com/GitHub_Trending/st/stable-diffusion-webui-forge创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考