Модуль dns Node.js

Java FileВстроенные модули Node.js


Node.jsdnsмодуль — это основной модуль для запросов к системе доменных имён (DNS). DNS (Domain Name System) — это система, которая преобразует читаемые человеком доменные имена (такие какwww.example.com) в машиночитаемые IP-адреса (такие как192.0.2.1).

Зачем нужен модуль dns

В сетевом взаимодействии компьютеры фактически идентифицируют друг друга по IP-адресам, но людям легче запоминать доменные имена, чем числовые IP-адреса.dnsМодуль предоставляет возможность выполнять разрешение доменных имён в приложениях Node.js, позволяя разработчикам:

  • Разрешать доменные имена в IP-адреса
  • Выполнять обратное разрешение IP-адресов в доменные имена
  • Запрашивать DNS-записи (MX, TXT, SRV и т. д.)

Основы использования модуля dns

Импорт модуля dns

Чтобы использоватьdnsмодуль, сначала нужно импортировать его:

const dns = require('dns');

Основные методы разрешения

dnsМодуль предоставляет несколько методов разрешения. Наиболее часто используетсяlookupиresolve。

dns.lookup()

dns.lookup()является самым простым методом разрешения доменных имён. Он использует функциональность, предоставляемую операционной системой, для выполнения DNS-запросов:

Пример

dns.lookup('example.com', (err, address, семейство) => {
  if (err) throw err;
  console.log(`address: ${address},версия IP: IPv${family}`);
});

dns.resolve()

dns.resolve()обеспечивает более тонкий контроль и позволяет запрашивать определённые типы DNS-записей:

Пример

dns.resolve('example.com', 'A', (err, addresses) => {
  if (err) throw err;
  console.log(`A-запись: ${JSON.stringify(addresses)}`);
});

Основные методы модуля dns

Прямое разрешение

Прямое разрешение — это процесс преобразования доменного имени в IP-адрес:

Пример

dns.resolve4('google.com', (err, addresses) => {
  if (err) throw err;
  console.log(`IPv4-адрес: ${addresses}`);
});

dns.resolve6('google.com', (err, addresses) => {
  if (err) throw err;
  console.log(`IPv6-адрес: ${addresses}`);
});

Обратное разрешение

Обратное разрешение — это процесс преобразования IP-адреса в доменное имя:

Пример

dns.reverse('8.8.8.8', (err, hostnames) => {
  if (err) throw err;
  console.log(`Результат обратного разрешения: ${hostnames}`);
});

Запрос других DNS-записей

dnsМодуль также поддерживает запросы других типов DNS-записей:

Пример

// MX-запись (запись обмена почтой)
dns.resolveMx('google.com', (err, addresses) => {
  if (err) throw err;
  console.log(`MX-запись: ${JSON.stringify(addresses)}`);
});

// TXT-запись (текстовая запись)
dns.resolveTxt('google.com', (err, records) => {
  if (err) throw err;
  console.log(`TXT-запись: ${JSON.stringify(records)}`);
});

Синхронные и асинхронные методы

Асинхронные методы

По умолчанию,dnsМетоды модуля асинхронны и используют функции обратного вызова для обработки результатов:

Пример

dns.lookup('nodejs.org', (err, address, семейство) => {
  console.log('Асинхронный результат:', address);
});

Версия с Promise

Начиная с Node.js v10.6.0,dnsМетоды модуля также предоставляют версии на основе Promise:

Пример

const { promises: dnsPromises } = require('dns');

async function lookupExample() {
  try {
    const result = await dnsPromises.lookup('nodejs.org');
    console.log('Promise result:', result.address);
  } catch (err) {
    console.error(err);
  }
}

lookupExample();

Обработка ошибок

DNS-запросы могут завершаться ошибкой, поэтому очень важно правильно обрабатывать ошибки:

Пример

dns.lookup('nonexistent.example.com', (err, address) => {
  if (err) {
    if (err.code === 'ENOTFOUND') {
      console.log('Domain does not exist');
    } else {
      console.log('Неизвестная ошибка:', err);
    }
    return;
  }
  console.log('Адрес:', address);
});

Распространённые коды ошибок DNS включают:

  • ENOTFOUND: домен не существует
  • ESERVFAIL: DNS-сервер вернул ошибку
  • ETIMEOUT: время ожидания DNS-запроса истекло

