Windows Server DNS를 위한 브라우저 기반 GUI — 정책, 영역, 레코드, DNSSEC, DNS over HTTPS, 차단 목록을 지원합니다. Next.js 프런트엔드 + PowerShell 브리지, 8개의 시나리오 마법사, AI 에이전트용 MCP 서버를 제공합니다. PowerShell 명령 생성기로 오프라인에서도 작동합니다.
Windows Server DNS를 위한 브라우저 기반 GUI — 정책, 영역, 레코드, 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가 현재
Active 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 서버를 쿼리할 수 있습니다. 웹 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 — 웹 UI를 통해 저장된 DPAPI 암호화 자격 증명을 사용합니다. GUI에서 구성한 서버 ID로 DNS_SERVER_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 설정입니다. 프론트엔드 컨테이너는 Windows 머신에서 실행 중인 브리지로 API 호출을 프록시합니다. 컨테이너는 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