Gerenciador de Políticas DNS do Windows
Página Inicial do Projeto
Uma GUI baseada em navegador para DNS do Windows Server — políticas, zonas, registros, DNSSEC, DNS sobre HTTPS e listas de bloqueio. Construída com Next.js, TypeScript e shadcn/ui, conecta-se a um servidor DNS ativo através da ponte PowerShell incluída para gerenciamento em tempo real, e funciona offline como um gerador de comandos PowerShell. Inclui 8 assistentes de cenário e um servidor MCP para integração com agentes de IA (Claude Code, Cursor, VS Code).
Recursos
- Interface com 12 abas: Servidor, Objetos, Zonas, Políticas, Criar, Listas de Bloqueio, Assistentes, DNSSEC, DNS sobre HTTPS, Resolvedores, Backup, PowerShell
- Gerenciamento multi-servidor com credenciais Kerberos, salvas via DPAPI ou baseadas em sessão, e alternador de servidor no cabeçalho para troca rápida a partir de qualquer aba
- Painel de configuração do servidor com edição inline para 13 painéis de configuração (configurações, encaminhadores, recursão, cache, lista de bloqueio, diagnósticos, estatísticas, RRL, scavenging, root hints, EDNS, configurações de AD, zona de nome global)
- Analisador de Boas Práticas de DNS — execute o BPA do Windows a partir da interface com descobertas codificadas por severidade
- Navegador de zonas com layout de dois painéis, editor de configurações, CRUD completo de registros, importação/exportação CSV, paginação e filtros para Direta/Reversa, tipo de zona (Primária/Secundária/Stub/Encaminhador) e integrada ao AD
- 8 assistentes de cenário com execução tipada (geolocalização, split-brain, hora do dia, balanceamento de carga, filtros de consulta, lista de bloqueio, combinação geo+LB, primário-secundário)
- Aba Listas de Bloqueio — Bloqueio Rápido (domínio único), Importação em Massa (.txt), tabela de Políticas de Bloqueio Ativas e gerenciamento da Lista de Bloqueio de Consultas Global
- Aba Resolvedores — DNS da pilha IP por adaptador (IPv4/IPv6), configuração de encaminhadores, diagrama de topologia Mermaid com arestas codificadas por cores
- Gerenciamento de DNSSEC — assinatura de zonas, CRUD de chaves de assinatura, âncoras de confiança, pontos de confiança
- DNS sobre HTTPS (DoH) — aba dedicada para habilitar/desabilitar DoH de entrada e gerenciar até 3 modelos de URI ao vivo no Windows Server 2025+ (KB5094125), além de um gerador offline para o script completo de configuração de pré-requisitos (importação de certificado, vinculação SSL via
netsh, regra de firewall, Set-DnsServerEncryptionProtocol e reinício do serviço DNS)
- CRUD de políticas com alternância de habilitar/desabilitar, editor de ordem de processamento e cópia entre servidores
- Gerenciamento de objetos DNS para sub-redes de clientes, escopos de zona e escopos de recursão
- Ciclo de vida de zonas — criar, excluir, converter, suspender, retomar, exportar zonas
- Geração de comandos PowerShell com cópia para a área de transferência — funciona offline como um gerador de comandos
- Backup e exportação — backup/restauração de políticas em JSON, exportação de configuração do servidor (Get-DnsServer como JSON), exportação de zona DNS (única ou todas as zonas primárias via Export-DnsServerZone), informações de backup integradas ao AD
- Utilitário de Consulta DNS — painel deslizante com consultas nslookup e dig ao vivo a partir de qualquer aba. Opções específicas da ferramenta (+trace, +dnssec, +short, +all, +multiline, debug), direcionamento para nameserver personalizado ou registrado, e saída de sessão estilo console com copiar/limpar
- Ajuda sensível ao contexto com painel deslizante e janela popout de página inteira
- 21 testes E2E Playwright com ponte simulada, integrados ao CI
- Servidor MCP — 31 ferramentas somente leitura para agentes de IA via Model Context Protocol (zonas, registros, políticas, configuração do servidor, DNSSEC, RRL, scavenging e mais), além de geração offline de comandos PowerShell
- Pronto para Docker com imagem Alpine multi-stage (221 MB)
- Navegação por abas acessível por teclado e atributos ARIA
Executando Localmente
Requisitos
- Node.js 24 LTS ("Krypton") — a versão alvo do CI, Docker e
.nvmrc. O Node 20 atingiu
o fim de vida em 2026-04-30 e o Node 22 está em manutenção até 2027-04-30, portanto o 24 é o
LTS Ativo atual. Com nvm, execute nvm use na raiz do repositório para selecioná-lo.
- Windows Server com a função DNS Server, ou uma máquina com o módulo PowerShell
DnsServer
- A ponte escuta apenas em
127.0.0.1 por padrão — nunca exposta à rede
powershell -ExecutionPolicy Bypass -File Start-DNSPolicyManager.ps1
Isso inicia tanto a ponte PowerShell (porta 8650) quanto o servidor de desenvolvimento Next.js (porta 10010) e, em seguida, abre o navegador. As dependências do frontend são instaladas automaticamente na primeira execução.
Inicialização manual
# Terminal 1: Start the bridge
powershell -ExecutionPolicy Bypass -File server/bridge.ps1
# Terminal 2: Start the frontend
cd dns-manager
npm install # first time only
npm run dev
Em seguida, abra http://localhost:10010.
Modo offline
Se a bridge não estiver em execução, o aplicativo recorre apenas à geração de comandos — crie políticas visualmente e copie os comandos PowerShell gerados.
O servidor MCP permite que agentes de IA consultem seus servidores DNS por meio de 31 ferramentas somente leitura via Model Context Protocol. Ele se conecta à mesma bridge PowerShell usada pela interface web.
Configuração
cd mcp-server
npm install
npm run build
Ou use o launcher:
powershell -ExecutionPolicy Bypass -File Start-DNSPolicyManager.ps1 -MCP
claude mcp add dns-policy-manager -- node /path/to/mcp-server/dist/index.js
Com variáveis de ambiente para um servidor específico:
claude mcp add dns-policy-manager \
-e BRIDGE_URL=http://127.0.0.1:8650 \
-e DNS_DEFAULT_SERVER=dc01.contoso.com \
-e DNS_CREDENTIAL_MODE=currentUser \
-- node /path/to/mcp-server/dist/index.js
Configuração
Toda a configuração é feita por variáveis de ambiente:
| Variável | Padrão | Descrição |
|---|
BRIDGE_URL | http://127.0.0.1:8650 | URL da bridge do PowerShell |
BRIDGE_TOKEN | (lido do arquivo de token) | Token bearer da bridge. Necessário apenas quando o servidor MCP é executado como um usuário ou máquina diferente da bridge |
BRIDGE_TOKEN_FILE | %LOCALAPPDATA%\DNSPolicyManager\bridge.token | Onde ler o token que a bridge grava ao iniciar |
DNS_DEFAULT_SERVER | (nenhum) | Nome de host do servidor DNS padrão |
DNS_SERVER_ID | (nenhum) | ID do servidor para busca de credenciais |
DNS_CREDENTIAL_MODE | currentUser | Modo de autenticação: currentUser ou savedCredential |
Ferramentas Disponíveis (31)