Практические примеры применения

Проверьте, можно ли разрешить домен

Пример

function isDomainResolvable(domain) {
  return new Promise((resolve) => {
    dns.lookup(domain, (err) => {
      resolve(!err);
    });
  });
}

isDomainResolvable('google.com').then(result => {
  console.log('Домен разрешается:', result);
});

Пакетное разрешение доменных имён

Пример

const domains = ['google.com', 'facebook.com', 'twitter.com'];

Promise.all(domains.map(domain => dnsPromises.lookup(domain)))
  .then(results => {
    results.forEach((result, index) => {
      console.log(`${domains[index]} => ${result.address}`);
    });
  })
  .catch(err => {
    console.error('Ошибка разрешения:', err);
  });

Вопросы производительности

DNS-запросы — это операции ввода-вывода и могут влиять на производительность приложения:

  1. Кэширование результатов: Для часто запрашиваемых доменов рассмотрите кэширование результатов на уровне приложения
  2. Ограничения параллелизма: Избегайте выполнения большого количества DNS-запросов одновременно
  3. Настройки тайм-аута: Установите разумный тайм-аут для DNS-запросов

Пример

const cache = new Map();

async function cachedLookup(domain) {
  if (cache.has(domain)) {
    return cache.get(domain);
  }
 
  const result = await dnsPromises.lookup(domain);
  cache.set(domain, result);
  return result;
}


Метод

МетодОписаниеПример
dns.lookup(hostname[, options], callback)Разрешает имя хоста в первый адрес IPv4 или IPv6. Необязательный параметрoptionsиспользуется для указания метода разрешения, напримерfamily(4 или 6).dns.lookup('example.com', (err, address) => {});
dns.resolve(hostname[, rrtype], callback)Запрашивает DNS-записи указанного типа, по умолчанию возвращая записи A. Поддерживаемые типы включают A, AAAA, MX, TXT и т. д.dns.resolve('example.com', 'MX', (err, addresses) => {});
dns.resolve4(hostname, callback)Запрашивает IPv4-адреса имени хоста.dns.resolve4('example.com', (err, addresses) => {});
dns.resolve6(hostname, callback)Запрашивает IPv6-адреса имени хоста.dns.resolve6('example.com', (err, addresses) => {});
dns.resolveMx(hostname, callback)Запрашивает MX-записи (записи почтового обмена) имени хоста.dns.resolveMx('example.com', (err, addresses) => {});
dns.resolveTxt(hostname, callback)Запрашивает записи TXT (текстовые) для имени хоста.dns.resolveTxt('example.com', (err, records) => {});
dns.reverse(ip, callback)Преобразует IP-адрес в имя хоста.dns.reverse('8.8.8.8', (err, hostnames) => {});
dns.getServers()Возвращает массив текущих DNS-серверов.console.log(dns.getServers());
dns.setServers(servers)Задаёт пользовательский массив DNS-серверов.dns.setServers(['8.8.8.8', '8.8.4.4']);

rrtypes

Ниже перечислены допустимые значения rrtypes в методе dns.resolve():

  • 'A'IPv4-адрес, по умолчанию
  • 'AAAA'IPv6-адрес
  • 'MX'Записи почтового обмена
  • 'TXT'текстовые записи
  • 'SRV'записи SRV
  • 'PTR'Используется для обратного поиска IP-адреса.
  • 'NS'Записи сервера доменных имён
  • 'CNAME'Записи псевдонимов
  • 'SOA'Начальное значение авторитетной записи

Коды ошибок

