> For the complete documentation index, see [llms.txt](https://cube.ewelink.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cube.ewelink.cc/english-zh/kuai-su-kai-shi/quickstart/yi-jian-an-zhuang/mac.md).

# Mac

本指南将向你展示如何使用一键安装程序在 macOS 上安装 CUBE OS。安装程序会为你准备环境、创建虚拟机并启动 CUBE OS。

{% hint style="info" %}
本指南遵循当前的一键安装程序流程。某些标签可能会因版本而异。
{% endhint %}

### 1. 准备

{% stepper %}
{% step %}
**检查你的 Mac**

请确保你的 Mac 已准备好进行安装：

* **系统**：受支持的 macOS 版本
* **网络**：稳定的互联网和局域网访问
* **权限**：macOS 管理员权限
  {% endstep %}

{% step %}
**下载安装程序**

前往 [CUBE OS 发布页面](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) 并下载 **适用于 Mac 的一键安装程序**.

<div align="left"><figure><img src="/files/8f1ef172f6b738efbc2419845b90cd491296c204" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Zigbee 适配器（可选）**

如果你需要添加 Zigbee 设备，请准备一个 Zigbee 加密狗。经过测试的 Zigbee 加密狗包括：

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [列出的其他项](https://darkxst.github.io/silabs-firmware-builder/) 由开发者 @darkxst 提供&#x20;

{% hint style="info" %}
有关 Zigbee 配置和兼容性的更多信息，请参阅此 [指南](/english-zh/jian-rong-xing-jian-cha/zigbee.md).
{% endhint %}
{% endstep %}
{% endstepper %}

### 2. 使用一键安装程序安装 CUBE OS

{% stepper %}
{% step %}
**打开安装程序**

在以下位置找到安装程序 **下载** 文件夹或你选择的文件夹中。打开安装包并按照屏幕上的步骤操作。

<div align="left"><figure><img src="/files/9e71834e373b7673342042493145f0e7173b412f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**让安装程序检查 VirtualBox**

安装程序会检查你的 Mac 上是否可用 VirtualBox。如果尚未安装 VirtualBox，请先按照屏幕上的步骤进行安装。

<div align="left"><figure><img src="/files/7f35d58a0ad095a6368ac7a7ff0da5b56452c881" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**设置虚拟机资源**

选择虚拟机名称、内存和 CPU 核心数。建议设置：

* **内存**：2048 MB 或更高
* **CPU**：2 个或更多核心

<div align="left"><figure><img src="/files/c93224f74f08f5530504637e27494e67616627d5" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**选择桥接网络适配器**

在你的 Mac 上选择一个活动的网络适配器。使用桥接适配器，这样 CUBE OS 就可以加入你的本地网络。

<div align="left"><figure><img src="/files/7739e1c5338929c1d3d16e6f802243660c009d86" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**可选：配置 USB 直通**

如果你使用 Zigbee 加密狗，请从列表中选择 USB 设备。如果你现在不需要 Zigbee，请跳过此步骤。

<div align="left"><figure><img src="/files/4b8765e76232946e622df1b09dbd44a3f7c445e5" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**开始安装**

安装程序会创建 CUBE OS 虚拟机并自动开始设置。请等待安装完成。

<div align="left"><figure><img src="/files/3c8d6801a263e44e8a7e7d8997ebb45c8d879d9b" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 3. 启动并访问 CUBE OS

{% stepper %}
{% step %}
**等待 CUBE OS 启动**

安装完成后，CUBE OS 会自动启动。启动完成后，记录屏幕上显示的 CUBE OS IP 地址。

<div align="left"><figure><img src="/files/3375a64045baa0ec23008fd6864dedcdfdf1d82e" alt="" width="365"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**打开 CUBE OS Web 控制台**

在同一网络上的浏览器中访问以下地址之一：

* `http://<CUBE_OS_IP>/`
* <http://cube.local>

<div align="left"><figure><img src="/files/f24ee164cbc9c148e8d6fdecc69aa561ee394551" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**之后使用简短本地地址**

设置完成后，你可以在设置页面找到简短 ID。

然后你可以使用 `cube-{short-id}.local` 在你的局域网中识别此 CUBE OS 实例。

<div align="left"><figure><img src="/files/968c7d39104c9d09b2bb4d9556882baaf1a92481" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cube.ewelink.cc/english-zh/kuai-su-kai-shi/quickstart/yi-jian-an-zhuang/mac.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.