Z-Image Apple Silicon Mac 部署完全指南：M1/M2/M3/M4 本地 AI 图像生成实战

摘要：本文详细介绍如何在 Apple Silicon Mac（M1/M2/M3/M4）上部署和运行 Z-Image 模型，从环境配置、性能优化到 ComfyUI 集成，覆盖完整的本地 AI 图像生成工作流。

前言

Z-Image 是阿里巴巴通义实验室推出的 6B 参数开源图像生成模型，以其出色的速度、质量和双语文本渲染能力受到广泛关注。随着 Apple Silicon 芯片性能不断提升，在 Mac 上本地运行 Z-Image 已成为 AI 创作者和开发者的热门选择——无需昂贵 GPU、保护隐私、完全离线。

本文将手把手教你在 Apple Silicon Mac 上部署 Z-Image，涵盖以下方案：

• ComfyUI Desktop：一键安装，适合新手
• MLX 原生部署：极致性能，适合进阶用户
• OrdinarySF/z-image-inference：社区优化方案，两条命令即可运行
• 量化部署：4-bit/8-bit GGUF 格式，低内存运行

硬件要求

最低配置

组件	最低要求	推荐配置
芯片	M1 / M1 Pro	M2 / M3 / M4 系列
统一内存	16 GB	32 GB 或更高
存储空间	30 GB 可用空间	50 GB 可用空间

各芯片性能参考

根据社区实测数据（Reddit r/StableDiffusion、YouTube 基准测试）：

• M1 16GB：Z-Image Turbo 4-bit 量化，单图约 30-45 秒
• M2 Pro 16GB：Z-Image Turbo 全精度，单图约 20-30 秒
• M3 Max 48GB：Z-Image Base 全精度，单图约 10-15 秒
• M4 Max 64GB：Z-Image Base + LoRA，单图约 8-12 秒

💡 关键发现：Reddit 用户报告在 M 系列芯片上配合 4-bit 量化，Z-Image Turbo 可在 14 秒内生成图片，这对于 Mac 本地推理来说是非常出色的表现。

方案一：ComfyUI Desktop（推荐新手）

安装步骤

1. 安装 ComfyUI Desktop

1. 访问 ComfyUI Desktop 下载页面
2. 下载 macOS Apple Silicon 版本
3. 拖入 Applications 文件夹

2. 下载 Z-Image 模型文件

Z-Image 模型文件总大小约 21 GB，需要下载以下组件：

• Text Encoder：CLIP + T5（~4 GB）
• Diffusion Model：Z-Image Turbo 或 Z-Image Base（~14 GB）
• VAE：自动编码器（~2 GB）

从 HuggingFace 下载：

# 使用 huggingface-cli
huggingface-cli download Tongyi-MAI/Z-Image-Turbo --local-dir ./models/z-image-turbo

3. 配置 ComfyUI

1. 将模型文件放入 ComfyUI 对应目录
2. 下载 Z-Image 专用工作流 JSON
3. 拖入 ComfyUI 即可开始生成

4. 开始生成

打开 ComfyUI Desktop，加载工作流，输入提示词，点击 "Queue Prompt" 即可。

优点与缺点

优点	缺点
图形界面，操作简单	内存占用较高
可视化节点工作流	自定义优化有限
社区资源丰富	启动速度较慢

方案二：MLX 原生部署（推荐进阶用户）

什么是 MLX？

MLX 是 Apple 推出的机器学习框架，专为 Apple Silicon 优化。相比传统的 PyTorch + MPS 方案，MLX 具有以下优势：

• 原生 Metal 支持：直接利用 GPU 加速
• 动态内存管理：比 PyTorch 更高效的内存使用
• 更低延迟：推理速度提升 20-40%

安装步骤

# 1. 安装 MLX
pip3 install mlx mlx-linalg

# 2. 克隆 Z-Image MLX 适配仓库
git clone https://github.com/ml-explore/mlx-examples.git
cd mlx-examples/stable_diffusion

# 3. 下载量化模型
python3 download.py --quantize

# 4. 运行生成
python3 generate.py --prompt "一只在日落海滩漫步的金毛犬"

性能调优

# 4-bit 量化（适合 16GB 内存）
python3 generate.py --prompt "..." --quantize 4

# 8-bit 量化（平衡性能与质量）
python3 generate.py --prompt "..." --quantize 8

# 全精度（需要 32GB+ 内存）
python3 generate.py --prompt "..."

MLX 专属优化技巧

1. 启用 Unified Memory 优化：macOS 15+ 原生支持
2. 后台运行：使用 nohup 避免终端关闭中断
3. 批量生成：一次生成多张图片，减少模型加载开销

方案三：OrdinarySF/z-image-inference（社区推荐）

简介

