Node.js API详解之 dns模块用法实例分析


Posted in Javascript onMay 15, 2020

本文实例讲述了Node.js API详解之 dns模块用法。分享给大家供大家参考,具体如下:

Node.js API详解之 dns

dns (域名服务器)模块包含两类函数:

第一类函数,使用底层操作系统工具进行域名解析,且无需进行网络通信。 这类函数只有一个:dns.lookup()。

例子,查找 baidu.com:

const dns = require('dns');
dns.lookup('www.baidu.com', (err, address, family) => {
 console.log('IP 地址: %j 地址族: IPv%s', address, family);
});
// IP 地址: "180.149.131.98" 地址族: IPv4

第二类函数,连接到一个真实的 DNS 服务器进行域名解析,且始终使用网络进行 DNS 查询。
这类函数包含了 dns 模块中除 dns.lookup() 以外的所有函数。
这些函数使用与 dns.lookup() 不同的配置文件(例如 /etc/hosts)。
这类函数适合于那些不想使用底层操作系统工具进行域名解析、而是想使用网络进行 DNS 查询的开发者。

例子,解析 ‘archive.org' 然后逆向解析返回的 IP 地址:

const dns = require('dns');
dns.resolve4('archive.org', (err, addresses) => {
 if (err) throw err;
 console.log(`IP 地址: ${JSON.stringify(addresses)}`);
 addresses.forEach((a) => {
  dns.reverse(a, (err, hostnames) => {
   if (err) {
    throw err;
   }
   console.log(`IP 地址 ${a} 逆向解析到域名: ${JSON.stringify(hostnames)}`);
  });
 });
});
// IP 地址: ["207.241.224.2"]
// IP 地址 207.241.224.2 逆向解析到域名: ["www.archive.org"]

dns.getServers()

说明:

返回一个用于当前DNF解析的IP地址的数组的字符串,格式根据rfc5952。
如果使用自定义端口,那么字符串将包括一个端口部分。

demo:

const dns= require('dns');
console.log( dns.getServers() );
// [ '172.116.20.254', '127.0.0.1' ]

dns.setServers(servers)

说明:

设置IP地址服务器端口在进行DNS解析时可用,servers参数是一个rfc5952数组格式的地址。
如果端口是IANA默认端口(53),那么它可以被忽略。

demo:

const dns = require('dns');
dns.setServers([ '172.116.20.254', '127.1.1.1' ])
console.log( dns.getServers() );
// [ '172.116.20.254', '127.1.1.1' ]

dns.lookup(hostname[, options], callback)

说明:

解析hostname(例如:'nodejs.org')第一个找到的A(IPv4)或AAAA(IPv6)记录。
options可以是对象或者整数。如果options没有被提供,那么IPv4 和 IPv6都是有效的。如果options是整数,只能是4或6。
另外,options可以是一个含有以下属性的对象:
family: T地址族。如果提供,必须为整数4或6。如果没有提供,只接受IPv4和IPv6地址。
all:值为true时, 回调函数返回一个包含所有解析后地址的数组,否则只返回一个地址。默认值为false
hints:如果提供,它必须是一个或多个支持的getaddrinfo标识。如果没有提供,那么没有标识被传递给getaddrinfo。
多个标识可以通过在逻辑上ORing它们的值,来传递给hints。支持的getaddrinfo标识:
dns.ADDRCONFIG: 返回当前系统支持的地址类型。例如,如果当前系统至少配置了一个 IPv4 地址,则返回 IPv4地址。不考虑回环地址。
dns.V4MAPPED: 如果指定了 IPv6 家族, 但是没有找到 IPv6 地址,将返回 IPv4 映射的 IPv6地址。在有些操作系统中不支持(e.g FreeBSD 10.1)。
回调函数包含(err, address, family)参数。
address是IPv4或IPv6地址字符串。
family、是整数4或6,表示地址族(不一定是最初传递给查找的值)。
当all属性被设置为true时,回调函数参数变为(err, addresses),addresses则变成一个由address 和 family 属性组成的对象数组。
dns.lookup() 不需要与DNS协议有任何关系。它仅仅是一个连接名字和地址的操作系统功能。
在任何的node.js程序中,它的实现对表现有一些微妙但是重要的影响。
尽管dns.lookup()和各种dns.resolve *()/ dns.reverse()函数有相同的目标将网络的名字与网络地址联系在一起(反之亦然),
他们的行为是完全不同的。 这些差异可以有微妙但重大影响着Node.js程序行为。

