Yet another authoritative DNS name server. But with goat references.
Built in Rust, thanks to some great packages
- Networking features use tokio
- DNS Packets are largely decoded/encoded with packed_struct
- HTTP things use:
- Database - sqlx for async SQLite goodness.
- Logging - flexi_logger
Found a bug, want to change something, the sky is falling? Create an issue!.
Wondering how something works, need a chat, or are curious there's so many goat references? Discussions are great for that.
Auto-generated and available here: https://yaleman.github.io/goatns/rustdoc/goatns
goatns.example.json for examples.
The configuration file's fields are best found here: https://goatns.dotgoat.net/rustdoc/goatns/config/struct.ConfigFile.html. Note that the
ip_allow_list field is a nested map.
Rust tests are run using cargo.
A handy load testing tool is dnsblast. This'll run 50,000 "valid" queries, 1500 packets per second, to port 15353:
./dnsblast 127.0.0.1 50000 1500 15353
Or if you want to fuzz the server and test that it doesn't blow up:
./dnsblast fuzz 127.0.0.1 50000 1500 15353
There's a dockerfile at
ghcr.io/yaleman/goatns:latest and a docker-compose.yml file if that's your thing.
This list is now in the book.