Каждый DNS-запрос может возвращать следующие коды ошибок:

  • dns.NODATA: Нет данных в ответе.
  • dns.FORMERR: Ошибка формата запроса.
  • dns.SERVFAIL: Общий сбой.
  • dns.NOTFOUND: Доменное имя не найдено.
  • dns.NOTIMP: Запрошенная операция не реализована.
  • dns.REFUSED: Запрос отклонён.
  • dns.BADQUERY: Ошибка формата запроса.
  • dns.BADNAME: Ошибка формата доменного имени.
  • dns.BADFAMILY: Протокол адреса не поддерживается.
  • dns.BADRESP: Ошибка формата ответа.
  • dns.CONNREFUSED: Не удалось подключиться к DNS-серверу.
  • dns.TIMEOUT: Тайм-аут подключения к DNS-серверу.
  • dns.EOF: Конец файла.
  • dns.FILE: Ошибка чтения файла.
  • dns.NOMEM: Переполнение памяти.
  • dns.DESTRUCTION: Канал уничтожен.
  • dns.BADSTR: Ошибка формата строки.
  • dns.BADFLAGS: Недопустимый идентификатор.
  • dns.NONAME: Указанный хост не является числовым.
  • dns.BADHINTS: Недопустимый идентификатор HINTS.
  • dns.NOTINITIALIZED: Библиотека c-ares не инициализирована.
  • dns.LOADIPHLPAPI: Ошибка загрузки iphlpapi.dll.
  • dns.ADDRGETNETWORKPARAMS: Не удалось найти функцию GetNetworkParams.
  • dns.CANCELLED: DNS-запрос отменен.

Пример

Ниже приведены некоторые примеры распространенных методов модуля dns, показывающие, как запросить IP-адрес узла, получить записи DNS и т. д.

1. Используйте dns.lookup() для получения IP-адреса

Пример

const dns = require('dns');

// Поиск IPv4-адреса домена
dns.lookup('example.com', (err, address, семейство) => {
  if (err) throw err;
  console.log(`IP-адрес: ${address},Семейство адресов: IPv${family}`);
});

dns.lookup() — это упрощенный интерфейс, который находит первый IPv4- или IPv6-адрес для указанного имени хоста.

2. Используйте dns.resolve() для запроса различных типов записей DNS

Пример

const dns = require('dns');

// Запрос записей MX
dns.resolve('example.com', 'MX', (err, addresses) => {
  if (err) throw err;
  console.log('MX-записи:', addresses);
});

// Запрос TXT-записей
dns.resolve('example.com', 'TXT', (err, records) => {
  if (err) throw err;
  console.log('TXT-записи:', records);
});

Используя dns.resolve(), можно указать типы записей (например, MX, TXT и т. д.) для запроса различных DNS-записей.

3. Используйте dns.reverse() для обратного DNS-запроса

Пример

const dns = require('dns');

// Обратное разрешение IP-адреса в имя хоста
dns.reverse('8.8.8.8', (err, hostnames) => {
  if (err) throw err;
  console.log(Имя хоста для `8.8.8.8: ${hostnames}`);
});

Обратное разрешение преобразует IP-адрес в доменное имя и часто используется для проверки соответствия между доменным именем и IP-адресом.

4. Получение и установка DNS-серверов

Пример

const dns = require('dns');

// Получить текущий список DNS-серверов
console.log('Текущие DNS-серверы:', dns.getServers());

// Задать пользовательский DNS-сервер
dns.setServers(['1.1.1.1', '8.8.8.8']);
console.log('Новый DNS-сервер:', dns.getServers());

С помощью dns.getServers() можно получить список DNS-серверов, настроенных в системе в данный момент. dns.setServers() позволяет задать пользовательские DNS-серверы, чтобы для запросов можно было использовать определённые службы разрешения DNS.

Асинхронные и синхронные методы

  • Асинхронные методы: например,dns.lookup()、dns.resolve()и т. д., неблокирующие, подходят для параллельных задач.
  • Синхронные методы: например,dns.lookupSync()、dns.resolve4Sync(), блокирующие, подходят для небольших объёмов, избегайте использования в сценариях с высокой конкурентностью.

Практические сценарии применения

  • Разрешение доменных имён для веб-приложений: запрос IP-адреса доменного имени на сервере для получения веб-страниц или ресурсов.
  • Проверка конфигурации почтового сервера: проверка корректности конфигурации почтового сервера с помощью MX-записей.
  • Антиспам: С помощью обратного DNS-запроса проверяется, соответствует ли сервер, отправляющий электронные письма, доменному имени, тем самым определяется источник спама.
  • Балансировка нагрузки: Путём разрешения различных IP-адресов доменного имени создайте схему балансировки нагрузки для распределения трафика между несколькими серверами.

dnsМодуль позволяет приложениям Node.js выполнять разрешение доменных имён и DNS-запросы, давая им больше гибкости при работе с сетевыми коммуникациями. Благодаря асинхронным интерфейсам DNS-запросы можно эффективно выполнять без блокировки основного потока.

Java FileВстроенные модули Node.js

Другие расширения