# Hyper-V

Agradecimentos especiais ao nosso contribuinte da comunidade [@Jordanwise](https://forum.ewelink.cc/u/jordanwise) por criar e compartilhar este vídeo tutorial útil:

{% embed url="<https://www.youtube.com/watch?v=StVw-60Piuk>" %}

### 1. Preparação <a href="#id-1.-prerequisites" id="id-1.-prerequisites"></a>

{% stepper %}
{% step %}
**Faça o download do** CUBE OS **imagem**

Visite este [repositório](https://github.com/eWeLinkCUBE/CUBE-OS/releases/latest) para baixar o mais recente `.vmdk` imagem. Por favor, extraia a imagem após o download.
{% endstep %}

{% step %}
**Instalar o Hyper-V**

Windows 10 / 11 Pro, Enterprise ou Education (Hyper-V necessário)

Hyper-V habilitado no seu sistema: Antes de usar o Hyper-V, certifique-se de que ele esteja habilitado no Windows. Abra **Painel de Controle → Programas → Ativar ou desativar recursos do Windows**,&#x20;

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FWDcT9mnUIFijGtyKD6cm%2Fimage.png?alt=media&#x26;token=e436eae3-61cb-4e08-a3e0-612f0b37960b" alt="" width="310"><figcaption></figcaption></figure></div>

ativar **Hyper-V** (incluindo *Ferramentas de Gerenciamento do Hyper-V* e *Plataforma Hyper-V*), **Plataforma de Máquina Virtual**, **Plataforma do Hypervisor do Windows**, então clique em **OK** e reinicie o seu computador.

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FULGXxO2KkrnniwM6CQvr%2Fimage.png?alt=media&#x26;token=0ce61757-dbf8-4ba5-9ab9-b8d635250028" alt="" width="332"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Adaptador Zigbee (Opcional)**

Se precisar adicionar dispositivos Zigbee USB, observe que o Hyper-V não suporta passthrough USB nativo para dispositivos de hardware, como dongles Zigbee. Se for necessário acesso USB, considere usar uma **solução USB-over-IP** ou um **coordenador Zigbee baseado em rede** em vez disso.
{% endstep %}
{% endstepper %}

### 2. Converter a Imagem do CUBE OS para VHDX <a href="#id-2.-convert-the-cube-os-image-to-vhdx" id="id-2.-convert-the-cube-os-image-to-vhdx"></a>

Antes de criar a máquina virtual, converta a imagem de disco do CUBE OS para um **VHDX** formato compatível com o Hyper-V.

{% stepper %}
{% step %}
Baixe e instale uma ferramenta de conversão de imagem de VM, como **Conversor de Imagem de VM** (recomendado no Windows)&#x20;

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FClQstydrldjmcLuKnY6J%2Fimage.png?alt=media&#x26;token=82d68ed0-cbdb-40ab-a655-43355f62d0d9" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Inicie o conversor e selecione:

* Formato de origem: **VMDK**
* Formato de destino: **VHDX**

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F7iCfbFg9ACqHTf4qWAMQ%2Fimage.png?alt=media&#x26;token=9cdf81ab-e4b2-4cd9-a75f-f6a265b57973" alt="" width="360"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Conclua a conversão e anote a localização do `.vhdx` arquivo gerado.

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FQKS70hxaW1oTz6RCwmic%2Fimage.png?alt=media&#x26;token=eeffdb9e-2408-46aa-926e-a1be47ad6bb2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### 3. Criar a Máquina Virtual <a href="#id-3.-create-the-virtual-machine" id="id-3.-create-the-virtual-machine"></a>

{% stepper %}
{% step %}
Inicie **Gerenciador do Hyper-V**.

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FKLGnYhpnW4TUgAiSVzta%2Fimage.png?alt=media&#x26;token=27dfe2ee-cefa-473b-a5eb-397ecf905871" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Criação Rápida** → Selecione![](https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F8yCryNG9EQ2ZML71mllN%2Fimage.png?alt=media\&token=d005ecdb-686a-4373-bf54-14a94a273d1f)**Fonte de instalação local**.

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2Ff5qgA3WXeEw1KlNAQehR%2Fimage.png?alt=media&#x26;token=6f4f67dc-11c5-4f87-b794-26cb34e01b97" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Selecione **Alterar fonte de instalação**, selecione o **CUBE OS `.vhdx`** arquivo convertido e desative **Inicialização Segura do Windows**.

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FLekBkkamd2Hydx4xsEYv%2Fimage.png?alt=media&#x26;token=0ed27f1f-3756-4fdf-8dab-d3491a5ca132" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Digite um nome para a VM (por exemplo, `CUBE OS`), e então **Criar Máquina Virtual**.
{% endstep %}
{% endstepper %}

### 4. Configurar as Configurações da Máquina Virtual <a href="#id-4.-configure-virtual-machine-settings" id="id-4.-configure-virtual-machine-settings"></a>

{% stepper %}
{% step %}
Clique em **Configurações** para a máquina virtual recém-criada.

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FlyxZ9KvMx4bpzL0cQEes%2Fimage.png?alt=media&#x26;token=e6cbd439-042d-4cef-821a-7d86bf1558bc" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Atribuir Recursos do Sistema:

* Mínimo: **4096 MB (4 GB)**
* Desative a Memória Dinâmica (recomendado).
* **Processador**: 2 processadores virtuais

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FZdfwbJkXE2NyfMI6Wcsb%2Fimage.png?alt=media&#x26;token=c941758a-e5b1-44ad-91e9-03f757a6434f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Aplicar** e **OK** para salvar as configurações.
{% endstep %}
{% endstepper %}

### 5. Inicializar o CUBE OS

{% stepper %}
{% step %}
Clique em **Conectar** e **Iniciar** a máquina virtual criada.

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FafxqxaM2WCQFAmiBM1PL%2Fimage.png?alt=media&#x26;token=78525be1-b531-4151-af31-c4a3952da45e" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Aguarde alguns instantes para o CUBE OS ser inicializado. Monitore a tela de inicialização até que o boot esteja completo.

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FmsvbU2r30xq0WmtqjTLP%2Fimage.png?alt=media&#x26;token=bbe50140-3a33-4d18-92cf-43df705b49b1" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Uma vez concluído, você verá o IP do CUBE OS exibido na tela. Use este endereço IP ou [cube.local](http://cube.local/) para acessar a página de gerenciamento web do CUBE OS.

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2F6T5sTzxEzfPdiYX1nH0t%2Fimage.png?alt=media&#x26;token=bc18e466-130b-42c2-9f1f-70e704895398" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Após acesso bem-sucedido, um ID curto pode ser visto 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 múltiplas instâncias do CUBE OS na mesma rede local.

<div align="left"><figure><img src="https://1945363319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCnF8kmk9yw3yiy2mRerq%2Fuploads%2FtKCHG1Z8FMgijVHgUxdU%2Fimage.png?alt=media&#x26;token=d0f0bc2f-9599-4b45-9c7c-61eb7af32ab4" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}