> 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/nas-she-bei/qun-hui-nas.md).

# 群晖 NAS

{% embed url="<https://youtu.be/coJYs-3Jnbo?si=idrpiu9LcMBNvHGa>" %}

## 1. 准备工作

请确保您的环境满足以下要求：

{% stepper %}
{% step %}
**6GB 内存** 已安装（推荐）在您的 Synology NAS 上（运行 CUBE OS 的虚拟机建议 4GB）；如果您的设备只有 2GB 或更少内存，请联系 Synology 以获取升级指南。
{% endstep %}

{% step %}
您的 NAS 使用 x86\_64 平台

{% hint style="info" %}
目前此安装方式仅支持 x86\_64 架构。

对于 ARM 和其他平台，请使用其他设备并等待未来更新。
{% endhint %}

{% hint style="info" %}
您可以参考此官方 [文档](https://kb.synology.com/en-me/DSM/tutorial/What_kind_of_CPU_does_my_NAS_have) 以查找您 Synology 设备的平台信息。
{% endhint %}
{% endstep %}

{% step %}
可访问 WAN 以下载虚拟机管理器
{% endstep %}

{% step %}
Synology NAS 的管理员账户
{% 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. 安装

{% stepper %}
{% step %}
访问此 [代码仓库](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) 下载以 `.vdi`&#x20;
{% endstep %}

{% step %}
&#x20;访问 Synology 控制面板

<img src="/files/74518ac09c42bf2d9574ffaa1a6a88c604e69077" alt="" data-size="original">
{% endstep %}

{% step %}
从 `虚拟机管理器` 的套件中心安装

<img src="/files/94406c8e0278ed7cc9f8f4525cc08b12c70822a4" alt="" data-size="original">
{% endstep %}

{% step %}
从控制面板启动 `虚拟机管理器` 并切换到映像页面。
{% endstep %}

{% step %}
进入磁盘映像选项卡，然后点击 `添加` 按钮。

<img src="/files/244522da79f498295370fd08075168815f207f26" alt="" data-size="original">
{% endstep %}

{% step %}
按照指南上传您从上一步下载的 `.vdi` 文件 [步骤](#preparation).

<img src="/files/1d33740294cebe1629c3eb4017122475b6048746" alt="" data-size="original">
{% endstep %}

{% step %}
完成这些步骤并等待其完全上传。
{% endstep %}

{% step %}
切换到 `映像` 选项卡并将 .vdi 文件上传到您的 NAS。请等待上传完成。

<img src="/files/7d69ef8692c4d3d51485e77a999d5443d76bb9e9" alt="" data-size="original">
{% endstep %}

{% step %}
切换到 `虚拟机` 页面并点击创建按钮旁的下拉图标，使用 `创建` 按钮并使用 `导入`.&#x20;

<img src="/files/8e69eec09241ff0dce212be9f4070779c9c11bac" alt="" data-size="original">
{% endstep %}

{% step %}
在向导中选择 `从磁盘映像导入` 选项。

<img src="/files/2c693ca1912e5fac85b9768066386ecf80d6e60c" alt="" data-size="original">
{% endstep %}

{% step %}
选择您上传虚拟磁盘文件的存储位置。

<img src="/files/440a7f36274d3d1227941ed4e5afee7108afbecf" alt="" data-size="original">
{% endstep %}

{% step %}
设置 CUBE OS 所需的计算资源。

{% hint style="info" %}
**建议使用 2 个 vCPU 和 4GB 内存以获得更好体验。**
{% endhint %}

<img src="/files/e380a4ef38efc0e04f37ab7d6d0eebe61f77da91" alt="" data-size="original">
{% endstep %}

{% step %}
在下拉列表中选择虚拟磁盘。

<img src="/files/f54786f7d0037423999442b2aefa89509edb1bce" alt="" data-size="original">
{% endstep %}

{% step %}
⚠️ 对于 `其他设置`，选择 `UEFI` 在 `固件` 选项中。

![](/files/8bd2336dedf757c016a13a5f8ffcb115577ab387)
{% endstep %}

{% step %}
可选：将您的 Zigbee 加密狗插入 NAS，并在此页面将该设备直通到虚拟机。

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

<img src="/files/751d95a60d1425a96470a4000a725b4623aeeb17" alt="" data-size="original">
{% endstep %}

{% step %}
为您的 NAS 账户分配管理权限。
{% endstep %}

{% step %}
对配置进行最终检查，查看 `创建后为虚拟机开启电源` 并点击 `完成`

<img src="/files/32a34aa6ed9dca37460a5c869654dd3790042c27" alt="" data-size="original">
{% endstep %}

{% step %}
等待几分钟。在浏览器中输入 [cube.local](http://cube.local) 以访问入门页面。

您也可以改为通过 IP 访问。

<img src="/files/7f7fa15ddc84ac807bd9d5a089d6d9cc52a73fd5" alt="" data-size="original">

{% hint style="info" %}
成功访问后，可在设置页面查看短 ID。随后使用 cube-{short id}.local 访问 CUBE OS Web 管理页面，这对于在同一局域网中区分多个 CUBE OS 实例非常有用。
{% endhint %}
{% 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/nas-she-bei/qun-hui-nas.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.