xip-ninja

• based on xip.io
• Add support for IPv6 record
• Remove Base36
• Add support of dash pattern (you can now resolve 192-168-0-1.xip.ninja)
• Add top-level AAAA Record
• Add MX and TXT record

Basis

This is a piped backend provider using PowerDNS powering xip.ninja.

xip.ninja is a magic domain name that provides wildcard DNS for any IP address.

Installation

☁️ Install powerdns

sudo apt install pdns-server
sudo apt install pdns-backend-pipe

Pull down source

Clone this git repo to somewhere accessible

📋 Adjust pdns configuration to use a pipe backend

Open /etc/powerdns/pdns.conf and make these adjustments.

launch=pipe
pipe-command=/path/to/xip-pdns/bin/xip-pdns /path/to/xip-pdns/etc/xip-pdns.conf

📋 Adjust xip-pdns configuration

Rename xip-pdns.conf.example → xip.pdns.conf and make adjustments to the following environment variables:

Variable	Example	Description
XIP_DOMAIN	xip.ninja	The root domain of the service
XIP_ROOT_ADDRESSES	51.91.121.80	The IPv4 addresses returned by an A-record lookup for the root domain
XIP_V6_ROOT_ADDRESSES	2001:41d0:404:200::3632	The IPv6 addresses returned by an A-record lookup for the root domain
XIP_NS_ADDRESSES	51.91.121.80	The IP addresses of the nameservers running the xip.ninja container
XIP_TIMESTAMP	2020010912	SOA serial number
XIP_TTL	3600	TTL of all responses
XIP_MX_RECORDS	"10" "mail.xip.ninja"	The MX records for the domain
XIP_TXT_RECORDS	"some text"	the TXT records for the domain

❓ Application

This will only respond to dns requests that end in xip.ninja.

Effectively if you ask for 1.2.3.4.xip.ninja it will return 1.2.3.4 as the IP address.

# dig 1.2.3.4.xip.ninja +short
1.2.3.4

📝 More information

Visit xip.ninja.

For 🇫🇷 visit my blog post

👍 Contributors

📜 License

MIT © Julien Mousqueton