解决sd-webui-controlnet在Mac M2上安装超时问题

问题背景

在MacBook Pro M2设备上安装Stable Diffusion WebUI的ControlNet扩展时，用户遇到了操作超时错误。具体表现为从WebUI界面安装扩展时，系统提示超时错误，无法完成安装过程。

错误分析

该错误属于典型的网络连接超时问题，错误代码60表示操作超时。这种情况通常发生在：

1. 网络连接不稳定
2. 下载服务器响应缓慢
3. 本地网络配置问题
4. 大文件下载时网络中断

解决方案

手动安装方法

对于此类安装问题，推荐采用手动安装方式，具体步骤如下：

1. 打开终端应用程序
2. 导航至Stable Diffusion WebUI的extensions目录
3. 执行git克隆命令

具体操作命令如下：

cd ~/Documents/stable-diffusion-webui/extensions
git clone https://github.com/Mikubill/sd-webui-controlnet

验证安装

安装完成后，需要：

1. 重启Stable Diffusion WebUI服务
2. 在Web界面检查ControlNet是否出现在扩展列表中
3. 确认相关功能是否可用

技术原理

手动安装相比WebUI自动安装有以下优势：

• 绕过WebUI的安装超时限制
• 可以显示详细的下载进度
• 支持断点续传
• 便于排查具体问题

扩展建议

对于Mac用户，特别是M1/M2芯片设备，还建议：

1. 确保使用最新版git工具
2. 检查Python环境配置
3. 验证网络代理设置（如有）
4. 考虑使用更稳定的网络连接

总结

通过手动克隆仓库的方式，可以有效解决在Mac设备上安装ControlNet扩展时的超时问题。这种方法不仅适用于当前案例，也可作为其他类似扩展安装问题的通用解决方案。