Skip to content

uxbh/ztdns

Repository files navigation

ZerotierDNS

ztDNS is a dedicated DNS server for a ZeroTier virtual network.

Overview

ztDNS pulls device names from Zerotier and makes them available by name using either IPv4 assigned addresses or IPv6 assigned addresses.

Getting Started

Traditional

If you prefer the traditional installation route:

Requirements

  • Go tools - if not using a precompiled release

Install

  1. First use go get to install the latest version, or download a precompiled release from https://github.com/uxbh/ztdns/releases

    go get -u github.com/uxbh/ztdns/
    go build
  2. If you are running on Linux, run sudo setcap cap_net_bind_service=+eip ./ztdns to enable non-root users to bind privileged ports. On other operating systems, the program may need to be run as an administrator.

  3. Add a new API access token to your user under the account tab at https://my.zerotier.com. If you do not want to store your API access token in the configuration file you can also run the server with the env command: env 'ZTDNS_ZT.API=<<APIToken>>' ./ztdns server

  4. Run ztdns mkconfig to generate a sample configuration file.

  5. Add your API access token, Network names and IDs, and interface name to the configuration.

  6. Start the server using ztdns server.

  7. Add a DNS entry in your ZeroTier members pointing to the member running ztdns.

Once the server is up and running you will be able to resolve names based on the short name and suffix defined in the configuration file (zt by default) from ZeroTier.

dig @serveraddress member.domain.zt A
dig @serveraddress member.domain.zt AAAA
ping member.domain.zt

Arch Linux (install with your favorite Arch package manager: aurman, pacaur, pikar, yay)

  • ztdns-git Package now availabe on Arch Linux via AUR.
    yay -S ztdns-git

Docker

If you prefer to run the server with Docker:

Docker Requirements

Docker Install

  1. Clone or download this repo
  2. Create a .ztdns.toml file in the main directory by copying the .ztdns.toml.example file.
  3. Add your API access token, Network ID, and interface name to the newly created configuration file.
  4. By default it will be bound to port 5356 on the host, that can be changed to standard DNS port 53 by modifying the docker-compose.yml file. You must be running Docker with root permissions in order to bind the privileged port properly.
  5. Run docker-compose up to start the server.
  6. Add a DNS entry in your ZeroTier members pointing to the member running ztdns.

Once the server is up and running you will be able to resolve names based on the short name, domain and suffix defined in the configuration file (zt by default) from ZeroTier.

# remove -p 5356 if running on port 53
dig @127.0.0.1 -p 5356 member.domain.zt A
dig @127.0.0.1 -p 5356 member.domain.zt AAAA
ping member.domain.zt

Contributing

Thanks for considering contributing to the project. We welcome contributions, issues or requests from anyone, and are grateful for any help. Problems or questions? Feel free to open an issue on GitHub.

Please make sure your contributions adhere to the following guidelines:

  • Code must adhere to the official Go formating guidelines (i.e. uses gofmt).
  • Pull requests need to be based on and opened against the master branch.