compact dns server in rust
Rust HTML
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
samples
src
.gitignore
Cargo.lock
Cargo.toml
README.md
guide.md

README.md

Hermes DNS server

Hermes is a compact DNS server in safe rust. It provides:

  • Quick and easy configuration through a few select command line parameters.
  • The ability to recursively resolve directly using the Internet root servers out of the box, to spare you from trusting anybody else's name servers.
  • Alternatively, use it in forwarding mode to pass your queries onto a DNS server of your choice.
  • The ability to act as an authoritative server for your own zones.
  • A compact API with dual support for HTML and JSON media types across the same endpoints, for easy administration of zones and caching behavior.

Why? As a developer, I usually run many hosts and docker containers on my own machine and assign them names using hosts.txt. I wanted a more convenient way of accomplishing that. Additionally, I like having some insight into the network traffic that passes in and out of my machine and network, and monitoring the DNS layer for anomalies is actually a rather convenient way of doing so.

Command Line Options

This is the result of running hermes -h

Usage: hermes [options]

Options:
    -h, --help          print this help menu
    -a, --authority     disable support for recursive lookups, and serve only
                        local zones
    -f, --forward SERVER
                        forward replies to specified dns server

API endpoints

By default, the API will run on port 5380.

All endpoints can return either JSON or HTML. When POST'ing, you can do so with either form data or json objects.

The following endpoints are available:

  • /cache - List the current cache entries along with statistics
  • /authority - List current authoritative zones
  • /authority/[zone] - List the records within a zone

Contact

Comments and pull requests are welcome and encouraged.

Author: Emil Hernvall emil@c0la.se