godns

Building

Builds binaries for darwin_arm64, linux_amd64, and linux_arm64 platforms.

./build.sh

Configuration

Modify the hosts.json config file with keys => values of hosts => ips.

The default fallback resolver is Cloudflare public DNS (1.1.1.1) if no matching host is found in hosts.json.

Usage

$ dig @127.0.0.1 app1.mydomain.com

; <<>> DiG 9.10.6 <<>> @127.0.0.1 app1.mydomain.com
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 42430
;; flags: qr aa rd; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 0
;; WARNING: recursion requested but not available

;; QUESTION SECTION:
;app1.mydomain.com.     IN  A

;; ANSWER SECTION:
app1.mydomain.com.  1   IN  A   1.2.3.4

;; Query time: 0 msec
;; SERVER: 127.0.0.1#53(127.0.0.1)
;; WHEN: Thu Apr 10 10:21:05 CDT 2025
;; MSG SIZE  rcvd: 68

Fallback resolver using Cloudflare public DNS:

$ dig @127.0.0.1 google.com

; <<>> DiG 9.10.6 <<>> @127.0.0.1 google.com
; (1 server found)
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 52275
;; flags: qr rd ra; QUERY: 1, ANSWER: 6, AUTHORITY: 0, ADDITIONAL: 0

;; QUESTION SECTION:
;google.com.            IN  A

;; ANSWER SECTION:
google.com.     248 IN  A   172.253.113.101
google.com.     248 IN  A   172.253.113.138
google.com.     248 IN  A   172.253.113.139
google.com.     248 IN  A   172.253.113.100
google.com.     248 IN  A   172.253.113.102
google.com.     248 IN  A   172.253.113.113

;; Query time: 7 msec
;; SERVER: 127.0.0.1#53(127.0.0.1)
;; WHEN: Thu Apr 10 22:46:27 CDT 2025
;; MSG SIZE  rcvd: 18