M4 Mac Mini｜VMware Fusion 安装 HomeAssistant OS 专属教程（ARM aarch64）

写在前面

M4 Mac Mini 是 Apple Silicon 架构（ARM64），安装 Home Assistant 必须选择 ARM 版镜像，Intel/x86 的镜像 M4 无法引导启动，千万别下错。

本教程使用 VMware Fusion 虚拟机方式安装 HAOS（Home Assistant Operating System），相比 Docker 版拥有完整的 Supervisor 管理面板，加载项安装、备份恢复、系统升级都更方便。

项目地址：Home Assistant | VMware Fusion

一、必备软件 & 镜像

1. VMware Fusion

版本要求：13.5 及以上（2024 版起个人使用永久免费）

• 访问 VMware 官网 下载 VMware Fusion Pro for Personal Use
• 安装后打开，在 系统设置 → 隐私与安全性 中授予 VMware Fusion 磁盘、网络、USB 完整权限

2. HAOS 镜像（M4 专用，重中之重）

官方下载：Home Assistant Operating System Releases

下载文件名：haos_generic-aarch64-xxx.vmdk.zip

• generic-aarch64 = ARM64 架构，M4 专用
• ⚠️ 千万别下 x86_64 / intel / amd64 版本，M4 无法引导
• 下载后右键解压，得到单个 .vmdk 文件
• 将 vmdk 文件放到无中文、无空格的路径（例如 ~/文稿/HAOS/）

3. 硬件资源分配（M4 最优配置）

二、新建虚拟机

系统选型（M4 固定选项）

打开 VMware Fusion，顶部菜单：文件 → 新建 → 创建自定义虚拟机 → 继续

• 操作系统：Linux → Other Linux 6.x kernel 64-bit Arm（Arm！M4 固定这个，没有 Intel 选项）→ 继续
• 磁盘：使用现有虚拟磁盘 → 选中解压好的 .vmdk 文件
• 勾选 「制作此磁盘的独立副本」（必勾，防止原文件损坏）→ 继续
• 末尾点击 「自定义设置」，进入逐项配置（不要直接完成）

虚拟机硬件精细设置

处理器与内存

• CPU：4 核
• 内存：4096 MB
• M4 不需要开 VT-x 虚拟化（无此选项）

网络适配器（搜米家/蓝牙设备关键）

• 模式：桥接模式（Bridged）
• 网卡：下拉选择当前在用的网卡（WiFi 或有线网卡）
• ❌ 禁用 NAT，只有桥接才能和局域网智能家居设备互通

硬盘

• 默认 32 GB 够用
• 后期存储不够可在这里直接扩容磁盘大小

USB 控制器（装 Zigbee/蓝牙网关必备）

• 开启 USB 直通
• 后续插入 USB dongle 后，虚拟机开机状态下顶部菜单栏 → 虚拟机 → USB，选择设备直通进 HA

显卡

• 显存 256 MB，默认即可
• 保存设置

三、开机初始化 HA

1. 点击 启动 按钮
2. 首次初始化约 8~15 分钟，黑屏转圈是正常的，不要关机或暂停，系统正在自动部署底层组件
3. 部署完成后，VMware 控制台会显示：

1

http://homeassistant.local:8123

同时显示 HA 的局域网 IP（如 192.168.1.66）

4. Mac 本机浏览器打开以下任一地址：
   • http://homeassistant.local:8123
   • http://192.168.1.xxx:8123（用实际显示的 IP）

四、HA 初始化注册

1. 创建管理员账号 — 输入用户名、密码，妥善保存
2. 时区 — 选择 Asia/Shanghai，填写所在城市
3. 等待后台自动安装插件
4. 进入 HA 主页即安装完成

五、M4 高频踩坑解决

打不开 8123 页面

开机黑屏无法启动

镜像下错了。 必须下载 generic-aarch64 版本，x86 镜像 M4 无法引导。重新下载 ARM 版镜像。

搜不到局域网设备

100% 网卡是 NAT 模式。 改成桥接模式（Bridged），重启 HA 虚拟机即可。

六、M4 实用优化

开机自启

虚拟机设置 → 通用 → 勾选 「Mac 开机自动启动此虚拟机」

快照备份

HA 配置完插件后，在 VMware Fusion 中拍一个快照（虚拟机 → 快照 → 拍摄快照），配置崩了一键恢复。

Docker 代理加速（可选）

如果你的网络拉取 ghcr.io 镜像慢，可在虚拟机控制台中配置 Docker 代理：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 以 root 用户登录虚拟机控制台
mkdir -p /etc/systemd/system/docker.service.d
cat > /etc/systemd/system/docker.service.d/proxy.conf << 'EOF'
[Service]
Environment="HTTP_PROXY=http://你的代理IP:7890"
Environment="HTTPS_PROXY=http://你的代理IP:7890"
Environment="NO_PROXY=localhost,127.0.0.1"
EOF
systemctl daemon-reload
systemctl restart docker

安装 HACS

装好 HA 后，在 HA 的加载项商店中安装 HACS，或通过终端一键安装：

1

wget -O - https://get.hacs.xyz | bash -

总结

M4 Mac Mini 上跑 HAOS 虚拟机性能完全够用，桥接网络 + USB 直通可以让 Zigbee、蓝牙等外设正常工作。配合 VMware 的快照功能，折��插件也不怕翻车。

• VMware Fusion 下载
• HAOS ARM64 镜像下载
• Home Assistant 官方文档