DNS Server Documentation

A high-performance C++20 DNS server with caching and upstream forwarding.

Table of Contents

• Architecture
• Configuration
• Deployment
• API Reference

Quick Start

Local Development

# Build
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel

# Run on unprivileged port
./build/dns_server -p 5353

# Test
dig @127.0.0.1 -p 5353 google.com

Docker Deployment

# Build and run locally
docker compose up -d

# Deploy to remote server
docker compose -H ssh://[email protected] up -d

Features

• RFC 1035 compliant DNS protocol
• Thread-safe LRU cache with TTL expiration
• Parallel upstream query support (Cloudflare 1.1.1.1, Google 8.8.8.8)
• Dual-stack IPv4/IPv6 support
• Graceful shutdown with statistics reporting