demo:

const dns = require('dns');
const options = {
  family: 6,
  hints: dns.ADDRCONFIG | dns.V4MAPPED,
};
dns.lookup('nodejs.cn', options, (err, address, family) =>
  console.log('address: %j family: IPv%s', address, family));
// address: "::ffff:112.124.39.54" family: IPv6
options.all = true;
dns.lookup('nodejs.cn', options, (err, addresses) =>
  console.log('addresses: %j', addresses));
// addresses: [{"address":"::ffff:112.124.39.54","family":6}]

dns.lookupService(address, port, callback)

说明:

将参数address和port传入操作系统底层getnameinfo服务来解析处理并返回主机名。
如果address不是有效的IP地址,会抛出TypeError。port必须是一个整数.如果不是规定的端口号,会抛出TypeError.
出错情况下,err是一个Error对象,err.code代码错误码。

demo:

const dns = require('dns');
dns.lookupService('127.0.0.1', 22, (err, hostname, service) => {
 console.log(hostname, service);
 // localhost ssh
});

dns.reverse(ip, callback)

说明:

执行一个反向DNS查询返回IPv4或IPv6地址的主机名的数组。

demo:

const dns = require('dns');
dns.reverse('101.20.17.16', (err, hostname) => {
 console.log(hostname);
});

dns.Resolver 类

说明:

DNS请求的独立解析程序。
使用默认的设置创建一个新的解析程序。
为一个解析程序设置servers使用resolver.setServers(),它不会影响其他的解析程序:

demo:

const { Resolver } = require('dns');
const resolver = new Resolver();
resolver.setServers(['4.4.4.4']);
resolver.resolve4('baidu.com', (err, addresses) => {
 console.log(addresses);
});

resolver.cancel()

说明:

取消这个解析程序的未解决的DNS查询,相应的回调用一个ECANCELLED码调用。

demo:

const { Resolver } = require('dns');
const resolver = new Resolver();
resolver.setServers(['4.4.4.4']);
resolver.resolve4('baidu.com', (err, addresses) => {
 console.log(addresses);
});
resolver.cancel();

dns.resolve(hostname[, rrtype], callback)

说明:

