INTEGRITY Документация

DNS через Discord

Бот DNS over Discord для 1.1.1.1 позволяет выполнять DNS-запросы и запросы WHOIS прямо в Discord. Это удобно, когда вы вместе с коллегами разбираетесь с проблемами DNS или хотите быстро проверить запись, не переключаясь на терминал.

Пригласите бота на свой сервер Discord ↗, чтобы сделать её доступной в каналах этого сервера, либо добавить бота в свой аккаунт Discord ↗, чтобы использовать её в любом месте Discord.

Выполнение DNS-запросов

Как только бот окажется на вашем сервере, введите /dig, чтобы начать выполнять DNS-запросы. Discord покажет форму слэш-команды, в которой нужно указать домен для поиска, необязательный тип записи DNS и необязательный флаг для краткого результата.

DNS-запрос обращается к системе доменных имён, чтобы получить записи, связанные с доменом (например, IP-адреса, на которые указывает домен, или используемые им почтовые серверы).

Если для команды указан только домен, бот по умолчанию ищет A-записи (которые сопоставляют домен с одним или несколькими IPv4-адресами) и возвращает результат в полном формате, а не в кратком.

Пример:

/dig domain: cloudflare.com

Поддерживаемые типы записей

В Discord действует ограничение в 25 вариантов для слэш-команд, поэтому DNS через Discord предлагает на выбор 25 самых распространённых типов DNS-записей.

Поддерживаемые типы записей DNS

Чтобы запросить другие типы записей DNS или несколько типов сразу, используйте /multi-dig команда.

Краткая форма ответа

/dig команда имеет необязательный флаг для запроса краткой формы ответа.

При запросе ответа в краткой форме столбцы имени и TTL (time to live, то есть время хранения записи в кэше) исключаются. Команда возвращает только данные записи без форматирования, аналогично соответствующей dig ответ интерфейса командной строки.

Пример:

/dig domain: cloudflare.com type: AAAA records short: True

Отключение проверки DNSSEC

DNSSEC (Domain Name System Security Extensions) подтверждает, что DNS-ответы не были подделаны. Отключить эту проверку можно в /dig команду, передав cdflag в значение true, что полезно при диагностике доменов с неверно настроенным DNSSEC, когда ошибки проверки не позволяют отобразить корректные записи.

Пример:

/dig domain: cloudflare.com type: AAAA records cdflag: True

Обновление существующих результатов

Вы можете обновить результаты DNS-запроса, нажав кнопку Refresh. При нажатии бот повторно выполнит DNS-запрос, указанный в сообщении, и обновит результаты в этом сообщении. Нажать эту кнопку может любой пользователь.

Кнопка обновления доступна во всех ответах на /dig команды, включая те, что завершились ошибкой, например из-за неизвестного домена или отсутствия найденных записей.

Смена DNS-провайдера

По умолчанию бот DNS over Discord использует DNS-сервис Cloudflare 1.1.1.1. Чтобы сравнить результаты разных провайдеров (например, чтобы проверить, связана ли проблема с распространением DNS-записей с конкретным провайдером), выберите другого провайдера в раскрывающемся списке под результатом. Результаты в сообщении обновятся с учётом выбранного провайдера. Изменить DNS-провайдера может любой пользователь.

multi-dig команда

Если вы хотите одновременно найти несколько типов DNS-записей, используйте /multi-dig команда. Она позволяет указать любой поддерживаемый тип DNS-записи, а также несколько типов через пробел.

Пример:

/multi-dig domain: cloudflare.com types: A AAAA

Поддерживаемые типы записей

В отличие от /dig, /multi-dig команда не показывает меню автозаполнения для типов записей. Список типов DNS-записей для поиска указывается через пробел.

Если вы укажете недопустимый тип записи, бот проигнорирует его без сообщения об ошибке. Поэтому, если результаты кажутся неполными, проверьте список типов на опечатки. Если ни один допустимый тип не указан, бот по умолчанию использует A записи.

Типы DNS-записей, поддерживаемые ботом и считающиеся допустимыми

Используйте * (звёздочку) вместо типа записи, чтобы получить DNS-результаты по всем поддерживаемым типам.

Краткая форма ответа

Как и основной /dig команды, /multi-dig команда также поддерживает необязательный флаг short после указания типов в слэш-команде.

Пример:

/multi-dig domain: cloudflare.com types: CDS CDNSKEY short: True

Отключение проверки DNSSEC

Как и в случае с dig команды можно отключить проверку DNSSEC, передав cdflag в значение true. В этом случае DNS-записи будут возвращены, даже если проверка DNSSEC не пройдена.

Пример:

/multi-dig domain: cloudflare.com type: AAAA records cdflag: True

Обновление существующих результатов

/multi-dig команда также добавляет кнопку обновления под каждым набором запрошенных DNS-результатов (или после каждого блока из 10 типов записей, если вы запросили больше 10).

Как и в случае с /dig команды любой пользователь может нажать кнопку обновления, чтобы обновить отображаемые DNS-результаты, в том числе для запросов, которые ранее завершились ошибкой.

Смена DNS-провайдера

Как и /dig команды можно изменить DNS-провайдера при использовании /multi-dig команда. Меню появляется после каждого набора DNS-результатов (или после каждого блока результатов, если запрошено больше 10 типов записей).

Этим меню может воспользоваться любой пользователь, чтобы изменить провайдера DNS, используемого для запроса.

whois команда

/whois команда выполняет в Discord RDAP/WHOIS-запрос для указанного домена, IP-адреса или ASN (Autonomous System Number, уникальный идентификатор, присваиваемый сети). WHOIS возвращает сведения о регистрации и владельце, например кем и когда был зарегистрирован домен и когда истекает срок регистрации.

Примеры:

/whois query: cloudflare.com
/whois query: 104.16.132.229
/whois query: 2606:4700::6810:84e5
/whois query: 13335

Другие команды

У бота также есть набор вспомогательных команд, которые показывают дополнительную информацию о нём и быстрые ссылки.

help команда

/help команда предоставляет прямо в Discord документацию по всем командам бота 1.1.1.1 DNS over Discord.

Пример:

/help

privacy команда

/privacy команда показывает уведомление о политике конфиденциальности для использования бота 1.1.1.1 DNS over Discord. Вы также можете см. страницу «Политика конфиденциальности» ↗, чтобы получить к нему доступ.

Пример:

/privacy

terms команда

/terms команда показывает уведомление об условиях использования бота 1.1.1.1 DNS over Discord. Вы также можете см. страницу «Условия использования» ↗, чтобы получить к нему доступ.

Пример:

/terms

github команда

Бот DNS over Discord имеет открытый исходный код, а /github команда предоставляет быструю ссылку на репозиторий GitHub. Репозиторий GitHub доступен по адресу https://github.com/MattIPv4/DNS-over-Discord/ ↗.

Пример:

/github

invite команда

/invite команда предоставляет пользователю быструю ссылку для приглашения бота 1.1.1.1 DNS over Discord на другой сервер Discord или для добавления его в учётную запись Discord. Пригласить бота можно в любой момент с помощью https://cfl.re/3nM6VfQ ↗. Этого бота также можно добавить в аккаунты с https://dns-over-discord.v4.wtf/invite/user ↗.

/invite

Разработка

Бот DNS over Discord развёрнут на Cloudflare Workers ↗.

Исходный код бота, а также информацию о том, как начать участвовать в проекте, можно найти на GitHub по адресу https://github.com/MattIPv4/DNS-over-Discord/ ↗.