Node.js v10.8.0 文档

dns (域名服务器)#

dns 模块包含两类函数：

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

例子，查找 iana.org：

const dns = require('dns');

dns.lookup('iana.org', (err, address, family) => {
  console.log('IP 地址: %j 地址族: IPv%s', address, family);
});
// IP 地址: "192.0.43.8" 地址族: IPv4

2) 第二类函数，连接到一个真实的 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)}`);
    });
  });
});

两类函数有微妙的差别，详见实现上的注意事项。

Version	变更
v1.2.0	The `all` option is supported now.
v0.1.90	新增于: v0.1.90

`rrtype`	`records` contains	Result type	Shorthand method
`'A'`	IPv4 addresses (default)	<string>	`dns.resolve4()`
`'AAAA'`	IPv6 addresses	<string>	`dns.resolve6()`
`'CNAME'`	canonical name records	<string>	`dns.resolveCname()`
`'MX'`	mail exchange records	<Object>	`dns.resolveMx()`
`'NAPTR'`	name authority pointer records	<Object>	`dns.resolveNaptr()`
`'NS'`	name server records	<string>	`dns.resolveNs()`
`'PTR'`	pointer records	<string>	`dns.resolvePtr()`
`'SOA'`	start of authority records	<Object>	`dns.resolveSoa()`
`'SRV'`	service records	<Object>	`dns.resolveSrv()`
`'TXT'`	text records	<string[]>	`dns.resolveTxt()`
`'ANY'`	any records	<Object>	`dns.resolveAny()`

Version	变更
v7.2.0	This method now supports passing `options`, specifically `options.ttl`.
v0.1.16	新增于: v0.1.16

Type	Properties
`'A'`	`address`/`ttl`
`'AAAA'`	`address`/`ttl`
`'CNAME'`	`value`
`'MX'`	Refer to `dns.resolveMx()`
`'NAPTR'`	Refer to `dns.resolveNaptr()`
`'NS'`	`value`
`'PTR'`	`value`
`'SOA'`	Refer to `dns.resolveSoa()`
`'SRV'`	Refer to `dns.resolveSrv()`
`'TXT'`	This type of record contains an array property called `entries` which refers to `dns.resolveTxt()`, e.g. `{ entries: ['...'], type: 'TXT' }`

目录

dns (域名服务器)#

Class: dns.Resolver#

resolver.cancel()#

dns.getServers()#

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

Supported getaddrinfo flags#

dns.lookupService(address, port, callback)#

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

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

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

dns.resolveAny(hostname, callback)#

dns.resolveCname(hostname, callback)#

dns.resolveMx(hostname, callback)#

dns.resolveNaptr(hostname, callback)#

dns.resolveNs(hostname, callback)#

dns.resolvePtr(hostname, callback)#

dns.resolveSoa(hostname, callback)#

dns.resolveSrv(hostname, callback)#

dns.resolveTxt(hostname, callback)#

dns.reverse(ip, callback)#

dns.setServers(servers)#

DNS Promises API#

Class: dnsPromises.Resolver#

dnsPromises.getServers()#

dnsPromises.lookup(hostname[, options])#

dnsPromises.lookupService(address, port)#

dnsPromises.resolve(hostname[, rrtype])#

dnsPromises.resolve4(hostname[, options])#

dnsPromises.resolve6(hostname[, options])#

dnsPromises.resolveAny(hostname)#

dnsPromises.resolveCname(hostname)#

dnsPromises.resolveMx(hostname)#

dnsPromises.resolveNaptr(hostname)#

dnsPromises.resolveNs(hostname)#

dnsPromises.resolvePtr(hostname)#

dnsPromises.resolveSoa(hostname)#

dnsPromises.resolveSrv(hostname)#

dnsPromises.resolveTxt(hostname)#

dnsPromises.reverse(ip)#

dnsPromises.setServers(servers)#

错误码#

实现上的注意事项#

dns.lookup()#

`dns.resolve()`, `dns.resolve*()` and `dns.reverse()`#

`dns.lookup()`#