Nosy Pinocchio Manners


    1.5.1 • Public • Published

    node-mname - DNS Server in Node.js

    mname is a fork of the node-named library, which enables the development of DNS servers in node.js.

    This fork adds the following features:

    • Queries over TCP connections
    • AXFR, IXFR zone transfers
    • PTR records
    • Name compression
    • EDNS 1.0

    Creating a DNS Server

    var named = require('./lib/index');
    var server = named.createServer();
    var ttl = 300;
    server.listenUdp(9999, '', function() {
      console.log('DNS server started on port 9999');
    server.on('query', function(query, done) {
      var domain =;
      console.log('DNS Query: %s', domain)
      var target = new SOARecord(domain, {serial: 12345});
      query.addAnswer(domain, target, ttl);

    Creating DNS Records

    node-named provides helper functions for creating DNS records. The records are available under 'named.record.NAME' where NAME is one of ['A', 'AAAA', 'CNAME', 'SOA', 'MX', 'TXT, 'SRV']. It is important to remember that these DNS records are not permanently added to the server. They only exist for the length of the particular request. After that, they are destroyed. This means you have to create your own lookup mechanism.

    var named = require('node-named');
    var soaRecord = named.SOARecord('', {serial: 201205150000});

    Supported Record Types

    The following record types are supported

    • A (ipv4)
    • AAAA (ipv6)
    • CNAME (aliases)
    • SOA (start of authority)
    • MX (mail server records)
    • TXT (arbitrary text entries)
    • SRV (service discovery)


    node-named uses for logging. It's a lot nicer to use if you npm install bunyan and put the bunyan tool in your path. Otherwise, you will end up with JSON formatted log output by default.

    Replacing the default logger

    You can pass in an alternate logger if you wish. If you do not, then it will use bunyan by default. Your logger must expose the functions 'info', 'debug', 'warn', 'trace', 'error', and 'notice'.

    Tell me even more...

    When DNS was designed it was designed prior to the web existing, so many of the features in the RFC are either never used, or were never implemented. This server aims to be RFC compliant, but does not implement any other protocol other than INET (the one we're all used to), and only supports a handful of record types (the ones that are in use on a regular basis).




    npm i mname

    DownloadsWeekly Downloads






    Unpacked Size

    120 kB

    Total Files


    Last publish


    • bahamat
    • todd.whiteman
    • kusor
    • michael.hicks
    • dap
    • jclulow
    • arekinath
    • rhb2