hostname:解析的主机名。
rrtype:资源记录类型. 默认: ‘A'.c
使用DNS协议来解析一个主机名(e.g. ‘nodejs.org')为一个资源记录的数组。
回调函数的参数为(err, records)。当成功时,records将是一个资源记录的数组。它的类型和结构取决于rrtype。
下面是不同rrtype对应resolve的快捷方法:

Node.js API详解之 dns模块用法实例分析

demo:

const dns = require('dns');
dns.resolve('archive.org', 'A', (err, addresses) => {
 if (err) throw err;
 console.log(`IP 地址: ${JSON.stringify(addresses)}`);
});
// IP 地址: ["207.241.224.2"]

dns.resolve4(hostname[, options], callback)

说明:

使用DNS协议解析IPv4地址主机名(A记录)。
adresses参数是传递给callback函数的IPv4地址数组。(例如:[‘74.125.79.104', ‘74.125.79.105', ‘74.125.79.106'])
hostname:需要解析的主机名
options.ttl:记录每一条记录的存活次数 (TTL)。如果为 true, 返回的结果将会为 Object 的数组,就像 { address: ‘1.2.3.4', ttl: 60 } 带有 TTL 秒数的记录,而不是 string 的数组.

demo:

const dns = require('dns');
dns.resolve4('archive.org', {ttl: true}, (err, addresses) => {
 if (err) throw err;
 console.log(`IPv4地址数组: ${JSON.stringify(addresses)}`);
});
// IPv4地址数组: [{"address":"207.241.224.2","ttl":58}]

dns.resolve6(hostname[, options], callback)

说明:

使用DNS协议解析IPv6地址主机名(AAAA记录)。
adresses参数是传递给callback函数的IPv6地址数组.

demo:

const dns = require('dns');
dns.resolve6('www.taobao.com', {ttl: true}, (err, addresses) => {
 if (err) throw err;
 console.log(`IPv6地址主机名: ${JSON.stringify(addresses)}`);
});
// IPv6地址主机名: []

dns.resolveCname(hostname, callback)

说明:

使用DNS协议解析CNAME记录主机名。
adresses参数是传递给callback函数规范内有效的主机名数组(例如:[‘bar.example.com']).

demo:

const dns = require('dns');
dns.resolveCname('www.taobao.com', (err, addresses) => {
 if (err) throw err;
 console.log(`CNAME记录主机名: ${JSON.stringify(addresses)}`);
});
// CNAME记录主机名: ["www.taobao.com.danuoyi.tbcache.com"]

dns.resolveMx(hostname, callback)

说明:

使用DNS协议处理邮件交换记录主机名(MX记录)。
adresses参数是传递给callback函数的主机名对象数组,对
象包含priority和exchange属性(例如: [{priority: 10, exchange: ‘mx.example.com'}, …])。

demo:

const dns = require('dns');
dns.resolveMx('mail.qq.com', (err, addresses) => {
 if (err) throw err;
 console.log(`MX记录: ${JSON.stringify(addresses)}`);
});

dns.resolveNaptr(hostname, callback)

说明:

使用DNS协议来处理基于正则表达式匹配的记录(NAPTR记录)的主机名。
adresses参数是传递给callback函数的主机名对象数组,对象包含属性:
flags
service
regexp
replacement
order
preference

demo:

const dns = require('dns');
dns.resolveNaptr('www.taobao.com', (err, addresses) => {
 if (err) throw err;
 
 console.log(`NAPTR记录: ${JSON.stringify(addresses)}`);
});

dns.resolveNs(hostname, callback)

说明:

使用DNS协议处理名称服务器主机名记录(NS记录)。
adresses为有效的名称服务器记录主机名数组(eg:[‘ns1.example.com', ‘ns2.example.com'])。

demo:

const dns = require('dns');
dns.resolveNs('www.taobao.com', (err, addresses) => {
 if (err) throw err;
 console.log(`NS记录: ${JSON.stringify(addresses)}`);
});

dns.resolvePtr(hostname, callback)

说明:

使用DNS协议处理主机名引用记录(PTR记录)。
addresses参数将一个字符串数组传递给回调函数callback,其中包含回复记录。

demo:

const dns = require('dns');
dns.resolvePtr('www.taobao.com', (err, addresses) => {
 if (err) throw err;
 
 console.log(`PTR记录: ${JSON.stringify(addresses)}`);
});

dns.resolveSoa(hostname, callback)

说明:

使用DNS协议处理主机名子域名记录(SOA记录)。addresses参数为一个对象包含以下属性:
nsname
hostmaster
serial
refresh
retry
expire
minttl

demo:

const dns = require('dns');
dns.resolveSoa('www.taobao.com', (err, addresses) => {
 if (err) throw err;
 
 console.log(`SOA记录: ${JSON.stringify(addresses)}`);
});

dns.resolveSrv(hostname, callback)

说明:

使用DNS协议来处理主机名服务记录(SRV记录)。
callback函数返回的addresses参数为对象数组,每个对象包含以下属性:
priority
weight
port
name

demo:

const dns = require('dns');
dns.resolveSrv('www.taobao.com', (err, addresses) => {
 if (err) throw err;
 console.log(`SRV记录: ${JSON.stringify(addresses)}`);
});

dns.resolveTxt(hostname, callback)

说明:

使用DNS协议处理文本查询主机名(TXT记录)。回调函数callback会返回records参数,
它是一个文本记录与主机名一一对应的二维数组(例如:[ [‘v=spf1 ip4:0.0.0.0 ‘, ‘~all' ] ]).
每个数组文本块包含一条记录。根据用例,这些可以是连接在一起或单独对待。

demo:

const dns = require('dns');
dns.resolveTxt('www.taobao.com', (err, addresses) => {
 if (err) throw err;
 
 console.log(`TXT记录: ${JSON.stringify(addresses)}`);
});

dns.resolveAny(hostname, callback)

说明:

使用DNS协议解析所有记录。
callback函数的参数将是一个包含各种类型记录的数组。每个对象都有一个属性type,指示当前记录的类型。
“A”、”AAAA”、”CNAME”、”MX”、”NAPTR”、”NS”、”PTR”、”SOA”、”SRV”、”TXT”等

demo:

const dns = require('dns');
dns.resolveAny('www.taobao.com', (err, addresses) => {
 if (err) throw err;
 console.log(`${JSON.stringify(addresses)}`);
});
// [ { type: 'A', address: '127.0.0.1', ttl: 299 },
//  { type: 'CNAME', value: 'example.com' },
//  { type: 'MX', exchange: 'alt4.aspmx.l.example.com', priority: 50 },
//  { type: 'NS', value: 'ns1.example.com' },
//  { type: 'TXT', entries: [ 'v=spf1 include:_spf.example.com ~all' ] },
//  { type: 'SOA',
//   nsname: 'ns1.example.com',
//   hostmaster: 'admin.example.com',
//   serial: 156696742,
//   refresh: 900,
//   retry: 900,
//   expire: 1800,
//   minttl: 60 } ]

错误码

说明:

每个DNS查询可以返回一个错误代码如下:
dns.NODATA:DNS服务返回没有数据。
dns.FORMERR:DNS服务器查询没有格式化。
dns.SERVFAIL:DNS服务器返回失败。
dns.NOTFOUND:域名未找到。
dns.NOIMP:DNS服务器不执行请求的操作。
dns.REFUSED:查询DNS服务器拒绝。
dns.BADQUERY:未格式化DNS查询。
dns.BADNAME:未格式化主机名
dns.BADFAMILY:没有提供地址族
dns.BADRESP:未格式化DNS回复
dns.CONNREFUSED:无法连接DNS服务器
dns.TIMEOUT:连接DNS服务器超时
dns.EOF:文件末尾
dns.FILE:读取文件错误
dns.NOMEM:内存溢出
dns.DESTRUCTION:通道以及销毁
dns.BADSTR:未格式化字符串
dns.BADFLAGS:指定非法标记
dns.NONAME:给定的主机名不是数字。
dns.BADHINTS:指定非法的提示标志。
dns.NOTINITIALIZED:c-ares异步DNS请求库初始化未完成。
dns.LOADIPHLPAPI:加载iphlpapi.dll(Windows IP辅助API应用程序接口模块)错误
dns.ADDRGETNETWORKPARAMS:找不到GetNetworkParams(读取本机DNS信息)函数
dns.CANCELLED:DNS查询取消

dns.lookup() 与 dns.resolve(), dns.resolve*() and dns.reverse()

说明:

在底层,dns.lookup()使用操作系统设施与大多数其他程序相同。
例如,dns.lookup()几乎总是解析给定的主机名与ping命令一样。
在许多类POSIX操作系统中, dns.lookup()函数的行为可以通过改变nsswitch.conf(5)并且/或resolv.conf(5)设置进行改变,
但是需要注意改变这些文件就意味着改变所有正在这个操作系统中运行 的所有进程的行为。
尽管以异步JavaScript的角度来调用dns.lookup(),但在内部libuv底层线程池中却是同步的调用getaddrinfo(3)
dns.resolve(), dns.resolve*() and dns.reverse()这些功能实现与dns.lookup()截然不同。
它们不仅没有使用getaddrinfo(3)并且通过网络执行DNS查询。使用异步网络通信,并且没有使用libuv线程池。
因此,这些函数不会像使用libuv线程池的dns.lookup()函数一样会对其它进程有负面影响。
它们不像dns.lookup()一样使用相同的配置文件。例如,它们不会使用来自/etc/hosts配置。

希望本文所述对大家node.js程序设计有所帮助。

Javascript 相关文章推荐
js prototype截取字符串函数
Apr 01 Javascript
Extjs Gird 支持中文拼音排序实现代码
Apr 15 Javascript
jquery 日期控件datepicker属性详细解析
Nov 08 Javascript
javascript实现数组内值索引随机化及创建随机数组的方法
Aug 10 Javascript
深入理解JavaScript中Ajax
Aug 02 Javascript
AngularJS中directive指令使用之事件绑定与指令交互用法示例
Nov 22 Javascript
EditPlus 正则表达式 实战(3)
Dec 15 Javascript
jQuery实现的手风琴侧边菜单效果
Mar 29 jQuery
AngularJS全局警告框实现方法示例
May 18 Javascript
最常用的jQuery表单验证(简单)
May 23 jQuery
基于vue组件实现猜数字游戏
May 28 Javascript
全面介绍vue 全家桶和项目实例
Dec 27 Javascript
关于vue3默认把所有onSomething当作v-on事件绑定的思考
May 15 #Javascript
js实现简单贪吃蛇游戏
May 15 #Javascript
Javascript执行流程细节原理解析
May 14 #Javascript
使用npm命令提示: 'npm' 不是内部或外部命令,也不是可运行的程序的处理方法
May 14 #Javascript
javascript中的offsetWidth、clientWidth、innerWidth及相关属性方法
May 14 #Javascript
vue组件系列之TagsInput详解
May 14 #Javascript
ant-design-vue按需加载的坑的解决
May 14 #Javascript
You might like
Uchome1.2 1.5 代码学习 common.php
2009/04/24 PHP
CodeIgniter生成网站sitemap地图的方法
2013/11/13 PHP
CodeIgniter配置之config.php用法实例分析
2016/01/19 PHP
laravel实现登录时监听事件,添加登录用户的记录方法
2019/09/30 PHP
js 深拷贝函数
2008/12/04 Javascript
js禁止document element对象选中文本实现代码
2013/03/21 Javascript
Jquery Post处理后不进入回调的原因及解决方法
2014/07/15 Javascript
javascript实现简单的进度条
2015/07/02 Javascript
Javascript的表单验证-初识正则表达式
2016/03/18 Javascript
学习使用bootstrap基本控件(table、form、button)
2016/04/12 Javascript
JS代码实现table数据分页效果
2016/05/26 Javascript
JS实现发送短信验证后按钮倒计时功能(防止刷新倒计时失效)
2017/07/07 Javascript
webpack 模块热替换原理
2018/04/09 Javascript
Mint-UI时间组件起始时间问题及时间插件使用
2018/08/20 Javascript
js使用formData实现批量上传
2020/03/27 Javascript
Javascript异步执行不按顺序解决方案
2020/04/30 Javascript
获取python文件扩展名和文件名方法
2018/02/02 Python
python3使用QQ邮箱发送邮件
2020/05/20 Python
Python微信操控itchat的方法
2019/05/31 Python
Flask项目中实现短信验证码和邮箱验证码功能
2019/12/05 Python
Matplotlib自定义坐标轴刻度的实现示例
2020/06/18 Python
Python字符串三种格式化输出
2020/09/17 Python
scrapy结合selenium解析动态页面的实现
2020/09/28 Python
详解numpy.ndarray.reshape()函数的参数问题
2020/10/13 Python
如何用Python 实现全连接神经网络(Multi-layer Perceptron)
2020/10/15 Python
利用python爬取有道词典的方法
2020/12/08 Python
css3进阶之less实现星空动画的示例代码
2019/09/10 HTML / CSS
HTML5本地存储之Database Storage应用介绍
2013/01/06 HTML / CSS
应聘美工求职信
2013/11/07 职场文书
遥感技术与仪器求职信
2014/02/22 职场文书
2014最新版群众路线四风整改措施
2014/09/24 职场文书
2014最新党员批评与自我批评材料
2014/09/24 职场文书
邀请函样本
2015/02/02 职场文书
学习保证书100字
2015/02/26 职场文书
Redis6.0搭建集群Redis-cluster的方法
2021/05/08 Redis
Nginx进程调度问题详解
2021/09/25 Servers