Windows DNS Policy Manager
Pagina principale del progetto
Una GUI basata su browser per Windows Server DNS — policy, zone, record, DNSSEC, DNS over HTTPS e blocklist. Realizzata con Next.js, TypeScript e shadcn/ui, si connette a un server DNS attivo tramite il bridge PowerShell incluso per la gestione in tempo reale, e funziona offline come generatore di comandi PowerShell. Include 8 procedure guidate per scenari e un server MCP per l'integrazione con agenti AI (Claude Code, Cursor, VS Code).
Funzionalità
- Interfaccia a 12 schede: Server, Oggetti, Zone, Policy, Crea, Blocklist, Procedure guidate, DNSSEC, DNS over HTTPS, Resolver, Backup, PowerShell
- Gestione multi-server con credenziali Kerberos, salvate tramite DPAPI o basate su sessione e selettore server nell'header per passare rapidamente da qualsiasi scheda
- Dashboard di configurazione del server con modifica inline per 13 pannelli di configurazione (impostazioni, forwarder, ricorsione, cache, blocklist, diagnostica, statistiche, RRL, scavenging, root hints, EDNS, impostazioni AD, zona nomi globale)
- DNS Best Practices Analyzer — esegui il BPA di Windows dall'interfaccia con risultati codificati per gravità
- Browser delle zone con layout a due pannelli, editor delle impostazioni, CRUD completo dei record, import/export CSV, paginazione e filtri per Forward/Reverse, tipo di zona (Primary/Secondary/Stub/Forwarder) e integrata in AD
- 8 procedure guidate per scenari con esecuzione tipizzata (geolocalizzazione, split-brain, fascia oraria, bilanciamento del carico, filtri di query, blocklist, combinazione geo+LB, primario-secondario)
- Scheda Blocklist — Blocco rapido (singolo dominio), Importazione massiva (.txt), tabella delle policy di blocco attive e gestione della Global Query Block List
- Scheda Resolver — DNS dello stack IP per adattatore (IPv4/IPv6), configurazione dei forwarder, diagramma topologico Mermaid con archi codificati a colori
- Gestione DNSSEC — firma delle zone, CRUD delle chiavi di firma, trust anchor, trust point
- DNS over HTTPS (DoH) — scheda dedicata per abilitare/disabilitare il DoH in ingresso e gestire fino a 3 modelli di URI in tempo reale su Windows Server 2025+ (KB5094125), oltre a un generatore offline per lo script completo di configurazione dei prerequisiti (importazione del certificato, binding SSL con
netsh, regola del firewall, Set-DnsServerEncryptionProtocol e riavvio del servizio DNS)
- CRUD delle policy con attivazione/disattivazione, editor dell'ordine di elaborazione e copia tra server
- Gestione degli oggetti DNS per subnet client, ambiti di zona e ambiti di ricorsione
- Ciclo di vita delle zone — creazione, eliminazione, conversione, sospensione, ripresa, esportazione delle zone
- Generazione di comandi PowerShell con copia negli appunti — funziona offline come generatore di comandi
- Backup ed esportazione — backup/ripristino delle policy in JSON, esportazione della configurazione del server (Get-DnsServer come JSON), esportazione delle zone DNS (singola o tutte le zone primarie tramite Export-DnsServerZone), informazioni di backup per le zone integrate in AD
- Utility DNS Lookup — pannello a scomparsa con query nslookup e dig in tempo reale da qualsiasi scheda. Opzioni specifiche dello strumento (+trace, +dnssec, +short, +all, +multiline, debug), targeting di nameserver personalizzati o registrati e output di sessione in stile console con copia/cancella
- Guida contestuale con pannello a scomparsa e finestra a pagina intera
- 21 test E2E Playwright con bridge mock, integrati nella CI
- Server MCP — 31 strumenti in sola lettura per agenti AI tramite Model Context Protocol (zone, record, policy, configurazione del server, DNSSEC, RRL, scavenging e altro), oltre alla generazione offline di comandi PowerShell
- Pronto per Docker con immagine Alpine multi-stage (221 MB)
- Navigazione tra le schede accessibile da tastiera e attributi ARIA
Esecuzione locale
Requisiti
- Node.js 24 LTS ("Krypton") — la versione a cui puntano CI, Docker e
.nvmrc. Node 20 ha raggiunto
l'end-of-life il 2026-04-30 e Node 22 è in manutenzione fino al 2027-04-30, quindi 24 è l'attuale
Active LTS. Con nvm, esegui nvm use nella radice del repository per selezionarla.
- Windows Server con il ruolo DNS Server, oppure una macchina con il modulo PowerShell
DnsServer
- Il bridge si associa solo a
127.0.0.1 per impostazione predefinita — mai esposto alla rete
Avvio con un solo comando
powershell -ExecutionPolicy Bypass -File Start-DNSPolicyManager.ps1
Questo avvia sia il bridge PowerShell (porta 8650) sia il server di sviluppo Next.js (porta 10010), quindi apre il browser. Le dipendenze del frontend vengono installate automaticamente al primo avvio.
Avvio manuale
# 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
Poi apri http://localhost:10010.
Modalità offline
Se il bridge non è in esecuzione, l'app passa alla sola generazione di comandi — crea le policy visivamente e copia i comandi PowerShell generati.
Server MCP (integrazione con agenti AI)
Il server MCP consente agli agenti AI di interrogare i tuoi server DNS tramite 31 strumenti di sola lettura attraverso il Model Context Protocol. Si connette allo stesso bridge PowerShell utilizzato dall'interfaccia web.
Configurazione
cd mcp-server
npm install
npm run build
Oppure usa il launcher:
powershell -ExecutionPolicy Bypass -File Start-DNSPolicyManager.ps1 -MCP
Registrazione con Claude Code
claude mcp add dns-policy-manager -- node /path/to/mcp-server/dist/index.js
Con variabili d'ambiente per un server specifico:
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
Configurazione
Tutta la configurazione avviene tramite variabili d'ambiente:
| Variabile | Predefinito | Descrizione |
|---|
BRIDGE_URL | http://127.0.0.1:8650 | URL del bridge PowerShell |
BRIDGE_TOKEN | (letto dal file del token) | Token bearer del bridge. Necessario solo quando il server MCP viene eseguito con un utente o su una macchina diversa rispetto al bridge |
BRIDGE_TOKEN_FILE | %LOCALAPPDATA%\DNSPolicyManager\bridge.token | Da dove leggere il token che il bridge scrive all'avvio |
DNS_DEFAULT_SERVER | (nessuno) | Nome host del server DNS predefinito |
DNS_SERVER_ID | (nessuno) | ID del server per la ricerca delle credenziali |
DNS_CREDENTIAL_MODE | currentUser | Modalità di autenticazione: currentUser o savedCredential |
Strumenti disponibili (31)