Solve your DNS hosts from your docker containers, then from your local configuration, then from internet
Latest commit 1aa79f1 Oct 16, 2018
Permalink
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Update issue templates May 18, 2018
cache #60 some code to enable log manipulation Feb 27, 2018
conf Access containers by it's name / service name (#88) Oct 6, 2018
controller #48 fixing missing tests compile errors May 6, 2018
docs ability to set default network on container start (#89) Oct 17, 2018
events ability to set default network on container start (#89) Oct 17, 2018
flags Access containers by it's name / service name (#88) Oct 6, 2018
log Fixing log level and wildcard features (#72) May 31, 2018
proxy Feature/83 (#84) Jul 22, 2018
resolvconf Organize some logs and auto reconfigure as default dns if resolvconf … May 31, 2018
service #48 fixing tests compile errors May 6, 2018
static MG-206 align columns Mar 25, 2017
test #48 fixing tests compile errors May 6, 2018
utils Access containers by it's name / service name (#88) Oct 6, 2018
vendor Fixing log level and wildcard features (#72) May 31, 2018
.editorconfig MG-404 move packages Sep 30, 2017
.gitignore ability to set default network on container start (#89) Oct 17, 2018
.travis.yml encapsulating logic to build script Oct 15, 2017
Dockerfile MG-341 adding version to log, fixing err log, fixing iamge build Jul 14, 2017
Dockerfile.hub Releasing 2.8.0 Oct 17, 2018
LICENSE Create LICENSE Jul 9, 2017
README.md add features to Readme Oct 17, 2018
RELEASE-NOTES.md ability to set default network on container start (#89) Oct 17, 2018
VERSION ability to set default network on container start (#89) Oct 17, 2018
builder Fixing log level and wildcard features (#72) May 31, 2018
countlines adding countlines program May 16, 2018
dns.go Feature/83 (#84) Jul 22, 2018
docker-compose.yml Releasing 2.8.0 Oct 17, 2018

README.md

Build Status

Features

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

For more details see the Documentation or Release Notes

Running it

$ docker run --rm --hostname dns.mageddo \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /etc/resolv.conf:/etc/resolv.conf \
defreitas/dns-proxy-server

then try it out

$ ping dns.mageddo
PING dns.mageddo (172.17.0.4) 56(84) bytes of data.
64 bytes from 172.17.0.4: icmp_seq=1 ttl=64 time=0.063 ms
64 bytes from 172.17.0.4: icmp_seq=2 ttl=64 time=0.074 ms
64 bytes from 172.17.0.4: icmp_seq=3 ttl=64 time=0.064 ms

Checkout the full running it documentation for more details

Requirements

  • Linux/Windows
  • Docker 1.9.x (Only if you run DPS using docker or want to solve docker containers hostname using DPS)

DNS resolution order

DNS Proxy Server follow the below order to solve hostnames

  • Try to solve the hostname from docker containers
  • Then from local database file
  • Then from 3rd configured remote DNS servers

Documents

MAC Support

Based on users feedback, DPS don't work on MAC, unfortunatly I don't have a MAC computer to work on that, if you want to contribute please try to fix it then open a pull request, sorry for the inconvenience.