Struct DnsConfig 

pub struct DnsConfig {
    pub zone: String,
    pub port: u16,
    pub bind_addr: IpAddr,
    pub upstreams: Option<Vec<SocketAddr>>,
}

Configuration for DNS integration with overlay network

Fields

zone: String

DNS zone (e.g., “overlay.local.”)

port: u16

DNS server port (default: 15353)

bind_addr: IpAddr

Bind address (default: overlay IP)

upstreams: Option<Vec<SocketAddr>>

Explicit upstream resolvers for non-overlay queries.

When Some, this list wins outright over any host-resolver detection: the overlay DNS server forwards every query outside Self::zone to these addresses (in order) and never consults /etc/resolv.conf. This is the production-safe override for hosts where a mesh VPN (netbird, Tailscale, …) has hijacked systemd-resolved with a ~. catch-all and poisoned the host resolver for everything else.

When None (the default), the server detects upstreams at startup by parsing /etc/resolv.conf and filtering out loopback / resolved-stub addresses; see [resolve_upstreams] for the exact precedence and the public fallback.

Each entry is a full SocketAddr so a non-standard upstream port can be expressed; detection synthesises port [STANDARD_DNS_PORT] (53).

Implementations

impl DnsConfig

pub fn new(zone: &str, bind_addr: IpAddr) -> Self

Create a new DNS config with defaults

pub fn with_port(self, port: u16) -> Self

Set a custom port

pub fn with_upstreams(self, upstreams: Vec<SocketAddr>) -> Self

Set explicit upstream resolvers for non-overlay queries.

Supplying this disables host-resolver auto-detection entirely (the config override always wins). Pass full SocketAddrs; for the common case of “this IP on port 53” build them as SocketAddr::new(ip, 53).

Trait Implementations

impl Clone for DnsConfig

fn clone(&self) -> DnsConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DnsConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DnsConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DnsConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.