Модуль dns 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модуль, сначала нужно импортировать его:
Основные методы разрешения
dnsМодуль предоставляет несколько методов разрешения. Наиболее часто используетсяlookupиresolve。
dns.lookup()
dns.lookup()является самым простым методом разрешения доменных имён. Он использует функциональность, предоставляемую операционной системой, для выполнения DNS-запросов:
Пример
if (err) throw err;
console.log(`address: ${address},версия IP: IPv${family}`);
});
dns.resolve()
dns.resolve()обеспечивает более тонкий контроль и позволяет запрашивать определённые типы DNS-записей:
Пример
if (err) throw err;
console.log(`A-запись: ${JSON.stringify(addresses)}`);
});
Основные методы модуля dns
Прямое разрешение
Прямое разрешение — это процесс преобразования доменного имени в IP-адрес:
Пример
if (err) throw err;
console.log(`IPv4-адрес: ${addresses}`);
});
dns.resolve6('google.com', (err, addresses) => {
if (err) throw err;
console.log(`IPv6-адрес: ${addresses}`);
});
Обратное разрешение
Обратное разрешение — это процесс преобразования IP-адреса в доменное имя:
Пример
if (err) throw err;
console.log(`Результат обратного разрешения: ${hostnames}`);
});
Запрос других DNS-записей
dnsМодуль также поддерживает запросы других типов DNS-записей:
Пример
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Методы модуля асинхронны и используют функции обратного вызова для обработки результатов:
Пример
console.log('Асинхронный результат:', address);
});
Версия с Promise
Начиная с Node.js v10.6.0,dnsМетоды модуля также предоставляют версии на основе Promise:
Пример
async function lookupExample() {
try {
const result = await dnsPromises.lookup('nodejs.org');
console.log('Promise result:', result.address);
} catch (err) {
console.error(err);
}
}
lookupExample();
Обработка ошибок
DNS-запросы могут завершаться ошибкой, поэтому очень важно правильно обрабатывать ошибки:
Пример
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-запроса истекло
Практические примеры применения
Проверьте, можно ли разрешить домен
Пример
return new Promise((resolve) => {
dns.lookup(domain, (err) => {
resolve(!err);
});
});
}
isDomainResolvable('google.com').then(result => {
console.log('Домен разрешается:', result);
});
Пакетное разрешение доменных имён
Пример
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-запросы — это операции ввода-вывода и могут влиять на производительность приложения:
- Кэширование результатов: Для часто запрашиваемых доменов рассмотрите кэширование результатов на уровне приложения
- Ограничения параллелизма: Избегайте выполнения большого количества DNS-запросов одновременно
- Настройки тайм-аута: Установите разумный тайм-аут для DNS-запросов
Пример
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-адреса
Пример
// Поиск 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
Пример
// Запрос записей 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-запроса
Пример
// Обратное разрешение IP-адреса в имя хоста
dns.reverse('8.8.8.8', (err, hostnames) => {
if (err) throw err;
console.log(Имя хоста для `8.8.8.8: ${hostnames}`);
});
Обратное разрешение преобразует IP-адрес в доменное имя и часто используется для проверки соответствия между доменным именем и IP-адресом.
4. Получение и установка 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-запросы можно эффективно выполнять без блокировки основного потока.
Встроенные модули Node.js