IHateDNS

A DNS server with a RESTful HTTP API for updating records, intended for internal testing.

Installation

python3 -m pip install git+https://github.com/DavidBuchanan314/IHateDNS

Or you can just download and execute ihatedns.py, it's a single-file python script.

Invocation

$ ihatedns --help
usage: ihatedns [-h] [--db DB] [--host HOST] [--dns-port DNS_PORT]
                [--http-port HTTP_PORT]

The DNS server for people who hate DNS

options:
  -h, --help            show this help message and exit
  --db DB               sqlite3 db path for persisting records (defaults to
                        :memory: i.e. no persistence)
  --host HOST           listen host (default '127.0.0.1')
  --dns-port DNS_PORT   default 5337 (UDP)
  --http-port HTTP_PORT
                        default 8053

Usage Examples

# no config files, just REST
$ curl -X PUT http://localhost:8053/example.com/a/1.2.3.4,8.8.8.8
$ dig -p 5337 @127.0.0.1 +noall +answer example.com
example.com.            60      IN      A       1.2.3.4
example.com.            60      IN      A       8.8.8.8

# ~all record types supported
$ curl -X PUT http://localhost:8053/_atproto.bob.test/TXT/did=did:web:bob.test
$ dig -p 5337 @127.0.0.1 +noall +answer TXT _atproto.bob.test
_atproto.bob.test.      60      IN      TXT     "did=did:web:bob.test"

# inspect your records over HTTP, too
$ curl http://localhost:8053/_atproto.bob.test/TXT/
_atproto.bob.test. 60 IN TXT "did=did:web:bob.test"

$ curl http://localhost:8053/
example.com. 60 IN A 1.2.3.4
example.com. 60 IN A 8.8.8.8
_atproto.bob.test. 60 IN TXT "did=did:web:bob.test"

# wildcard records also work, btw
$ curl -X PUT http://127.0.0.1:8053/*.example.com/5.6.7.8
$ dig -p 5337 @127.0.0.1 +noall +answer blah.example.com
blah.example.com.       60      IN      A       5.6.7.8

Protip

Put this in your /etc/systemd/resolved.conf:

[Resolve]
DNS=127.0.0.1:5337

And then reload the config

sudo systemctl restart systemd-resolved.service

(Note, this config will race queries against whatever your default resolver is. I think)

TODO

• Optionally, forward requests to another resolver
• Deleting individual records
• More options - log levels, separate DNS/HTTP listen host?
• Tests