> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dwe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração de rede

> Este guia cobre a configuração de rede cabeada no dweOS.

> [!NOTE]
>
> O dweOS não suporta mais Wi-Fi. A rede é configurada inteiramente através de
> interfaces Ethernet cabeadas e perfis de conexão do NetworkManager.

> [!WARNING]
>
> Modificar a configuração de rede envolve riscos. Se você configurar a rede de forma incorreta, poderá ficar sem conseguir se reconectar ao dispositivo sem passar por uma recuperação.

## Acessando a página

Navegue até `Network` na barra lateral.

![visualização da página inicial de rede do dweOS](https://mintcdn.com/deepwaterexplorationinc/IqcFrKs4qwLx7BjO/dwe-os/pages/images/dwe-os-networking.png?fit=max\&auto=format\&n=IqcFrKs4qwLx7BjO\&q=85\&s=6219ef08d08318d2824fed643dd2888b)

A página possui duas seções:

> **Configuração cabeada**
>
> Mostra todas as interfaces Ethernet detectadas, seu estado e os perfis de
> conexão disponíveis para ela.

> **Rede sem fio**
>
> Atualmente o Wi-Fi não é suportado pelo dweOS. Se você precisar de suporte a Wi-Fi, [envie uma issue](https://github.com/DeepWaterExploration/dweOS/issues).

## Conceitos essenciais

O dweOS gerencia a rede por meio do NetworkManager:

* **Interface**: uma porta cabeada física (por exemplo, `eth0`)
* **Perfil de conexão**: uma configuração de rede salva que pode ser vinculada a uma interface compatível. Uma interface pode ter
  vários perfis disponíveis, mas apenas um pode estar **ativo** por vez. Por padrão, as unidades enviadas com o dweOS pré-instalado terão apenas um perfil disponível (**Wired connection 1**).

Isso significa que alterar sua configuração de rede é um processo de duas etapas: **editar** as configurações de um
perfil e depois **ativar** esse perfil na interface (ou
reiniciar, o que reaplica o perfil ativo).

## Lista de interfaces

Cada interface aparece como uma seção recolhível mostrando seu nome e estado
atual:

| Estado | Significado |
| - | - |
| `UNAVAILABLE` | A interface existe mas não tem link (por exemplo, desconectada) |
| `DISCONNECTED` | O link está ativo, mas nenhum perfil está atualmente ativo |
| `PREPARE` / `CONFIG` / `IP_CONFIG` / `IP_CHECK` / `SECONDARIES` | Estados transitórios enquanto um perfil está sendo aplicado |
| `ACTIVATED` | Um perfil está ativo e a interface tem uma configuração de IP |
| `DEACTIVATING` | O perfil ativo está sendo desativado |
| `FAILED` | A ativação falhou |

> [!NOTE]
>
> Como é necessário se conectar pela rede para visualizar o dweOS, você pode ser desconectado após a configuração da rede. Isso significa que as saídas serão menos detalhadas do que o usual.

## Perfis de conexão

Abaixo de cada interface está a lista de perfis de conexão compatíveis com
ela. O perfil ativo é destacado e exibe uma marca de seleção, junto com suas
informações de rede em tempo real:

* **IPv4 Address**: o(s) endereço(s) atualmente atribuído(s), com o prefixo (por exemplo,
  `192.168.2.2/24`)
* **Default Route**: o gateway atualmente em uso, caso este perfil esteja configurado para
  fornecer a rota padrão
* **DNS**: os servidores DNS atualmente em uso

> [!TIP]
>
> Clique em qualquer perfil na lista para ativá-lo naquela interface.

## Editando um perfil

Clique no ícone de engrenagem de um perfil para abrir seu editor.

**1. Escolha o método IPv4**

* **Automatic (DHCP)**: a interface solicita um endereço a um servidor DHCP.
* **Manual (Static IP)**: você fornece o endereço, gateway e DNS
  manualmente.

**2. Configure as opções estáticas (somente Manual)**

![caixa de diálogo de configuração de rede estática do dweOS](https://mintcdn.com/deepwaterexplorationinc/IqcFrKs4qwLx7BjO/dwe-os/pages/images/dwe-os-networking-static.png?fit=max\&auto=format\&n=IqcFrKs4qwLx7BjO\&q=85\&s=60749ba54909e661cc6382768fffff12)

Quando Manual for selecionado, campos adicionais aparecem:

* **IP Addresses**: uma tabela de pares endereço/prefixo. Use o botão **Add IP
  Address** para adicionar outra entrada, ou o ícone da lixeira para remover.
* **DNS Servers**: uma lista separada por vírgulas (por exemplo, `8.8.8.8, 1.1.1.1`)
* **Gateway**: o IP do gateway para este perfil

**3. Defina a preferência de roteamento**

A caixa de seleção **Use for Internet (Default Route)** controla se este
perfil pode fornecer a rota padrão do sistema. Deixe marcada se estiver em dúvida.

**4. Aplicar alterações**

![ativação do perfil de conexão do dweOS](https://mintcdn.com/deepwaterexplorationinc/IqcFrKs4qwLx7BjO/dwe-os/pages/images/dwe-os-activate-connection.png?fit=max\&auto=format\&n=IqcFrKs4qwLx7BjO\&q=85\&s=e843fb1b29d51e05ac3d0b714539bbec)

Salvar grava a nova configuração no perfil.

> [!NOTE]
>
> Salvar **não** aplica imediatamente a alteração a uma interface ativa.
> Para aplicá-la, selecione o perfil na lista da interface (isso o
> reativa) ou reinicie o sistema.

Ao ativar, você precisará navegar manualmente até o novo endereço IP que especificou e/ou reconfigurar sua configuração de rede topside.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.