server

package

v0.33.0 Latest Latest Go to latest Published: Jun 30, 2026 License: Apache-2.0 Imports: 39 Imported by: 1

Details

Rendered for

This section is empty.

This section is empty.

This section is empty.

type NewServerFunc func(address string) (*dns.Server, error)

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

Server controls the endpoints for DNS and HTTP

func NewServer(ctx context.Context, cfg *config.Config) (server *Server, err error)

NewServer creates new server instance with passed config

func (s *Server) OnHealthCheck(ctx context.Context, w dns.ResponseWriter, request *dns.Msg)

OnHealthCheck Handler for docker health check. Just returns OK code without delegating to resolver chain

func (s *Server) OnRequest(ctx context.Context, w dns.ResponseWriter, msg *dns.Msg)

OnRequest will be executed if a new DNS request is received

func (s *Server) Query(
	ctx context.Context, serverHost string, clientIP net.IP, question string, qType dns.Type,
) (*model.Response, error)

func (s *Server) Start(ctx context.Context, errCh chan<- error)

Start starts the server

func (s *Server) Stop(ctx context.Context) error

Stop stops the server

Path	Synopsis
freebind Package freebind provides a net.ListenConfig.Control hook that sets the Linux IP_FREEBIND (and IPV6_FREEBIND) socket option, allowing listeners to bind to IP addresses that are not yet assigned to a network interface.	Package freebind provides a net.ListenConfig.Control hook that sets the Linux IP_FREEBIND (and IPV6_FREEBIND) socket option, allowing listeners to bind to IP addresses that are not yet assigned to a network interface.