M3芯片MacBook Pro部署使用ComfyUI保姆级教程

ComfyUI.org

2025-03-14 14:02:37

以下是为 M3 芯片 MacBook Pro 设计的 ComfyUI 保姆级安装教程，涵盖手动安装与一键客户端两种方式，结合国内网络环境优化步骤：

01—准备工作

系统要求：
- macOS 12.3 或更高版本（建议升级至最新系统）
- 网络环境稳定（需全局科学上网或使用镜像源）
- 存储空间预留至少 10GB 用于模型文件（推荐使用 SSD 外置硬盘扩展）

02—手动安装教程（适合自定义需求）

步骤 1：安装基础依赖

# 安装 Homebrew（国内镜像加速）
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

# 安装依赖包
brew install cmake protobuf rust git wget python@3.10

步骤 2：创建虚拟环境并部署 ComfyUI

# 克隆仓库
git clone https://github.com/comfyanonymous/ComfyUI.git ~/ComfyUI

# 创建虚拟环境
cd ~/ComfyUI && python3 -m venv venv

# 激活环境并安装依赖
source venv/bin/activate
pip install --upgrade pip
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cpu
pip install -r requirements.txt

步骤 3：模型配置

方式一（推荐镜像下载）：

wget -P ~/ComfyUI/models/checkpoints https://hf-mirror.com/LarryAIDraw/v1-5-pruned-emaonly/resolve/main/v1-5-pruned-emaonly.ckpt

方式二（复用 SD-WebUI 模型）：

mv ~/ComfyUI/extra_model_paths.yaml.example extra_model_paths.yaml
sed -i '' 's#path/to/stable-diffusion-webui#~/stable-diffusion-webui#g' ~/ComfyUI/extra_model_paths.yaml

步骤 4：启动与汉化

启动服务：

cd ~/ComfyUI && source venv/bin/activate
python main.py --auto-launch --listen --output-directory ~/Desktop

汉化设置：
```
cd ~/ComfyUI/custom_nodes
git clone https://github.com/AIGODLIKE/AIGODLIKE-COMFYUI-TRANSLATION.git
```
启动后，在设置界面选择“中文简体”，点击“Switch Locale”按钮生效。

03—一键客户端安装（适合新手）

步骤 1：下载 ComflowySpace（官方推荐）

访问 GitHub Releases 页面：https://github.com/6174/comflowyspace/releases
选择适配 M3 芯片的版本（如 ComflowySpace_Mac_ARM.dmg）。

步骤 2：安装与配置

双击安装包，拖拽至 Applications 文件夹。
首次启动时选择 ComfyUI 安装目录（推荐默认路径）。
在软件设置中切换语言为中文，安装插件管理器：
- 复制插件 GitHub 地址：https://github.com/ltdrdata/ComfyUI-Manager
- 在“插件”界面通过 URL 安装。

步骤 3：启动与使用

点击软件右上角“Terminal”获取本地访问地址（如 http://127.0.0.1:8188）。
直接使用内置模板或导入自定义工作流（支持拖拽 .json 文件）。

04—常见问题解决

依赖安装失败：
切换 pip 镜像源：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

启动报错“numpy 版本冲突”：

pip uninstall numpy && pip install numpy==1.26.4

客户端崩溃频繁：
- 尝试手动安装版本。
- 检查系统权限（设置 - 隐私与安全性 - 允许 ComflowySpace）。

05—进阶优化

外置硬盘部署：
手动安装版本可将整个 ComfyUI 文件夹拷贝至外置 SSD，启动时指定路径：
```
cd /Volumes/SSD/ComfyUI && source venv/bin/activate && python main.py
```

性能调优：
编辑 ~/.bash_profile 添加环境变量提升推理速度：

export PYTORCH_ENABLE_MPS_FALLBACK=1
export PYTORCH_MPS_HIGH_WATERMARK_RATIO=0.8

通过以上步骤，M3 芯片 MacBook Pro 可流畅运行 ComfyUI。推荐新手优先使用客户端，进阶用户选择手动安装以深度定制。

news