ControlNet安装与使用教程详解

科技周边小白一枚，正在不断学习积累知识，现将学习到的知识记录一下，也是将我的所得分享给大家！而今天这篇文章《ControlNet使用教程：安装与基础操作详解》带大家来了解一下##content_title##，希望对大家的知识积累有所帮助，从而弥补自己的不足，助力实战开发！

ControlNet插件未启用需按六步解决：一、通过WebUI Extensions安装；二、从Git URL安装；三、手动解压安装；四、命令行Git克隆；五、下载并放置.pth与.yaml模型至models目录；六、在文生图中启用、上传参考图、匹配预处理器与模型、设参数后生成。

如果您已安装 Stable Diffusion WebUI，但 ControlNet 插件尚未启用或无法正常调用，则可能是插件未正确安装、模型缺失或界面未正确加载。以下是解决此问题的步骤：

一、ControlNet 插件安装（四种方法）

插件安装需确保与当前 WebUI 版本兼容，且路径放置准确。不同网络环境适用不同安装方式，任选其一即可完成部署。

1、打开 Stable Diffusion WebUI，点击顶部菜单栏的 Extensions → Available，等待插件列表加载完成。

2、在页面右上角点击 Load from 按钮，确认 Extension index URL 已填充默认地址（如未填充，可手动输入 https://raw.githubusercontent.com/AUTOMATIC1111/stable-diffusion-webui/master/extensions-builtin/index.json）。

3、按下 Ctrl + F 调出搜索框，输入 controlnet，定位到 sd-webui-controlnet 插件条目。

4、点击右侧 Install 按钮，待提示“Installed”后，点击页面上方黄色按钮 Apply and restart UI 重启界面。

二、从 Git 仓库网址安装

该方式支持后续自动更新，推荐长期使用用户采用，避免手动拉取新版本。

1、进入 Extensions → Install from URL 标签页。

2、在 Extension's git repository URL 输入框中粘贴：https://github.com/Mikubill/sd-webui-controlnet.git。

3、点击 Install，等待安装日志显示 Installed into .../extensions/sd-webui-controlnet。

4、切换至 Installed 标签页，点击 Check for updates，再点击 Apply and restart UI。

三、手动解压安装（离线/受限网络适用）

适用于无法访问 GitHub 或 HuggingFace 的环境，需自行下载并校验文件完整性。

1、访问 GitHub 仓库：https://github.com/Mikubill/sd-webui-controlnet，点击右侧绿色 Code → Download ZIP。

2、解压 ZIP 文件，得到名为 sd-webui-controlnet 的文件夹。

3、将其完整复制至 WebUI 根目录下的 extensions/ 文件夹内（路径示例：stable-diffusion-webui/extensions/sd-webui-controlnet）。

4、完全关闭 WebUI 进程（包括后台 Python 进程），重新启动 WebUI。

四、通过命令行 Git 克隆安装

适合熟悉终端操作的用户，可确保获取最新开发分支代码，便于调试或测试预发布功能。

1、打开文件管理器，进入 WebUI 的 extensions/ 目录。

2、在地址栏输入 cmd 并回车，弹出命令行窗口。

3、执行命令：git clone https://github.com/Mikubill/sd-webui-controlnet.git。

4、等待克隆完成，关闭命令行，重启 WebUI。

五、ControlNet 模型下载与放置

插件仅提供控制逻辑框架，实际功能依赖外部 .pth 和 .yaml 模型文件。缺少任一类型文件均会导致预处理器不可用或报错。

1、访问 Hugging Face 官方模型库：https://huggingface.co/lllyasviel/ControlNet/tree/main/models。

2、下载至少两个基础模型：control_v11p_sd15_canny.pth 与 control_v11p_sd15_openpose.pth，及其对应同名 .yaml 文件。

3、将所有下载的 .pth 和 .yaml 文件放入：extensions/sd-webui-controlnet/models/ 目录。

4、重启 WebUI 后，在文生图界面底部展开 ControlNet 面板，确认下拉菜单中出现多个模型选项且无红色报错提示。

六、ControlNet 基础使用流程

启用 ControlNet 后，需配合参考图、预处理器与模型协同工作，每一步参数设置直接影响输出稳定性与可控性。

1、在文生图界面底部找到 ControlNet 折叠面板，勾选 Enable 开关。

2、点击画板图标或直接拖入一张参考图（建议分辨率不低于 512×512，格式为 PNG/JPG）。

3、在 Preprocessor 下拉菜单中选择与目标效果匹配的提取方式，例如：上传人物图选 openpose，线稿图选 canny。

4、在 Model 下拉菜单中选择对应名称的模型，确保与预处理器一致（如 openpose 预处理器必须配 openpose 模型）。

5、设置 Weight 值为 1.0 作为起始点，Resize mode 保持 Scale to fit (Inner Fit)。

6、输入正向提示词（如 a cyberpunk street at night, neon lights, rain puddles），点击生成按钮。

今天关于《ControlNet安装与使用教程详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！