dnsheaven

package module
v1.0.1-0...-7625dce Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 22, 2019 License: MIT Imports: 6 Imported by: 0

README

dns-heaven

dns-heaven fixes macOS DNS stack by enabling the usage of the native DNS stack through /etc/resolv.conf.

Overview

Some programs like dig, nslookup and anything compiled with Go doesn't use macOS native name resolution stack. This makes some features like split DNS to not work with those programs.

This occurs because macOS native name resolution uses a set of rules that aren't compatible with resolv.conf. This includes:

  • Per interface DNS settings (scoped)
  • Per domain settings

In order to support programs that uses resolv.conf, macOS writes a file with only the primary name server and search domains that were configured either through DHCP or manually.

Installation

Just run:

curl -L https://git.io/fix-my-dns-plz | sudo bash

This script downloads the latest version and installs a LaunchAgent making sure that dns-heaven is always running.

If you want to do this manually, just download the latest release or compile dns-heaven yourself, and make sure it's always running.

How it works

dns-heaven exposes a DNS server that acts as a proxy mimicking native macOS behaviour. This is accomplished by periodically reading the output of scutil --dns and updating upstream rules and nameservers.

It also keeps /etc/resolv.conf pointing to 127.0.0.1 as the system will rewrite this file whenever your network settings changes (e.g.: changing wifi network).

Alternatives

dnsmasq

This is one of the best options but it has some drawbacks. In order to use dnsmasq you need to manually specify it on network settings and manually configure the upstream forwarders. This is bad because sometimes you want to use the servers announced on DHCP instead of something static like 8.8.8.8 and 8.8.4.4.

License

MIT.

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Config 

type Config struct {
	Address  string
	Timeout  int
	Interval int
}

type ResolvError 

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

ResolvError type

func (ResolvError) Error 

func (e ResolvError) Error() string

Error formats a ResolvError

type Resolver 

type Resolver interface {
	Resolve(net string, req *dns.Msg) (*dns.Msg, error)
}

type Server 

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

func NewServer 

func NewServer(config *Config, resolver Resolver) *Server

func (*Server) Shutdown 

func (s *Server) Shutdown() error

func (*Server) Start 

func (s *Server) Start() error

type StandardResolver 

type StandardResolver struct {
	Nameservers []string
	Timeout     time.Duration
	Interval    time.Duration
}

Resolver type

func (*StandardResolver) Lookup 

func (r *StandardResolver) Lookup(net string, req *dns.Msg) (message *dns.Msg, err error)

Lookup will ask each nameserver in top-to-bottom fashion, starting a new request in every second, and return as early as possbile (have an answer). It returns an error if no request has succeeded.

Source Files

View all Source files

Directories

Path Synopsis
cmd
dns-heaven

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.