Skip to content

Latest commit

 

History

History
47 lines (38 loc) · 2.2 KB

README.md

File metadata and controls

47 lines (38 loc) · 2.2 KB
Raw

Docker DNS

What is it ?

This is a simple container written to resolve containers IPs and be just like any other DNS resolver (but locally).

How it works ?

It will simply try to to map all the running containers to their IP addresses (including himself)

Why ?

I was tired of always needing to find the IP address of the gazillion containers I manage. Updating the /etc/hosts file was not an option for me, as I want that mapping on my phone too, and I access them using VPN (thanks pritunl).

Warning !!

This is just a personal tool, this was never tested for production

Installation

Build the image from this repository

git clone https://github.com/nimda95/docker-dns.git
docker build -t \<local-name-for-this-image-build\> .

Pull from docker hub

docker pull shimgapi/docker-dns

Usage

Default docker run (linux)

docker run -d -v /var/run/docker.sock:/var/run/docker.sock --name docker-dns docker-dns
docker logs -f docker-dns #just to get the usable IPs to be used

Choose from from the IPs that are displayed in the logs and add the suitable one for your setup to your /etc/resolv.conf as follows nameserver 172.16.0.1 (I put it on top of the other nameservers)

Available env variables

You can customize this image to your environment by changing these env variables

Name Description Default Value
AUTO_REFRESH_INTERVAL Time in milliseconds to refresh the list of running containers 5000
DNS_LISTEN_PORT Port for the DNS to listen on 53
REMOTE_RESOLVER_ADDR resolver address to be used to lookup internet addresses 1.1.1.1
REMOTE_RESOLVER_PORT resolver port to be used to lookup internet addresses 53
LIMIT_NETWORKS networks to include ips from in the lookup separated by comma (default=all) ``

Help

PRs are welcome.