go-wild-dns

command module
Version: v0.0.0-...-2f8fcaa Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 29, 2021 License: MIT Imports: 15 Imported by: 0

README

Go-Wild-DNS

Micro DNS-server that implements wildcard-ip DNS magic functionality:

        10.0.0.1.ip.mydomain.io  resolves to   10.0.0.1
    www.10.0.0.1.ip.mydomain.io  resolves to   10.0.0.1
 mysite.10.0.0.1.ip.mydomain.io  resolves to   10.0.0.1
foo.bar.10.0.0.1.ip.mydomain.io  resolves to   10.0.0.1

It's like your own xip.io

TLS Mode

Optionally go-wild-dns supports TLS Mode for wildcard certificates (which can only wildcard up to first dot):

        10-0-0-1.ip.mydomain.io  resolves to   10.0.0.1
    www-10-0-0-1.ip.mydomain.io  resolves to   10.0.0.1
 mysite-10-0-0-1.ip.mydomain.io  resolves to   10.0.0.1
foo-bar-10-0-0-1.ip.mydomain.io  resolves to   10.0.0.1

TXT records supports (for letencrypt)

See information about TXT_RECORDS_PATH in go-wild-dns.service

Setup

Create NS record for magic-domain:

ip.mydomain.io 	NS 	ns1.ip.mydomain.io

and A record too:

ns1.ip.mydomain.io  A 1.2.3.4

Now go to the 1.2.3.4 server (assuming you're using systemd-based Linux):

  1. Setup go compiler, build go-wild-dns binary (just run go build), copy binary to /opt/go-wild-dns
  2. Edit go-wild-dns.service: specify your DOMAIN_SUFFIX environment variable. Specify IP of other NS servers if you are using > 1.
  3. cp conf.yaml.example conf.yaml, and modify conf.yaml
  4. mkdir /opt/go-wlid-dns && copy conf.yaml & compiled binary.
  5. Copy go-wild-dns.service to /etc/systemd/system/
  6. systemctl daemon-reload && systemctl enable go-wild-dns && systemctl start go-wild-dns
  7. Allow firewall access to port 53 (UDP)

Now repeat everything for secondary server (optional)

DNS Pecularities

  • No NS / SOA records implemented
  • Returns its own IP as a fallback

Documentation

The Go Gopher

There is no documentation for this package.

Source Files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL