dns

Documentation

Index

• func LoadRecords() map[string][]DNSRecord
• func ResolveServiceIP(serviceName string) (string, error)
• type DNSRecord
• type Handler
  • func NewHandler(records map[string][]DNSRecord, relayConfig config.RelayConfig) (*Handler, error)
  • func (h *Handler) ServeDNS(w dns.ResponseWriter, r *dns.Msg)
• type RecordType
• type RelayClient
  • func NewRelayClient(config config.RelayConfig) (*RelayClient, error)
  • func (r *RelayClient) Relay(req *dns.Msg) (*dns.Msg, error)
• type RelayError
  • func (e *RelayError) Error() string

Functions

func LoadRecords

func LoadRecords() map[string][]DNSRecord

LoadRecords loads DNS records from environment variables

func ResolveServiceIP

func ResolveServiceIP(serviceName string) (string, error)

ResolveServiceIP attempts to resolve Docker service name to IP

Types

type DNSRecord

type DNSRecord struct {
	Domain     string
	Value      string
	TTL        uint32
	RecordType RecordType
	IsService  bool
	Priority   uint16 // For MX records
}

type Handler

type Handler struct {
	// contains filtered or unexported fields
}

func NewHandler

func NewHandler(records map[string][]DNSRecord, relayConfig config.RelayConfig) (*Handler, error)

func (*Handler) ServeDNS

func (h *Handler) ServeDNS(w dns.ResponseWriter, r *dns.Msg)

type RecordType

type RecordType string

const (
	ARecord     RecordType = "A"
	CNAMERecord RecordType = "CNAME"
	MXRecord    RecordType = "MX"
	TXTRecord   RecordType = "TXT"

	// Record separator
	RecordSeparator = "|"
)

type RelayClient

type RelayClient struct {
	// contains filtered or unexported fields
}

func NewRelayClient

func NewRelayClient(config config.RelayConfig) (*RelayClient, error)

NewRelayClient creates a new RelayClient with the provided configuration. It returns an error if the configuration is invalid.

func (*RelayClient) Relay

func (r *RelayClient) Relay(req *dns.Msg) (*dns.Msg, error)

Relay forwards the DNS request to configured upstream nameservers. It attempts each nameserver in sequence until a successful response is received. Returns the first successful response or an error if all nameservers fail.

type RelayError

type RelayError struct {
	Server string
	Err    error
	Query  string // DNS query that failed
	Rcode  int    // DNS response code if available
}

func (*RelayError) Error

func (e *RelayError) Error() string