Skip to content

DNS Service

Local DNS resolution, upstream forwarding, and record management.

Related: DHCP Config | NFS Service


Local DNS

PxeLab has a built-in DNS server supporting:

  • Upstream forwarding — Forward unmatched queries to upstream DNS
  • Local resolution — A / AAAA / CNAME records
  • Subnet-aware — Return server IP based on client source subnet
  • Auto-records — Auto-create @ A record and server name A record on startup
ConfigDefaultDescription
Port53UDP
Local domainpxelab.localSuffix domain
Upstream DNSSystem defaultForward target

Web UI: Service Config → DNS


DNS Record Management

Manage DNS records via Web UI or API:

GET    /api/v1/dns/records          # List all records
POST   /api/v1/dns/records          # Create record
GET    /api/v1/dns/records/{id}     # Get single record
PUT    /api/v1/dns/records/{id}     # Update record
DELETE /api/v1/dns/records/{id}     # Delete record

Supported record types: A, AAAA, CNAME

PxeLab - All-in-one PXE Network Boot Server