server

Documentation

Index

• Variables
• type Server
  • func NewServer(opts ServerOpts) *Server
  • func (s *Server) Close()
  • func (s *Server) Closed() bool
  • func (s *Server) CreateETLSListner(l net.Listener, nextProtos []string) (net.Listener, error)
  • func (s *Server) CreateQUICListner(conn net.PacketConn, nextProtos []string) (*quic.EarlyListener, error)
  • func (s *Server) ServeH3(l *quic.EarlyListener) error
  • func (s *Server) ServeHTTP(l net.Listener) error
  • func (s *Server) ServeQUIC(l *quic.EarlyListener) error
  • func (s *Server) ServeTCP(l net.Listener) error
  • func (s *Server) ServeUDP(c net.PacketConn) error
• type ServerOpts

Variables

var (
	ErrServerClosed = errors.New("server closed")
)

Types

type Server

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

Server is a DNS server. It's functions, Server.ServeUDP etc., will block and close the net.Listener/net.PacketConn and always return a non-nil error. If Server was closed, the returned err will be ErrServerClosed.

func NewServer

func NewServer(opts ServerOpts) *Server

func (*Server) Close

func (s *Server) Close()

Close closes the Server and all its inner listeners.

func (*Server) Closed

func (s *Server) Closed() bool

Closed returns true if server was closed.

func (*Server) CreateETLSListner

func (s *Server) CreateETLSListner(l net.Listener, nextProtos []string) (net.Listener, error)

func (*Server) CreateQUICListner

func (s *Server) CreateQUICListner(conn net.PacketConn, nextProtos []string) (*quic.EarlyListener, error)

func (*Server) ServeH3

func (s *Server) ServeH3(l *quic.EarlyListener) error

func (*Server) ServeHTTP

func (s *Server) ServeHTTP(l net.Listener) error

func (*Server) ServeQUIC

func (s *Server) ServeQUIC(l *quic.EarlyListener) error

func (*Server) ServeTCP

func (s *Server) ServeTCP(l net.Listener) error

func (*Server) ServeUDP

func (s *Server) ServeUDP(c net.PacketConn) error

type ServerOpts

type ServerOpts struct {
	// Logger optionally specifies a logger for the server logging.
	// A nil Logger will disable the logging.
	Logger *zap.Logger

	// DNSHandler is the dns handler required by UDP, TCP, DoT server.
	DNSHandler D.Handler

	// HttpHandler is the http handler required by HTTP, DoH server.
	HttpHandler *H.Handler

	// Certificate files to start DoT, DoH server.
	// Only useful if there is no server certificate specified in TLSConfig.
	Cert, Key string

	// KernelTX and KernelRX control whether kernel TLS offloading is enabled
	// If the kernel is not supported, it is automatically downgraded to the application implementation
	//
	// If this option is enabled, please mount the TLS module before you run application.
	// On Linux, it will try to automatically mount the tls kernel module.
	KernelRX, KernelTX bool

	// IdleTimeout limits the maximum time period that a connection
	// can idle. Default is defaultTCPIdleTimeout.
	IdleTimeout time.Duration
}