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)

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]

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
rebootde janela de manutenção (ounetplan applysem 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 |