ControlNet未显示需安装插件并部署模型文件。依次通过WebUI扩展市场、Git URL或手动解压安装插件，再将.pth/.safetensors及对应.yaml文件放入models目录，重启后启用面板并选择预处理器与模型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署 Stable Diffusion WebUI，但界面中未出现 ControlNet 控制面板，则说明 ControlNet 插件尚未安装或模型未就位。ControlNet 依赖插件本体与配套模型文件协同工作，二者缺一不可。以下是完成安装与配置的完整操作路径：
一、通过 WebUI 扩展市场安装
该方式适用于网络环境稳定、能正常访问 GitHub 及 HuggingFace 的用户，操作最简捷，且支持后续一键检查更新。
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 仓库 URL 安装
此方式可确保插件目录结构规范，并启用 WebUI 内置的自动更新机制，适合长期使用、需保持版本同步的用户。
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 的封闭环境，需人工下载并校验 ZIP 包完整性，路径必须严格匹配。
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 进程），重新运行启动脚本。
四、ControlNet 模型文件部署
插件仅提供控制逻辑框架，实际功能需依赖外部模型文件（.pth 或 .safetensors）驱动。模型必须置于指定子目录，否则 ControlNet 面板将显示为空或报错“no model found”。
1、访问官方模型库：https://huggingface.co/lllyasviel/ControlNet-v1-1/tree/main，下载所需模型（推荐优先获取 control_v11p_sd15_canny.pth 与 control_v11p_sd15_openpose.pth）。
2、注意区分版本标识：文件名结尾为 p 的为稳定版，结尾为 e 的为测试版，不推荐选用测试版。
3、将下载的模型文件（.pth 或 .safetensors）连同对应 .yaml 文件一并放入：extensions/sd-webui-controlnet/models/ 目录。
4、若需使用 brightness 控制二维码等特殊功能，额外下载：https://huggingface.co/ioclab/ioc-controlnet/resolve/main/models/control_v1p_sd15_brightness.safetensors，同样存入上述 models 文件夹。
五、验证与启用配置
安装与模型部署完成后，需通过 UI 层级操作确认组件已正确挂载并激活，避免因设置遗漏导致功能不可见。
1、重启 WebUI 后，在文生图（txt2img）或图生图（img2img）界面底部查找 ControlNet 折叠面板，若可见即表示插件本体已加载成功。
2、点击面板左上角 启用 复选框，确保其处于勾选状态。
3、在 预处理器（Preprocessor） 下拉菜单中选择对应类型（如 canny、openpose），此时右侧 模型（Model） 下拉菜单应同步出现已部署的匹配模型名称。
4、若模型下拉为空，请检查 models/ 目录内文件是否同时包含 .pth（或 .safetensors）与同名 .yaml 文件，二者缺一则无法识别。
