基于浏览器的 Windows Server DNS 图形界面——策略、区域、记录、DNSSEC、DNS over HTTPS 和阻止列表。Next.js 前端 + PowerShell 桥接、8 个场景向导,以及面向 AI 代理的 MCP 服务器。可离线作为 PowerShell 命令生成器使用。
一个基于浏览器的 Windows Server DNS 图形界面——涵盖策略、区域、记录、DNSSEC、DNS over HTTPS 和阻止列表。使用 Next.js、TypeScript 和 shadcn/ui 构建,通过内置的 PowerShell 桥接连接到实时 DNS 服务器进行实时管理,也可作为 PowerShell 命令生成器离线使用。包含 8 个场景向导和一个用于 AI 代理集成(Claude Code、Cursor、VS Code)的 MCP 服务器。
netsh SSL 绑定、防火墙规则、Set-DnsServerEncryptionProtocol 以及 DNS 服务重启).nvmrc 均以此版本为目标。Node 20 已于 2026-04-30 停止维护,Node 22 处于维护期直至 2027-04-30,因此 24 是当前的活跃 LTS 版本。使用 nvm 时,在仓库根目录运行 nvm use 即可切换。DnsServer PowerShell 模块的机器127.0.0.1——绝不暴露到网络powershell -ExecutionPolicy Bypass -File Start-DNSPolicyManager.ps1
这会同时启动 PowerShell 桥接(端口 8650)和 Next.js 开发服务器(端口 10010),然后打开浏览器。首次运行时前端依赖会自动安装。
# 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
然后打开 http://localhost:10010。
如果桥接服务未运行,应用会回退到仅生成命令的模式——以可视化方式构建策略,并复制生成的 PowerShell 命令。
MCP 服务器让 AI 代理能够通过 Model Context Protocol 使用 31 个只读工具查询你的 DNS 服务器。它连接到与 Web UI 相同的 PowerShell 桥接服务。
cd mcp-server
npm install
npm run build
或使用启动器:
powershell -ExecutionPolicy Bypass -File Start-DNSPolicyManager.ps1 -MCP
claude mcp add dns-policy-manager -- node /path/to/mcp-server/dist/index.js
使用针对特定服务器的环境变量:
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
所有配置均通过环境变量完成:
| 变量 | 默认值 | 描述 |
|---|---|---|
BRIDGE_URL | http://127.0.0.1:8650 | PowerShell 桥接 URL |
BRIDGE_TOKEN | (从令牌文件读取) | 桥接持有者令牌。仅当 MCP 服务器以与桥接不同的用户或机器运行时才需要 |
BRIDGE_TOKEN_FILE | %LOCALAPPDATA%\DNSPolicyManager\bridge.token | 读取桥接启动时写入的令牌的位置 |
DNS_DEFAULT_SERVER | (无) | 默认 DNS 服务器主机名 |
DNS_SERVER_ID | (无) | 用于凭据查找的服务器 ID |
DNS_CREDENTIAL_MODE | currentUser | 认证模式:currentUser 或 savedCredential |
| 类别 | 工具 |
|---|---|
| 区域 | dns_list_zones、dns_get_zone_details、dns_get_zone_records、dns_get_zone_aging、dns_get_zone_delegations |
| 策略 | dns_list_policies、dns_list_transfer_policies |
| 服务器配置 | dns_get_server_settings、dns_get_forwarders、dns_get_cache_settings、dns_get_recursion_settings、dns_get_blocklist、dns_get_diagnostics、dns_get_statistics、dns_get_rrl、dns_get_rrl_exceptions、dns_get_scavenging、dns_get_root_hints、dns_get_edns、dns_get_encryption、dns_get_global_name_zone、dns_export_server_config |
| DNS 对象 | dns_list_subnets、dns_list_zone_scopes、dns_list_recursion_scopes |
| DNSSEC | dns_get_dnssec_settings、dns_get_signing_keys、dns_get_trust_anchors、dns_get_trust_points |
| 离线 | dns_generate_policy_commands(无需桥接即可工作) |
| 健康检查 | dns_check_health |
MCP 服务器支持两种凭据模式:
currentUser(默认)— 使用已登录用户的 Kerberos/NTLM。无需设置。savedCredential — 使用通过 Web UI 存储的 DPAPI 加密凭据。将 DNS_SERVER_ID 设置为 GUI 中配置的服务器 ID。MCP 服务器有意不支持会话凭据(用户名/密码)— AI 代理不应处理原始密码。
/api/execute 端点(任意 PowerShell)不通过 MCP 暴露dns_generate_policy_commands 工具)均通过一个共享辅助程序(dns-manager/src/lib/ps-escape.ts,在 mcp-server/src/lib/ 中有镜像副本):
`、$、" 以及弯双引号,并将换行符展平。前端运行在标准 Linux 容器中。桥接需要带有 DnsServer 模块的 Windows PowerShell,因此它运行在主机上(或 Windows 容器中)。
这是推荐的 Docker 设置。前端容器将 API 调用代理到运行在 Windows 机器上的桥接。容器通过 Docker 网络访问主机,因此桥接必须监听回环地址之外,并且双方共享一个令牌。
步骤 1 — 选择一个令牌并将其放入 docker-compose.yml 旁边的 .env 文件中:
BRIDGE_TOKEN=<a long random string, e.g. from: openssl rand -base64 32>
步骤 2 — 在主机上使用相同的令牌启动桥接:
$env:DNS_BRIDGE_TOKEN = '<the same string>'
powershell -ExecutionPolicy Bypass -File server/bridge.ps1 -BindAddress 0.0.0.0 -AllowRemote
步骤 3 — 启动前端容器:
docker compose up -d
或手动构建并运行:
docker build -t dns-manager ./dns-manager
docker run -d -p 10010:10010 -e BRIDGE_TOKEN='<the same string>' dns-manager
打开 http://localhost:10010,并在登录页面粘贴令牌(每个浏览器只需一次)。
Compose 仅在 127.0.0.1 上发布该端口。若要为其他机器提供服务:
10010:10010。ALLOWED_HOSTS 中列出主机名。代理会拒绝未知的 Host 头,以免 DNS 重绑定页面操控它。默认情况下,前端的 /api 代理会转发到 http://host.docker.internal:8650(Docker Desktop 的主机网关)。BRIDGE_URL 在运行时读取,因此你可以指向不同的桥接地址而无需重新构建:
docker run -d -p 10010:10010 -e BRIDGE_URL=http://192.168.1.50:8650 -e BRIDGE_TOKEN='<token>' dns-manager
如果桥接运行在另一台机器上,请将其绑定到网络接口。除非传入 -AllowRemote,否则桥接会拒绝这样做:
powershell -ExecutionPolicy Bypass -File server/bridge.ps1 -BindAddress 0.0.0.0 -AllowRemote
安全提示:在网络接口上,在 Server 选项卡中输入的凭据以及每一次 DNS 变更都会经过网络传输。纯 HTTP 会以未加密的方式发送它们。请使用
-UseHttps(先用netsh http add sslcert ipport=0.0.0.0:8650 certhash=<thumbprint> appid={<any GUID>}将证书绑定到端口),或使用终止 TLS 的反向代理,或在任何非可信、非隔离的网络上使用 SSH 隧道。令牌可以阻止其他客户端使用桥接,但它不会加密流量。
除 /api/health 外,每个桥接端点都要求 Authorization: Bearer <token>:
-Token 获取令牌,否则从 DNS_BRIDGE_TOKEN 获取,否则从上次启动时生成的令牌文件获取,否则生成一个新的随机令牌。-RotateToken 会强制生成新令牌,这也会让所有浏览器退出登录。%LOCALAPPDATA%\DNSPolicyManager\bridge.token,该文件仅你的账户、SYSTEM 和 Administrators 可读。/api 代理和 MCP 服务器会自动读取该文件。当它们以其他用户身份或在其他机器上运行时,请设置 BRIDGE_TOKEN。浏览器永远不会看到令牌:它只与前端自身的源通信。
要使用代理,浏览器需要登录一次:
Start-DNSPolicyManager.ps1 会自动让浏览器登录。它会将一个一次性代码(有效期 5 分钟)写入仅用户可读的文件,并打开 /auth?code=...,因此令牌本身永远不会出现在 URL 或浏览器历史记录中。/login 页面粘贴令牌。登录会设置一个由令牌派生的 HttpOnly、SameSite=Strict 会话 cookie。正是该 cookie 对 /api/* 的调用进行认证。Host、Origin 和 fetch-metadata 检查只是加固代理以抵御跨站浏览器攻击。开发和生产前端仅监听 127.0.0.1。
docker compose up -d # Start frontend (bridge on host)
docker compose down # Stop
docker compose up -d --build # Rebuild after code changes
docker compose logs -f frontend # View logs