https://github.com/sagi/node-dnstls

DNS-over-TLS Command Line Tool
https://github.com/sagi/node-dnstls

Last synced: about 1 year ago
JSON representation

DNS-over-TLS Command Line Tool

• Host: GitHub
• URL: https://github.com/sagi/node-dnstls
• Owner: sagi
• License: mit
• Created: 2018-09-01T14:50:50.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2023-03-04T03:45:13.000Z (over 3 years ago)
• Last Synced: 2025-05-07T11:15:19.862Z (about 1 year ago)
• Language: TypeScript
• Size: 1.6 MB
• Stars: 10
• Watchers: 1
• Forks: 1
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# dnstls

[`dnstls`](https://www.npmjs.com/package/dnstls) is a Node.js DNS over TLS command line tool. Here's a [blog post](https://sagi.io/2018/09/dns-over-tls---thoughts-and-implementation/) that explains how it works.

[![CircleCI](https://circleci.com/gh/sagi/node-dnstls.svg?style=svg)](https://circleci.com/gh/sagi/node-dnstls)

[![Coverage Status](https://coveralls.io/repos/github/sagi/node-dnstls/badge.svg?branch=master)](https://coveralls.io/github/sagi/node-dnstls?branch=master)

[![MIT License](https://img.shields.io/npm/l/dnstls.svg?style=flat-square)](http://opensource.org/licenses/MIT)

[![version](https://img.shields.io/npm/v/dnstls.svg?style=flat-square)](http://npm.im/dnstls)

## Installation:

~~~

$ npm i -g dnstls

~~~

Usage:

~~~

Usage: dnstls name [type] [class] [@server] [-p] [+tls-host=]

~~~

If only `name` (domain name) is provided, it defaults to using Cloudflare's DNS-over-TLS server

(`@1.1.1.1 +tls-host=cloudflare-dns.com`).

## Example

~~~

$ dnstls sagi.io

~~~

Output:

~~~json

{

  "id": 9013,

  "type": "response",

  "flags": 384,

  "flag_qr": true,

  "opcode": "QUERY",

  "flag_aa": false,

  "flag_tc": false,

  "flag_rd": true,

  "flag_ra": true,

  "flag_z": false,

  "flag_ad": false,

  "flag_cd": false,

  "rcode": "NOERROR",

  "questions": [

    {

      "name": "sagi.io",

      "type": "A",

      "class": "IN"

    }

  ],

  "answers": [

    {

      "name": "sagi.io",

      "type": "A",

      "ttl": 300,

      "class": "IN",

      "flush": false,

      "data": "151.101.1.195"

    },

    {

      "name": "sagi.io",

      "type": "A",

      "ttl": 300,

      "class": "IN",

      "flush": false,

      "data": "151.101.65.195"

    }

  ],

  "authorities": [],

  "additionals": []

}

~~~

Probably some time the future we'll add a `DiG`-like output.

## License

MIT