1.0.0 • Published 10 months ago

@gucheen/doh-js-client v1.0.0

Weekly downloads
-
License
MIT
Repository
-
Last release
10 months ago

doh-js-client

Test and Build

DNS-over-HTTPS/DNS-over-TLS client for nodejs, secure your nodejs dns query with modern tls.

changes of this fork

  1. migrate to ES modules
  2. add ali and dnspod as DNS provider
  3. add typescript declaration file

Install

$ npm install @gucheen/doh-js-client

Usage

DNS over HTTPS (:443)

  1. Initialize the instance with given provider (google, cloudflare, cleanbrowsing)
const DoH = require('doh-js-client').DoH

let dns = new DoH('google')
  1. Resolve dns name
dns.resolve('example.com', 'A')
  .then(function (record) {
    // do something
  })
  .catch(function (err) {
    // something wrong happened
  })

DNS over TLS (:583)

  1. Initialize the instance with given provider (google, cloudflare, cleanbrowsing)
const DoT = require('doh-js-client').DoT

let dns = new DoT('google', privateKeyFilePath, certificateFilePath)
  1. Resolve dns name
dns.resolve('example.com', 'A')
  .then(function (record) {
    // do something
  })
  .catch(function (err) {
    // something wrong happened
  })

Known issue and supported dns type

  1. Cleanbrowsing doesn't support caa query (return 400).

  2. Supported dns type:

  • A
  • AAAA
  • CAA
  • CNAME
  • DS
  • DNSKEY
  • MX
  • NS
  • NSEC
  • NSEC3
  • RRSIG
  • SOA
  • TXT

License

MIT

1.0.0

10 months ago