Ir para o conteúdo

Roteiro: Alterar rede do host (IP, rota, VLAN, DNS)

Perfil necessário: admin Menus usados: Segurança e Rede Risco: alto — mexer em IP/rota do host pode derrubar o próprio acesso ao painel e o tráfego SIP/RTP; persistência errada perde a configuração no reboot Rollback: desfazer na própria página (remover IP/rota/VLAN, restaurar DNS); alterações persistentes ficam no netplan gerenciado (/etc/netplan) — reverter lá e aplicar de novo; acesso de console/out-of-band como rede de segurança

Pré-requisitos

  • [ ] Acesso de console/out-of-band ao host disponível (mudança de IP/rota pode cortar o acesso do painel)
  • [ ] Interface destino conhecida (confira na aba Interfaces antes)
  • [ ] Sabe que adicionar/remover IP sincroniza automaticamente OpenSIPS (bloco AUTO LISTEN do cfg + restart do serviço) e RTPEngine (interfaces + restart)

Passo a passo

1. Abrir a página e inspecionar o estado atual

Caminho: Segurança e Rede → Rede (aba Interfaces)

Página Rede com o botão Atualizar destacado

A tabela mostra Interface, Tipo, MAC, Estado (UP/down), MTU e os Endereços IP de cada interface. Clique: [Atualizar] para reconsultar o host antes de qualquer mudança.

2. Adicionar endereço IP

Caminho: aba Endereços IP Clique: [Adicionar IP]

Dialog Adicionar endereço IP

Preencha:

Campo Obrig. Formato/exemplo Efeito
Interface * sim seletor com as interfaces do host interface que recebe o IP
Endereço (IP/CIDR) * sim 10.0.0.5/24 ou 2001:db8::1/64 endereço adicionado à interface
Alias RTPEngine (opcional) não public, brt23, edge_sp alias de interface do RTPEngine; vazio = alias gerado automaticamente
Persistir após reboot toggle (default ligado) on/off ligado = grava no netplan gerenciado e aplica; desligado = IP virtual apenas em runtime

Clique: [Adicionar] (rótulo do botão de salvar do dialog).

Resultado esperado: toast "Endereço adicionado"; o IP aparece na aba Interfaces/Endereços IP. Atenção aos avisos: se o netplan não estiver disponível, o backend aplica só em runtime e o toast avisa que o endereço não sobrevive ao reboot. Em caso de sucesso, o backend também: sincroniza o bloco AUTO LISTEN do opensips.cfg e reinicia o opensips.service, sincroniza as interfaces do rtpengine.conf e reinicia o rtpengine-daemon.service. Remoção usa o ícone de lixeira da linha com confirmação — remover o IP de gestão é lockout imediato.

3. Adicionar rota estática

Caminho: aba Rotas Clique: [Adicionar rota]

Campo Obrig. Formato/exemplo Efeito
Destino * sim 192.168.1.0/24 ou default prefixo da rota
Gateway * sim 10.0.0.1 próximo salto
Interface não seletor (limpável) restringe a rota à interface
Métrica não inteiro ≥ 0 preferência entre rotas para o mesmo destino

Clique: [Adicionar].

Resultado esperado: rota listada com Destino, Gateway, Interface, Alias, Métrica, IP (família), Proto, Escopo; a rota default aparece destacada. Remoção pelo ícone de lixeira com confirmação.

4. Criar VLAN (opcional)

Caminho: aba VLANs Clique: [Criar VLAN]

Campo Obrig. Formato/exemplo Efeito
Interface pai * sim seletor (somente físicas, sem .) base da subinterface
VLAN ID (1-4094) * sim 100 cria a interface <pai>.<id>
Endereços IP (opcional) não lista de CIDR (ex.: 10.0.0.1/24) endereços já atribuídos à VLAN

Clique: [Criar].

Resultado esperado: VLAN listada com Interface Pai, VLAN ID, Interface VLAN e Endereços. Remoção pelo ícone de lixeira com confirmação (remove a subinterface).

5. Salvar DNS

Caminho: aba DNS Clique: [Salvar DNS]

Campo Obrig. Formato/exemplo Efeito
Servidores DNS (nameservers) sim (≥1) 8.8.8.8, 1.1.1.1 resolvers do host
Domínios de busca (search) não example.com sufixos de busca do resolvedor
  • Use [Adicionar servidor] / [Adicionar domínio] para novas linhas e o botão − para remover.

Resultado esperado: toast "DNS atualizado". Sem pelo menos um nameserver válido o botão recusa com aviso.

Validação

  • [ ] Visual: aba Interfaces mostra o IP novo (após [Atualizar])
  • [ ] Funcional: OpenSIPS e rtpengine reiniciados sem erro (journalctl -u opensips -f, journalctl -u rtpengine-daemon -f); OPTIONS/REGISTER respondendo no IP novo; ip route/resolução DNS conferem com a UI
  • [ ] Persistência: após reboot de janela de manutenção (ou netplan apply sem erro), a configuração continua lá

Erros comuns

Sintoma Causa provável Correção
Perdeu acesso ao painel após mexer no IP IP de gestão removido/alterado console/out-of-band; readicionar o IP e sincronizar
Toast "Endereço aplicado apenas em runtime" netplan indisponível ou toggle de persistência desligado aceitar temporário ou habilitar netplan no host
OpenSIPS não escuta no IP novo sync do bloco AUTO LISTEN falhou (warning no toast) conferir opensips.cfg/restart manual; nunca copiar cfg do repo por cima do AUTO LISTEN
RTPEngine não usa o IP/alias sync do rtpengine.conf falhou (warning no toast) conferir seção [rtpengine] e reiniciar o serviço
Rota nova não é usada gateway inalcançável ou métrica maior que a rota existente corrigir gateway/métrica e recriar
DNS não resolve nameserver inválido/inacessível trocar por resolver válido e [Salvar DNS]

Tabela de referência rápida

Aba Botão principal Aplica Persiste
Interfaces [Atualizar] — (somente leitura) —
Endereços IP [Adicionar IP] ip/netplan + sync OpenSIPS/RTPEngine + restart dos serviços netplan gerenciado
Rotas [Adicionar rota] tabela de rotas do host conforme backend
VLANs [Criar VLAN] subinterface <pai>.<id> conforme backend
DNS [Salvar DNS] resolvers do host conforme backend