> 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-pt/primeiros-passos/quickstart/dispositivos-nas/synology-nas.md).

# Synology NAS

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

## 1. Preparação

Por favor, certifique-se de que sua configuração atende aos seguintes requisitos:

{% stepper %}
{% step %}
**6GB de RAM** instalados (recomendado) no seu Synology NAS (4GB para a máquina virtual executando o CUBE OS); entre em contato com a Synology para guias de atualização se sua unidade tiver apenas 2GB ou menos de memória.
{% endstep %}

{% step %}
Seu NAS possui uma plataforma x86\_64

{% hint style="info" %}
Atualmente, apenas a arquitetura x86\_64 é suportada por este método de instalação.

Para ARM e outras plataformas, por favor utilize outros dispositivos e aguarde atualizações futuras.
{% endhint %}

{% hint style="info" %}
Você pode consultar este [documento](https://kb.synology.com/en-me/DSM/tutorial/What_kind_of_CPU_does_my_NAS_have) para encontrar as informações da plataforma para seus dispositivos Synology.
{% endhint %}
{% endstep %}

{% step %}
Acesso WAN para baixar o gerenciador de máquinas virtuais
{% endstep %}

{% step %}
Conta de administrador no seu Synology NAS
{% endstep %}

{% step %}
Adaptador Zigbee (Opcional)

Se precisar adicionar dispositivos Zigbee, prepare um Dongle Zigbee. Dongles Zigbee testados incluem:

> SONOFF ZBDongle-MAX\
> SONOFF ZBDongle-PMG24\
> SONOFF ZBDongle-LMG21\
> SONOFF ZBDongle-E\
> SONOFF ZBDongle-P\
> [Outros listados](https://darkxst.github.io/silabs-firmware-builder/) pelo desenvolvedor @darkxst&#x20;

{% hint style="info" %}
Para obter mais informações sobre configurações e compatibilidade do Zigbee, consulte este [guia](/english-pt/verificacao-de-compatibilidade/zigbee.md).
{% endhint %}
{% endstep %}
{% endstepper %}

## 2. Instalação

{% stepper %}
{% step %}
Visite este [repositório](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) para baixar a imagem do CUBE OS que termina com `.vdi`&#x20;
{% endstep %}

{% step %}
&#x20;Acesso ao painel do Synology

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

{% step %}
Instalar `Virtual Machine Manager` a partir do Centro de Pacotes

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

{% step %}
Inicie `Virtual Machine Manager` a partir do painel e mude para a página Imagem.
{% endstep %}

{% step %}
Entre na aba Imagem de Disco, então clique em `Adicionar` botão.

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

{% step %}
Siga o guia para enviar o `.vdi` arquivo que você baixou no [passo](#preparation).

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

{% step %}
Conclua os passos e aguarde até que esteja totalmente enviado.
{% endstep %}

{% step %}
Mude para a `Imagem` aba e envie o arquivo .vdi para seu NAS. Por favor, aguarde até que o upload seja concluído.

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

{% step %}
Mude para a `Máquina Virtual` página e clique no ícone de dropdown ao lado do `Criar` botão e use `Importar`.&#x20;

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

{% step %}
Selecione o `Importar a partir de imagens de disco` opção no assistente.

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

{% step %}
Selecione o armazenamento onde você enviou o arquivo do disco virtual.

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

{% step %}
Defina os recursos computacionais que o CUBE OS necessita.

{% hint style="info" %}
**Recomenda-se 2 vCPUs e 4GB de RAM para uma melhor experiência.**
{% endhint %}

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

{% step %}
Escolha o disco virtual na lista suspensa.

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

{% step %}
⚠️ Para `Outras Configurações`, escolha `UEFI` na `Firmware` opção.

![](/files/87e5be29747dbce5bd9bf225b7db8fac35651476)
{% endstep %}

{% step %}
Opcional: Conecte seu dongle Zigbee ao seu NAS e faça o passthrough do dispositivo para a máquina virtual nesta página.

{% hint style="info" %}
Para obter mais informações sobre configurações e compatibilidade do Zigbee, consulte este [guia](/english-pt/verificacao-de-compatibilidade/zigbee.md).
{% endhint %}

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

{% step %}
Atribua permissão de gerenciamento às contas do seu NAS.
{% endstep %}

{% step %}
Revisão final da sua configuração, verifique `Ligue a máquina virtual após a criação` e clique em `Concluído`

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

{% step %}
Aguarde alguns minutos. Digite [cube.local](http://cube.local) no seu navegador para acessar a página de integração.

Você também pode acessá-la via IP alternativamente.

<img src="/files/55e7bec78ed7818717a248fda8b4bef8423d47ef" alt="" data-size="original">

{% hint style="info" %}
Após o acesso bem‑sucedido, um ID curto pode ser visualizado na página de configurações. Em seguida, acesse a página de gerenciamento Web do CUBE OS usando cube-{short id}.local, o que é útil para diferenciar várias instâncias do CUBE OS na mesma rede local.
{% 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-pt/primeiros-passos/quickstart/dispositivos-nas/synology-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.
