Windows DNS Policy Manager
Página principal del proyecto
Una GUI basada en navegador para DNS de Windows Server — políticas, zonas, registros, DNSSEC, DNS sobre HTTPS y listas de bloqueo. Construida con Next.js, TypeScript y shadcn/ui, se conecta a un servidor DNS en vivo a través del puente PowerShell incluido para la gestión en tiempo real, y funciona sin conexión como generador de comandos de PowerShell. Incluye 8 asistentes de escenarios y un servidor MCP para la integración con agentes de IA (Claude Code, Cursor, VS Code).
Características
- Interfaz de 12 pestañas: Servidor, Objetos, Zonas, Políticas, Crear, Listas de bloqueo, Asistentes, DNSSEC, DNS sobre HTTPS, Resolutores, Copia de seguridad, PowerShell
- Gestión multiservidor con credenciales Kerberos, guardadas con DPAPI o basadas en sesión, y un selector de servidor en el encabezado para cambiar rápidamente desde cualquier pestaña
- Panel de configuración del servidor con edición en línea para 13 paneles de configuración (ajustes, reenviadores, recursión, caché, lista de bloqueo, diagnósticos, estadísticas, RRL, depuración, sugerencias de raíz, EDNS, ajustes de AD, zona de nombres global)
- Analizador de mejores prácticas de DNS — ejecuta el BPA de Windows desde la interfaz con hallazgos codificados por gravedad
- Explorador de zonas con diseño de dos paneles, editor de ajustes, CRUD completo de registros, importación/exportación CSV, paginación y filtros para Directa/Inversa, tipo de zona (Primaria/Secundaria/Stub/Reenviador) e integrada en AD
- 8 asistentes de escenarios con ejecución tipada (geolocalización, split-brain, hora del día, balanceo de carga, filtros de consulta, lista de bloqueo, combinación geo+LB, primaria-secundaria)
- Pestaña Listas de bloqueo — Bloqueo rápido (dominio único), Importación masiva (.txt), tabla de políticas de bloqueo activas y gestión de la lista de bloqueo de consultas global
- Pestaña Resolutores — DNS de la pila IP por adaptador (IPv4/IPv6), configuración de reenviadores, diagrama de topología Mermaid con aristas codificadas por colores
- Gestión de DNSSEC — firma de zonas, CRUD de claves de firma, anclas de confianza, puntos de confianza
- DNS sobre HTTPS (DoH) — pestaña dedicada para habilitar/deshabilitar DoH entrante y gestionar hasta 3 plantillas de URI en vivo en Windows Server 2025+ (KB5094125), además de un generador sin conexión para el script completo de configuración de requisitos previos (importación de certificado, enlace SSL con
netsh, regla de firewall, Set-DnsServerEncryptionProtocol y reinicio del servicio DNS)
- CRUD de políticas con alternancia de habilitar/deshabilitar, editor de orden de procesamiento y copia entre servidores
- Gestión de objetos DNS para subredes de cliente, ámbitos de zona y ámbitos de recursión
- Ciclo de vida de zonas — crear, eliminar, convertir, suspender, reanudar, exportar zonas
- Generación de comandos de PowerShell con copia al portapapeles — funciona sin conexión como generador de comandos
- Copia de seguridad y exportación — copia/restauración de políticas en JSON, exportación de configuración del servidor (Get-DnsServer como JSON), exportación de zonas DNS (zona primaria única o todas mediante Export-DnsServerZone), información de copia de seguridad integrada en AD
- Utilidad de búsqueda DNS — panel deslizante con consultas nslookup y dig en vivo desde cualquier pestaña. Opciones específicas de la herramienta (+trace, +dnssec, +short, +all, +multiline, debug), selección de servidor de nombres personalizado o registrado, y salida de sesión estilo consola con copiar/limpiar
- Ayuda contextual con panel deslizante y ventana emergente a página completa
- 21 pruebas E2E de Playwright con puente simulado, integradas en CI
- Servidor MCP — 31 herramientas de solo lectura para agentes de IA mediante Model Context Protocol (zonas, registros, políticas, configuración del servidor, DNSSEC, RRL, depuración y más), además de generación de comandos de PowerShell sin conexión
- Listo para Docker con imagen Alpine multi-etapa (221 MB)
- Navegación por pestañas accesible mediante teclado y atributos ARIA
Ejecución local
Requisitos
- Node.js 24 LTS ("Krypton") — la versión a la que apuntan CI, Docker y
.nvmrc. Node 20 alcanzó
el fin de su vida útil el 2026-04-30 y Node 22 está en mantenimiento hasta el 2027-04-30, por lo que 24 es el
LTS activo actual. Con nvm, ejecuta nvm use en la raíz del repositorio para seleccionarlo.
- Windows Server con el rol de servidor DNS, o una máquina con el módulo de PowerShell
DnsServer
- El puente se enlaza solo a
127.0.0.1 de forma predeterminada — nunca se expone a la red
Inicio con un solo comando
powershell -ExecutionPolicy Bypass -File Start-DNSPolicyManager.ps1
Esto inicia tanto el puente de PowerShell (puerto 8650) como el servidor de desarrollo de Next.js (puerto 10010), y luego abre tu navegador. Las dependencias del frontend se instalan automáticamente en la primera ejecución.
Inicio 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
Luego abra http://localhost:10010.
Modo sin conexión
Si el puente no está en ejecución, la aplicación recurre únicamente a la generación de comandos: cree políticas visualmente y copie los comandos de PowerShell generados.
Servidor MCP (integración con agentes de IA)
El servidor MCP permite a los agentes de IA consultar sus servidores DNS a través de 31 herramientas de solo lectura mediante el Model Context Protocol. Se conecta al mismo puente de PowerShell que utiliza la interfaz web.
Configuración
cd mcp-server
npm install
npm run build
O usa el lanzador:
powershell -ExecutionPolicy Bypass -File Start-DNSPolicyManager.ps1 -MCP
Registro con Claude Code
claude mcp add dns-policy-manager -- node /path/to/mcp-server/dist/index.js
Con variables de entorno para un 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
Configuración
Toda la configuración se realiza mediante variables de entorno:
| Variable | Valor predeterminado | Descripción |
|---|
BRIDGE_URL | http://127.0.0.1:8650 | URL del puente de PowerShell |
BRIDGE_TOKEN | (se lee del archivo de token) | Token de portador del puente. Solo es necesario cuando el servidor MCP se ejecuta como un usuario o en una máquina diferente a la del puente |
BRIDGE_TOKEN_FILE | %LOCALAPPDATA%\DNSPolicyManager\bridge.token | Dónde leer el token que el puente escribe al iniciar |
DNS_DEFAULT_SERVER | (ninguno) | Nombre de host del servidor DNS predeterminado |
DNS_SERVER_ID | (ninguno) | ID del servidor para la búsqueda de credenciales |
DNS_CREDENTIAL_MODE | currentUser | Modo de autenticación: currentUser o savedCredential |
Herramientas disponibles (31)