hbo-dnsd

library0.9.8jsnpmunverified

hbo-dnsd (also known as dnsd) is a Node.js package providing functionalities for encoding and decoding DNS messages, as well as an API to run custom authoritative DNS servers. Currently at version 0.9.8, its development appears to have ceased around 2012, judging by the provided examples and the specified Node.js engine compatibility (>= 0.8). The package differentiates itself by offering direct programmatic control over DNS message structures as JavaScript objects, allowing developers to implement highly customized DNS resolution logic. It enables the creation of dynamic DNS responses based on request parameters, unlike static DNS server configurations. Due to its age, it relies solely on CommonJS modules and is not actively maintained, making it potentially incompatible with modern Node.js versions or ESM-first projects.

http-networking serialization

npm install hbo-dnsd

github ↗package ↗

INSTALL

IMPORT

SIG · HBO-DNSD

hbo-dnsd

http-networkingjavascriptv0.9.8

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

dnsd

✓ const dnsd = require('dnsd')

✗ import dnsd from 'dnsd'

The package is CommonJS-only and does not provide an ESM export. Direct `import` statements will fail.

createServer

✓ const server = dnsd.createServer(...)

✗ import { createServer } from 'dnsd'

`createServer` is a method on the `dnsd` object, not a named export. The package is CJS-only.

Demonstrates creating a dynamic DNS server that responds to A and SOA queries with custom logic, including logging requests and setting dynamic TTLs.

const dnsd = require('dnsd') const server = dnsd.createServer(handler) server.zone('example.com', 'ns1.example.com', 'us@example.com', 'now', '2h', '30m', '2w', '10m') .listen(5353, '127.0.0.1') console.log('Server running at 127.0.0.1:5353') function handler(req, res) { console.log('%s:%s/%s %j', req.connection.remoteAddress, req.connection.remotePort, req.connection.type, req) const question = res.question[0] , hostname = question.name , length = hostname.length , ttl = Math.floor(Math.random() * 3600) if(question.type == 'A') { res.answer.push({name:hostname, type:'A', data:"1.1.1."+length, 'ttl':ttl}) res.answer.push({name:hostname, type:'A', data:"2.2.2."+length, 'ttl':ttl}) } res.end() } // To test, run this script and then in your terminal: // $ dig @localhost -p 5353 example.com soa // $ dig @localhost -p 5353 example.com a

dnsd --version

Debug

Known issues

breakingOutdated Node.js compatibility: The package specifies compatibility with Node.js >= 0.8. Running it on modern Node.js versions (e.g., Node.js 16, 18, 20+) is highly likely to lead to unexpected behavior, runtime errors, or security vulnerabilities due to significant API changes and deprecations in the Node.js core over the last decade.

fix

This package is fundamentally incompatible with modern Node.js. Consider using a more actively maintained DNS library like 'dns-packet' for encoding/decoding or 'dnscat2' for server functionality if a custom DNS server is required. There is no direct fix to make this package work reliably on recent Node.js versions.

affects: >=0.9.8

gotchaCommonJS-only Module: `hbo-dnsd` is written exclusively in CommonJS (`require()`) and does not provide an ES Module (ESM) export. Developers in modern Node.js projects configured for ESM (`"type": "module"` in `package.json` or `.mjs` files) will encounter issues.

fix

Ensure the file importing `hbo-dnsd` is treated as CommonJS (e.g., use `.cjs` file extension, or remove `"type": "module"` from `package.json`). If using ESM, a dynamic `import('dnsd')` might technically work in some contexts, but this package's synchronous nature makes it less suitable for such use.

affects: >=0.9.8

breakingLack of Maintenance & Security: The package has not been updated since 2014 and is considered abandoned. This implies a critical lack of security patches for potential DNS-related vulnerabilities (e.g., DNS amplification, cache poisoning) or compatibility fixes for evolving network standards and operating system changes.

fix

Do not use this package in production environments or for security-sensitive applications. Seek actively maintained alternatives that adhere to modern security practices and are regularly updated.

affects: >=0.9.8

gotchaPort 53 requires elevated privileges: Running a DNS server on the standard UDP port 53 typically requires root/administrator privileges on most operating systems. The examples provided use port 5353, which is unprivileged, but for an actual public DNS service, port 53 is necessary.

fix

If deploying a DNS server on port 53, configure your system to allow the Node.js process to bind to privileged ports (e.g., using `setcap` on Linux), or use a port forwarding/redirection mechanism (e.g., `iptables`). Running the entire Node.js application as root is generally discouraged for security reasons.

affects: >=0.9.8

gotchaNo TypeScript definitions: The package does not ship with TypeScript type definitions (`.d.ts` files). This means users in TypeScript projects will lack type safety and autocompletion, potentially leading to runtime errors that would otherwise be caught at compile time.

fix

Developers must either write their own declaration files (`declare module 'dnsd';` for basic usage, or more detailed interfaces for `req`, `res`, and server methods) or disable type checking for imports from this module.

affects: >=0.9.8

Errors

Common errors & fixes

ReferenceError: require is not defined

Attempting to use `require('dnsd')` in an ES Module context (e.g., in a `.mjs` file or a project with `"type": "module"` in `package.json`).

fix

Ensure the file where `require('dnsd')` is used is treated as a CommonJS module. This can involve changing the file extension to `.cjs` or ensuring `"type": "commonjs"` is set in the nearest `package.json` for that file's scope.

Error: listen EACCES: permission denied 0.0.0.0:53

The Node.js process attempted to bind to a privileged network port (like port 53) without sufficient operating system permissions (e.g., not running as root).

fix

Run the Node.js process with `sudo` (not recommended for production due to security implications) or configure system capabilities to allow non-root processes to bind to privileged ports. Alternatively, use a higher, unprivileged port (e.g., 5353) and configure network traffic redirection (e.g., `iptables` on Linux, or similar tools on other OS) from port 53 to the chosen unprivileged port.

TypeError: Cannot read properties of undefined (reading 'listen') (or similar runtime errors related to Node.js core APIs)

`hbo-dnsd` was developed for Node.js 0.8, and its internal implementation might rely on Node.js core APIs that have changed, been deprecated, or removed in much newer Node.js versions.

fix

This issue indicates deep incompatibility. The most effective fix is to migrate to a modern, actively maintained DNS library that supports current Node.js versions, as retrofitting this package for modern Node.js is impractical and risky.

Upgrade

Version history

0.9.8latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/hbouvier/dnsd ↗

packagehttps://www.npmjs.com/package/hbo-dnsd ↗