Generate DNS files using json
JavaScript
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib
tests
.gitignore
README.md
example.json
index.js
package.json

README.md

DNS Generator

Generate DNS files using json

Install

Install the command line tool dnsgen

npm install -g dnsgen

Install locally to use as a module

npm install dnsgen

Usage

Command line

dnsgen bind reverse < example.json

As a module

var dnsgen = require('dnsgen');

Example

Command line tool

The command line tool reads json from stdin, and pipes the output to stdout

$ dnsgen bind < example.json
; Bind file for example.com (10.0.0.0/23)
@	IN	SOA	ns1.example.com.	admin.example.com. (
    2012081701	; serial
    28800	; refresh
    7200	; retry
    864000	; expire
    86400	; ttl
)
example.com.	IN	NS	ns1.example.com.
example.com.	IN	NS	ns2.example.com.
gw	IN	A	10.0.0.1
zelda	IN	A	10.0.0.2	; Testing Box
link	IN	A	10.0.0.3	; Another box for testing
gw2	IN	A	10.0.1.1

You can also generate reverse lookup files

$ dnsgen bind reverse < example.json
; Bind file for example.com (10.0.0.0/23)
@	IN	SOA	ns1.example.com.	admin.example.com. (
    2012081701	; serial
    28800	; refresh
    7200	; retry
    864000	; expire
    86400	; ttl
)
    IN	NS	ns1.example.com.
    IN	NS	ns2.example.com.
0.1	IN	PTR	gw.example.com.
0.2	IN	PTR	zelda.example.com.	; Testing Box
0.3	IN	PTR	link.example.com.	; Another box for testing
1.1	IN	PTR	gw2.example.com.

Tiny dns is also cool

$ dnsgen tinydns < example.json
# tinydns file for example.com (10.0.0.0/23)
Zexample.com:ns1.example.com:admin.example.com:2012081701:28800:7200:864000
&example.com::ns1.example.com:86400
&example.com::ns2.example.com:86400
=gw:10.0.0.1
=zelda:10.0.0.2	# Testing Box
=link:10.0.0.3	# Another box for testing
=gw2:10.0.1.1

Node Module

The exports of dnsgen return a stream that you can pipe anywhere you want

var dnsgen = require('dnsgen'),
    json = require('./example.json');

// Generate forward lookup file
dnsgen.bind(json).pipe(process.stdout);

// Generate reverse lookup file
dnsgen.bindReverse(json).pipe(process.stdout);

// Generate tinydns config
dnsgen.tinydns(json).pipe(process.stdout);

example.json

{
  "domain": "example.com",
  "admin": "admin.example.com",
  "time": {
    "refresh": 28800,
    "retry": 7200,
    "expire": 864000,
    "ttl": 86400
  },
  "ns": [
    "ns1.example.com",
    "ns2.example.com"
  ],
  "netmask": "10.0.0.0/23",
  "hosts": {
    "10.0.0.1": "gw",
    "10.0.0.2": {
      "name": "zelda",
      "comment": "Testing Box"
    },
    "10.0.0.3": {
      "name": "link",
      "comment": "Another box for testing"
    },
    "10.0.1.1": "gw2"
  }
}

Tests

npm test

Known Limitations

  • This module only supports outputting files suitable for BIND and tiny DNS servers.
  • Only A, NS and PTR records can be generated

License

MIT Licensed