golodns is a simple DNS server replying to type A and NXDOMAIN queries and maps those to a specific IP address.
It is meant to help with local development so that there is no need to fiddle around with /etc/hosts anymore.
As it is a simple binary you can just download the respective file.
It is recommended to place the binary to a
${PATH}accessible location (f.e./usr/local/binon macOS).
In order to setup your local environment golodns provides means to add entries to the resolver system.
There are three commands that can help you with managing the domain mappings:
list: List all registered resolvers (should be empty per default)install: Register a new resolver for a specific domainuninstall: Uninstall an existing resolver (if created bygolodns)
In order to list the current resolvers run:
golodns list
This outputs something like "No resolvers found." initially as normally there are none. If there are registered ones it will indicate which of them are managed by
golodns.
If you want to setup a new resolver run
sudo golodns install -domain dev -addr 127.0.0.1 -port 5300
to resolve the dev TLD via a nameserver listening on 127.0.0.1:5300.
You need to run it as
sudouser as it effectively writes to the/etcpath which is not writable for normal users.
If you want to remove a resolver run
sudo golodns uninstall -domain dev
golodnsonly removes resolvers that where created by it.
Autocompletion for bash and zsh goes as simple as:
golodns -autocomplete-install
Please re-login to the respective shell after that.
The removal is equally easy (even with autcompletion):
golodns -autocomplete-uninstall
If you have set up your local environment you just need to run:
golodns serve
You need to add special flags like
-portetc. ofc if desired / configured. Per defaultgolodnsresolves via127.0.0.1:5300to127.0.0.1for domains.
Then test the setup by doing f.e. a ping call:
ping -c 1 some.dev
This project uses glide to handle dependencies in a more reliable way.
In order to build the binary just clone the repository and build it go build. For a smaller binary please
use go build -ldflags "-w" instead.
MIT
golodns started as a clone of https://github.com/robbiev/devdns.