alessioalex / dns-proxy-server Goto Github PK

Obs: This is the version 2, for the old version 1 see this link

Dns-proxy-server is a end user(developers, Server Administrators) DNS server tool to develop systems with docker solving docker containers hostnames:

• Solve names from local configuration database
• Solve names from docker containers using docker hostname option or HOSTNAMES env
• Solve names from a list of configured DNS servers(as a proxy) if no answer of two above
• Graphic interface to manage it
  • List and edit DNS local entries

For more details see Release Notes

• Linux
• Docker 1.9.x

The Dns Proxy Server basically follow the bellow order to solve the names:

• DNS try to solve the hosts from docker containers
• then from local database file
• then from 3rd configured remote DNS servers

This tool comes from nodejs version(1.0), improving:

• Performance - this version uses much less RAM and is much faster
• Bug fixes
• Binary distribution - now you can simply download a linux executable and use it, without need to install anything
• Code design quality
• And more

$ docker run --hostname dns.mageddo --name dns-proxy-server -p 5380:5380 \
-v /opt/dns-proxy-server/conf:/app/conf \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /etc/resolv.conf:/etc/resolv.conf \
defreitas/dns-proxy-server

Download the latest version, extract and run

$ sudo ./dns-proxy-server

Dns Proxy Server is now your current DNS server, to back everything to original state just press CTRL + C

Starting some docker container and keeping it alive for DNS queries

$ docker run -d --hostname debian.dev.intranet \
  -e 'HOSTNAMES=debian2.dev.intranet,debian3.dev.intranet' \
  debian sleep infinity
d96280ba54b44446f342ca78c0bc3b6b23efd78393d8e51e68757b5004314924

Solving the docker container hostname from Dns Proxy Server

$ nslookup debian.dev.intranet
Server:		172.22.0.6
Address:	172.22.0.6#53

Non-authoritative answer:
Name:	debian.dev.intranet
Address: 172.22.0.7

Google keep working was well

$ nslookup google.com
Server:		172.22.0.6
Address:	172.22.0.6#53

Non-authoritative answer:
Name:	google.com
Address: 172.217.29.206

Start the server at custom port and solving from it

nslookup -port=8980 google.com 127.0.0.1

./conf/config.json

{
  "remoteDnsServers": [ [8,8,8,8], [4,4,4,4] ], // Remote DNS servers to be asked when can not solve from docker or local storage 
                                                // If no one server was specified then the 8.8.8.8 will be used
  "envs": [ // all existent environments 
    {
      "name": "", // empty string is the default
      "hostnames": [ // all local hostnames entries
        {
          "id": 1,
          "hostname": "github.com",
          "ip": [192, 168, 0, 1],
          "ttl": 255
        }
      ]
    }
  ],
  "activeEnv": "", // the default env keyname 
  "lastId": 1, // hostnames sequence, don't touch here
  "webServerPort": 0, // web admin port, when 0 the default value is used, see --help option
  "dnsServerPort": 8980 // dns server port, when 0 the default value is used
}

$ ./dns-proxy-server --help
-compress
	compress replies
-conf-path string
	The config file path  (default "conf/config.json")
-cpuprofile string
	write cpu profile to file
-default-dns
	This DNS server will be the default server for this machine (default true)
-help
	This message
-server-port int
	The DNS server to start into (default 53)
-service string
	Setup as service, starting with machine at boot
		docker = start as docker service,
		normal = start as normal service,
		uninstall = uninstall the service from machine 
-tsig string
	use MD5 hmac tsig: keyname:base64
-web-server-port int
	The web server port (default 5380)

1. Download the latest release and extract it

2. Run the service installer

    $ sudo ./dns-proxy-server -service=docker
   

this way it will start with the OS

if you want to stop

$ sudo service dns-proxy-server stop
Stopping service…
Service stopped

if you don't want this service anymore

$ sudo service dns-proxy-server uninstall
Are you really sure you want to uninstall this service? That cannot be undone. [yes|No] 
yes

Take a look at the wiki for more details of how develop at this project