Instalação
O instalador oficial prepara um servidor Debian ou Ubuntu para operar como resolvedor DNS recursivo gerenciado pelo WebNett DNS.
Requisitos
| Item | Mínimo | Recomendado |
|---|---|---|
| Sistema | Debian 12, Debian 13, Ubuntu 22.04 LTS, Ubuntu 24.04 LTS | Debian 13 |
| CPU | 2 vCPU | 4 vCPU ou mais, dedicadas |
| Memória | 2 GB | 8 GB ou mais |
| Disco | 20 GB | 40 GB SSD |
| Rede | IPv4 fixo | IPv4 e IPv6 fixos |
| Acesso | root (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
| Componente | Função |
|---|---|
| Unbound | Motor 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 modular | Arquivos 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.