nickns's Introduction

NickNS

NickNS is DNS Server. This server resolve VM Name into IP Address on VMware ESXi.

Versions

Go 1.17 or later

Installation

Download binary file from here.

wget

On Linux:

wget https://github.com/cdsl-research/nickns/releases/latest/download/release-lin64.zip
unzip release-lin64.zip

curl

On Linux:

curl -o release-lin64.zip https://github.com/cdsl-research/nickns/releases/latest/download/release-lin64.zip
unzip release-lin64.zip

go get

go install github.com/cdsl-research/nickns

Usage

[0] Enable SSH on ESXi

Generate SSH Key on laptop.

ssh-keygen -t rsa -b 4096

Copy SSH key from from laptop to ESXi.

$ sftp [email protected]
Connected to [email protected].
sftp> puts /path/to/id_rsa.pub /etc/ssh/keys-root/authorized_keys

Try to connect SSH on Terminal.

ssh -i /path/to/id_rsa [email protected]

[1] Edit Config files

Set ESXi Host on hosts.toml.

[host A]
address = "esxi.example.com"
port = "22"
user = "root"
identity_file = "/path/to/id_rsa"

[host B]
address = "esxi.example.com"
port = "22"
user = "root"
password = "my_password"

Set NickNS running options on config.toml.

port = 5310
domains = ["local.", "example.com."]
ttl = 3600

[2] start server

$ nickns
2020/03/14 21:40:25 NickNS Starting at 5310/udp
2020/03/14 21:40:27 [QueryHit] elastic5.local. => 192.168.0.36
2020/03/14 21:40:30 [QueryHit] elastic5.example.com. => 192.168.0.36

The command supports config options as follows.

-c string
      Path to config.toml (default "config.toml")
-n string
      Path to hosts.toml (default "hosts.toml")

Development

Build local ssh server

docker build -t ssh .
docker run -it -p 2200:22 ssh

Run DNS Server

go run main.go

Check DNS server

# Type A
$ dig A +short @127.0.0.1 -p 5300 unbound.local
192.168.0.35
$ dig A +short @127.0.0.1 -p 5300 unbound.local
192.168.0.35

# Type PTR
$ dig +short @127.0.0.1 -p 5300 -x 192.168.0.35
unbound.local.

Server Log

2020/02/29 18:47:25 Starting at 5300
2020/02/29 18:47:38 [QueryHit] unbound.local. => 192.168.0.35
2020/02/29 18:47:41 [CacheHit] unbound.local.
2020/02/29 18:47:42 [QueryHit] unbound.local. => 192.168.0.35
2020/02/29 18:47:52 [QueryHit] 35.0.168.192.in-addr.arpa. => unbound.local.

nickns's People