forward

Documentation

Overview

Package forward implements a forwarding proxy.

A cache is used to reduce load on the upstream servers. Cached items are only used for a short time, because otherwise, we would need to provide a feature for flushing the cache. The cache is most useful for taking the load from applications making very frequent repeated queries. The cache also doubles as a way to merge concurrent identical queries, since items are inserted into the cache before sending the query upstream (see also RFC 5452, Section 5).

Index

• type Forward
  • func New() *Forward
  • func (f *Forward) HandleDNS(r *netDNS.Request)
  • func (f *Forward) Run(ctx context.Context) error

Types

type Forward

type Forward struct {
	DNSServers memory.Value[[]string]
	// contains filtered or unexported fields
}

Forward represents a plugin instance that can proxy requests to another (DNS) server. It has a list of proxies each representing one upstream proxy.

func New

func New() *Forward

New returns a new Forward.

func (*Forward) HandleDNS

func (f *Forward) HandleDNS(r *netDNS.Request)

func (*Forward) Run

func (f *Forward) Run(ctx context.Context) error