Mac 系统下 Stable Diffusion WebUI 本地部署指南
前言
Stable Diffusion 是一款开源的深度学习文本到图像生成模型。在 macOS 上运行 Stable Diffusion WebUI，可以让开发者和本地用户利用 Apple Silicon (M1/M2/M3) 芯片进行 AI 绘画创作。本文将详细介绍如何在 Mac 环境下从零开始搭建 Stable Diffusion WebUI 运行环境。
硬件与环境要求
- 操作系统: macOS 12.0 及以上版本。
- 芯片: 建议 Apple Silicon (M1, M2, M3) 系列，Intel 芯片支持度较差且效率较低。
- 内存: 建议 16GB 以上，8GB 可能无法运行大模型或需要开启低显存模式。
- 硬盘: 预留至少 20GB 空间用于安装依赖、模型及缓存。
一、安装基础工具
1. 安装 Homebrew
Homebrew 是 macOS 的软件包管理器，用于简化依赖安装。打开终端，执行以下官方安装命令：
/bin/zsh -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后，验证版本：
brew --version
2. 安装 Python 及依赖
Stable Diffusion 基于 Python 开发，推荐使用 Python 3.10 版本。建议创建虚拟环境以避免污染系统 Python。
brew install [email protected] git wget cmake protobuf rust
进入项目目录后，创建并激活虚拟环境：
python3.10 -m venv venv
source venv/bin/activate
二、部署 Stable Diffusion WebUI
1. 克隆仓库
使用 Git 将官方 WebUI 仓库克隆到本地：
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git
cd stable-diffusion-webui
2. 安装依赖
首次运行前需安装 Python 依赖。可以直接运行启动脚本，它会自动处理大部分依赖，但推荐手动确保依赖完整：
pip install -r requirements_versions.txt
三、配置基础模型
WebUI 本身不包含模型文件，需要手动下载并放置到指定目录。
- 模型来源: 可前往 Civitai 或 HuggingFace 下载
.ckpt或.safetensors格式的模型。 - 模型类型:
- Checkpoint (大模型): 决定画风和基础能力，如 SD 1.5, SDXL。
- LoRA: 微调模型，用于特定风格或人物。
- 放置路径: 将下载的模型文件放入
stable-diffusion-webui/models/Stable-diffusion/目录下。
四、运行 WebUI
在终端中进入项目根目录，执行启动脚本。针对 Mac M1/M2 芯片，建议添加显存优化参数：
./webui.sh --medvram --xformers
--medvram: 中等显存优化，适合 8GB-16GB 内存设备。--lowvram: 低显存优化，适合 8GB 以下内存设备。--xformers: 加速计算（部分版本可能需要）。
启动成功后，终端会显示本地访问地址（通常为 http://127.0.0.1:7860），在浏览器打开即可使用。
五、常见问题排查
- 权限问题: 如果提示
Permission denied，请尝试给脚本添加执行权限chmod +x webui.sh。 - 依赖冲突: 确保使用了虚拟环境，避免与系统自带 Python 冲突。
- 模型加载失败: 检查模型文件格式是否正确，以及是否放置在正确的文件夹内。
- 启动报错: 若遇到 Metal 相关错误，可尝试更新 macOS 系统至最新版本。
结语
完成上述步骤后，您即可在 Mac 上体验 Stable Diffusion 的 AI 生图功能。随着技术的迭代，社区插件和功能也在不断丰富，建议关注官方仓库以获取最新信息。