Pular para o conteúdo

Instalação

O instalador oficial prepara um servidor Debian ou Ubuntu para operar como resolvedor DNS recursivo gerenciado pelo WebNett DNS.

Requisitos

ItemMínimoRecomendado
SistemaDebian 12, Debian 13, Ubuntu 22.04 LTS, Ubuntu 24.04 LTSDebian 13
CPU2 vCPU4 vCPU ou mais, dedicadas
Memória2 GB8 GB ou mais
Disco20 GB40 GB SSD
RedeIPv4 fixoIPv4 e IPv6 fixos
Acessoroot (sudo)—

A porta 53 (UDP e TCP) precisa estar livre ou ocupada por um serviço que você pretende substituir. O instalador verifica e não desativa nada sem confirmação.

1. Baixar e verificar

Nunca execute um script com privilégios de root sem verificar a origem. O instalador é publicado junto com uma assinatura Ed25519.

curl -fsSLo webnett-dns-install.sh     https://dns.webnett.top/install.sh
curl -fsSLo webnett-dns-install.sh.sig https://dns.webnett.top/install.sh.sig
curl -fsSLo webnett-release.pub        https://dns.webnett.top/webnett-release.pub

# Confira a impressão digital da chave pública com a publicada na página de instalação
openssl pkey -pubin -in webnett-release.pub -outform DER | sha256sum

# Verifique a assinatura do instalador (OpenSSL 3)
openssl pkeyutl -verify -pubin -inkey webnett-release.pub -rawin \
  -in webnett-dns-install.sh -sigfile webnett-dns-install.sh.sig

A última linha deve exibir Signature Verified Successfully. Qualquer outra saída significa que o arquivo não deve ser executado.

2. Executar

Se o servidor já atende assinantes, comece pelo modo de verificação. Ele detecta o ambiente e mostra exatamente o que seria feito, sem alterar nada:

sudo bash webnett-dns-install.sh --check

Depois, execute a instalação:

sudo bash webnett-dns-install.sh

Um PowerDNS Recursor ou Unbound já em operação é apenas gerenciado: a configuração dele não é alterada pelo instalador.

O que o instalador detecta

  • Distribuição e versão do sistema
  • CPU, número de núcleos, memória e armazenamento
  • Interfaces de rede, endereços IPv4/IPv6 e suporte a IPv6
  • Endereço público observado
  • Versão instalada do Unbound (ou PowerDNS Recursor, se presente)
  • Conflitos nas portas 53, 80 e 443

O que o instalador pergunta

  • E-mail do responsável
  • Usuário e senha do dashboard local (a senha não é exibida e nunca é enviada à WebNett)
  • Nome do provedor e identificação do servidor
  • Interface de rede e endereços de escuta IPv4/IPv6
  • Modo de instalação: IP público ou IP privado
  • Redes de gerência que podem abrir o dashboard (em branco: somente o próprio servidor, via túnel SSH)
  • Código de ativação da licença (WNA-XXXX-XXXX-XXXX-XXXX)

3. O que é instalado

ComponenteFunção
UnboundMotor DNS recursivo com validação DNSSEC
webnett-agent (systemd)Licenciamento, métricas e comunicação com a central
webnett-dashboard (systemd)API local + dashboard HTTPS (porta 8443), sem privilégios
webnett-dns-helper (systemd, ativado por socket)Aplica ACLs e ajustes DNS com backup, teste e reversão. Roda como root só durante a operação e só aceita conexões do usuário webnett
Configuração modularArquivos include gerenciados, sem editar o arquivo principal

Antes de qualquer alteração, as configurações existentes são copiadas para /var/backups/webnett-dns/.

4. Resultado

Ao final, o instalador exibe o endereço do dashboard, o usuário criado, a identificação do servidor, a situação da licença e a impressão digital SHA-256 do certificado do dashboard.

5. Acessar o dashboard

O certificado é autoassinado e gerado no próprio servidor. No primeiro acesso, o navegador alerta: compare a impressão digital exibida pelo navegador com a mostrada pelo instalador antes de continuar. Para usar um certificado próprio, substitua /etc/webnett-dns/tls/dashboard.crt e dashboard.key (dono root:webnett, chave 0640) e reinicie webnett-dashboard.

  • Com redes de gerência: https://IP-DO-SERVIDOR:8443/. O instalador não altera o firewall: se houver um, libere a porta TCP 8443 somente para essas redes.
  • Sem redes de gerência: o dashboard escuta só em 127.0.0.1. Acesse por túnel SSH:
ssh -L 8443:127.0.0.1:8443 root@IP-DO-SERVIDOR
# depois abra https://127.0.0.1:8443/

Esqueceu a senha? No console do servidor, como root:

webnett-dns dashboard-user USUARIO --role admin --owner webnett --file /var/lib/webnett-dns/dashboard-users.json

Por padrão, apenas loopback (127.0.0.0/8, ::1/128) recebe recursão. Habilite as redes dos seus assinantes em ACLs no dashboard.