OrdinarySF/z-image-inference 是社区最流行的 Z-Image Mac 部署方案，特点：

• 两条命令即可运行
• MPS 优化：Apple Silicon 原生加速
• Gradio Web UI：浏览器即可操作
• 双语支持：中英文提示词无缝切换

安装

# 1. 克隆仓库
git clone https://github.com/OrdinarySF/z-image-inference.git
cd z-image-inference

# 2. 一键安装
bash install.sh

# 3. 启动 Gradio 界面
bash run.sh

启动后，访问 http://localhost:7860 即可在浏览器中使用。

配置选项

# 指定模型路径
bash run.sh --model-path ./models/z-image-turbo

# 指定量化精度
bash run.sh --quantize 4

# 自定义端口
bash run.sh --port 8080

方案四：GGUF 量化部署（低内存方案）

什么是 GGUF？

GGUF（Generic GPU Format）是 llama.cpp 项目开发的模型量化格式，现在被广泛用于扩散模型。在 Mac 上，GGUF 格式配合 Metal 后端可实现极低的内存占用。

部署步骤

# 1. 下载 GGUF 格式的 Z-Image 模型
# 从 HuggingFace 搜索 z-image gguf

# 2. 使用 z-image.app 工具运行
brew install z-image-app

# 3. 启动
z-image-app run --model ./z-image-turbo-gguf-q4.gguf

量化级别对比

量化级别	文件大小	内存占用	生成速度	质量损失
FP16（全精度）	~14 GB	16-24 GB	基准	无
Q8（8-bit）	~7 GB	8-12 GB	+15%	极小
Q4（4-bit）	~4 GB	4-6 GB	+40%	轻微

💡 建议：16GB 内存使用 Q8，8GB 内存使用 Q4。社区反馈 Q4 量化在 Z-Image 上质量损失非常小，日常使用几乎察觉不到。

性能优化技巧

1. 内存管理

# 限制 PyTorch 缓存
export PYTORCH_MPS_HIGH_WATERMARK_CAPACITY=8G

# 使用垃圾回收
python3 -c "import torch; torch.mps.empty_cache()"

2. 批量生成优化

# 批量推理比逐张生成快 30-50%
pipe = DiffusionPipeline.from_pretrained("Tongyi-MAI/Z-Image-Turbo")
pipe.to("mps")

# 一次性生成 4 张
images = pipe(prompt, num_images_per_prompt=4).images

3. 使用 Metal Performance Shaders (MPS)

import torch
# 确保使用 MPS 后端
device = "mps" if torch.backends.mps.is_available() else "cpu"
model.to(device)

4. 后台任务管理

# 使用 tmux 或 screen 保持后台运行
tmux new -s zimage
bash run.sh
# Ctrl+B, D 分离会话
tmux attach -t zimage  # 重新连接

常见问题

Q: 16GB 内存够用吗？

A: 足够运行 Z-Image Turbo 4-bit 量化版本。社区实测 M1 16GB 可稳定生成，单图约 30-45 秒。如果同时运行其他大型应用，建议关闭浏览器标签页和 Photoshop 等内存大户。

Q: M4 芯片相比 M3 提升多少？

A: 根据 Early Access 用户反馈，M4 Max 64GB 运行 Z-Image Base 全精度时，速度比 M3 Max 48GB 提升约 30-40%，主要得益于更大的统一内存带宽和更高效的 GPU 核心。

Q: 可以运行 Z-Image Base 和 Turbo 两个模型吗？

A: 可以，但不能同时加载。建议在 ComfyUI 中配置切换工作流，或使用脚本动态加载/卸载模型。

Q: LoRA 训练支持吗？

A: 在 Mac 上训练 LoRA 理论可行但效率较低。建议使用 Cloud GPU 训练 LoRA，然后在 Mac 上加载 LoRA 进行推理。MLX 框架对 LoRA 推理支持良好。

总结

在 Apple Silicon Mac 上部署 Z-Image 已经非常成熟，主要方案对比如下：

方案	适合人群	安装难度	性能	推荐场景
ComfyUI Desktop	新手	⭐	⭐⭐⭐	日常创作
MLX 原生	开发者	⭐⭐⭐	⭐⭐⭐⭐⭐	性能优先
OrdinarySF 方案	中级用户	⭐⭐	⭐⭐⭐⭐	快速上手
GGUF 量化	低内存用户	⭐⭐	⭐⭐⭐	轻量部署

无论选择哪种方案，Z-Image 在 Apple Silicon 上的表现已经足以满足日常创作需求。对于专业用户，M3/M4 Max + 32GB+ 内存的配置可提供接近消费级 NVIDIA GPU 的体验。

---

本文基于 2026 年 5 月社区实测数据和官方文档编写。硬件性能可能随 macOS 和驱动更新而变化。