Stable Diffusion WebUI Forge 完整实战从一键安装到显存调优的落地流程【免费下载链接】stable-diffusion-webui-forge项目地址: https://gitcode.com/GitHub_Trending/st/stable-diffusion-webui-forge第一次跑 Stable Diffusion 卡在建环境、报显存错误是很多人的共同经历。Stable Diffusion WebUI Forge 是一个基于原版 SD WebUI 的增强平台一键安装包省掉环境搭建内置的显存管理帮你把 GPU 占用压下来ControlNet、LoRA、IP-Adapter 等常用扩展也直接集成好了装完就能用。快速上手从下载到第一张图的最短路径下载一键安装包。官方安装包自带 git 和 Python不需要你单独装任何东西。版本选 CUDA 12.1 PyTorch 2.3.1 的组合稳定且问题最少。完成后你会看到压缩包内的完整项目目录。解压并更新。Windows 用户先运行update.bat它负责拉取最新代码、修复已知 bug看到终端显示更新完成即可。Linux/macOS 用户则编辑webui-user.sh后运行webui.sh。放入模型。下载一个 SD 检查点放进models/Stable-diffusion/目录有配套 VAE 的话放进models/VAE/。完成后刷新页面顶部模型选择框里能看到它。启动服务。Windows 运行run.bat其他系统运行webui-user.sh。浏览器打开http://localhost:7860在 txt2img 页签写一句提示词、点 Generate出图就算跑通了。核心功能拆解如何本地部署 Forge安装包和 Git 两种方式部署这件事官方把两条路都铺好了新手走一键包老用户走 Git 复用旧环境。一键包解压即用内置 git 和 PythonWindows 用update.batrun.bat这套组合。如果你已经有一套旧的 SD WebUI熟悉 Git 的话可以直接把 Forge 装成它的一个分支原有的检查点和已装扩展全部复用。仓库地址git clone https://gitcode.com/GitHub_Trending/st/stable-diffusion-webui-forge想自定义启动参数改webui-user.sh里的变量不要直接改webui.sh。⚠️ 避坑下载解压后先跑update.bat再启动否则可能一直用着带 bug 的旧版本。图像生成Canvas 画布与采样器配置Gradio 4 的 UI 交互习惯和旧版不一样第一次上手最容易在这里迷路。画布在modules_forge/forge_canvas/支持 Wacom 数位笔 128 级压感画图前先改个习惯移动画布用右键。提示词处理走backend/text_processing/下的引擎支持权重语法和文本反转嵌入采样策略可以通过alter_samplers.py调整。生成参数会完整记录在图片 info 里方便复现同一张图。⚠️ 避坑右键移动画布、左键作画是 Gradio 4 的固定操作逻辑Surface 平板的压感支持还在修复中暂时先用 Wacom。显存与参数调优量化、卸载和异步交换显存不够时的思路其实和搬家一样把暂时用不到的东西挪到别处等需要了再搬回来Forge 把这套流程做成了开关和滑块。量化BitsandBytes 的 NF4、Q8_0、Q5_0 和 GGUF 系列Q8_0/Q5_0/Q4_0 等都原生支持用bnb_installer.py可以优化 BNB 的安装过程。卸载界面上的 GPU Weight 滑块、Offload Location 和 Offload Method 决定权重常驻显存的多少以及换到 CPU 的位置。效率打开 Queue/Async Swap 开关生成任务排队时异步搬运权重减少卡顿。底层可调项在modules_forge/的config.py、cuda_malloc.py、shared_options.py里一般用户不用碰。⚠️ 避坑跑 Flux 时千万别把 GPU Weight 拉太高调低这一项能解决绝大多数 Flux 的性能问题。扩展生态内置扩展如何启用与管理Forge 把高频需求做成了内置扩展放在extensions-builtin/下不用自己找兼容版本。控制类sd_forge_controlnet/集成了全部经过测试的 ControlNet附带 Photopea 和 Openpose Editor 两个实用工具。效果类sd_forge_lora/LoRA 管理、sd_forge_freeu/FreeU、sd_forge_ipadapter/、sd_forge_multidiffusion/等在 txt2img 页面勾选启用即可。社区扩展放extensions/目录通过扩展管理器安装适配关系参考supported_controlnet.py和supported_preprocessor.py。⚠️ 避坑ControlNet Union 和 Flux 版 ControlNet 尚未实现选型时注意避开选已测过的版本最省心。模型兼容性各类模型文件放哪里、跑不跑得动Forge 的backend/nn/下完整实现了 SD1.5、SD2.0、SD3.5、SDXL、Chroma、Flux、MMDiTX 等架构主流模型基本都能跑。检查点放models/Stable-diffusion/VAE 放models/VAE/文本编码器放models/text_encoder/。Chroma、FLUX、Stable Cascade 等模型的完整配置已预置在backend/huggingface/引擎代码在backend/diffusion_engine/对应各架构的加载逻辑一目了然。API 端点txt2img、img2img已可正常工作方便写脚本批量出图Flux 方向的 API 支持还在持续完善。⚠️ 避坑Flux 的 BNB NF4 和 GGUF 量化模型都原生支持 LoRA加载量化模型时不用另外折腾兼容性。常见问题速查Q浏览器打不开页面怎么办直接手动访问http://localhost:7860。首次启动要下载依赖比较慢打不开时检查端口是否被其他程序占用。QFlux 生成特别慢或直接崩溃先把 GPU Weight 滑块调低绝大多数情况问题就消失了。还不行再调整 Offload Location 和 Queue/Async Swap 开关。Q量化模型能用 LoRA 吗能。Flux 的 BNB NF4 和 GGUF Q8_0/Q5_0/Q4_0 全部原生支持 LoRA低比特模型的 LoRA 精度技巧可参考项目讨论区。Q老 SD WebUI 的数据能直接迁移吗能。用 Git 方式把 Forge 装成旧环境的一个分支检查点和扩展直接复用一键包用户则需要手动把模型文件拷进对应目录。Q有哪些功能目前还不能用来着ControlNet Union、Flux ControlNet 待实现Microsoft Surface 画布压感、OFT LoRA 待修复。用前对照项目里的 Forge Status 表确认一遍。资源与进阶项目动态NEWS.md版本变更CHANGELOG.md内置扩展源码含 ControlNet、LoRA、FreeU 示例extensions-builtin/多架构模型引擎与神经网络实现backend/diffusion_engine/、backend/nn/第三方 LoRA 实现参考packages_3rdparty/自定义处理逻辑的切入点modules_forge/main_entry.py、modules_forge/main_thread.py、alter_samplers.py问题反馈项目 Issue 与 Discussion 区作者会定期查看写在最后Forge 的价值很具体一键包消灭了环境搭建量化加卸载机制让小显存也能跑大模型内置扩展省去了大半的兼容调试。建议你今天就按开头的四步把第一张图跑出来之后再从 GPU Weight 滑块开始慢慢摸透显存管理的几个开关——那是它和原版 WebUI 拉开差距的地方。【免费下载链接】stable-diffusion-webui-forge项目地址: https://gitcode.com/GitHub_Trending/st/stable-diffusion-webui-forge创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考