📱 Руководство пользователя DomainMapper Bot

🚀 Добро пожаловать в DomainMapper!

DomainMapper — это умный Telegram-бот для анализа доменов, поиска поддоменов, объединения IP-адресов в подсети и анализа сетевого трафика (PCAP). Бот поможет вам быстро получить полную карту нужных сайтов и структурировать данные в удобном для роутера Keenetic формате.

🎯 Начало работы

Первый запуск

1. Нажмите "Старт" или отправьте команду /start
2. Прочитайте и примите пользовательское соглашение
3. Оплатите подписку
4. Готово! Теперь вы можете пользоваться всеми функциями бота

Пользовательское соглашение

При первом запуске бот попросит принять пользовательское соглашение. Это обязательный шаг для начала работы с ботом.

Команды для работы с соглашением:

• /terms — просмотр пользовательского соглашения
• После прочтения нажмите кнопку "Принять соглашение" 

⚡ Основные функции

🔍 Поиск поддоменов

Находит связанные поддомены для указанного домена несколькими способами:

• База данных сертификатов (crt.sh)
• Брутфорс по ~40 стандартным префиксам (www, api, cdn и др.)
• DNS-верификация каждого найденного кандидата

🌐 DNS-резолвинг доменов

Бот автоматически выполняет 3 прогона DNS-резолвинга для каждого домена с паузой между ними. Домен считается успешно обработанным, если он резолвится хотя бы в одном из трёх прогонов. Запускать резолвинг вручную несколько раз для надёжности больше не требуется — бот делает это сам.

📊 Объединение в подсети

Автоматически группирует найденные IP-адреса в подсети с использованием CIDR-нотации для удобства настройки роутинга.

🎯 Поддержка платформ

Готовые наборы доменов для популярных сервисов: Adobe, Apple, Discord, GitHub Copilot, Google, GPT's, JetBrains, Netflix, PlayStation, Telegram, Trackers, Twitch, Twitter, WhatsApp, Xbox, YouTube.

Важно: в роутеры Keenetic помещается не более 1024 маршрутов. Выбирая платформы по кнопкам, учтите: в них собраны все возможные адреса, которых может быть больше 1024. С учётом опроса нескольких DNS-серверов итоговый файл может содержать в несколько раз больше маршрутов, чем адресов, так как разные DNS-сервера могут отдавать разные IP для одного и того же домена.

Самый надёжный способ — собрать нужные именно вам адреса через DevTools браузера (клик правой кнопкой мыши по любому запросу → "Копировать все URL's"). Это сократит количество маршрутов в разы, и вы получите только то, что реально нужно.

🌐 Выбор DNS-сервера

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

• AdGuard
• Cisco
• Cloudflare
• Comodo
• Google
• Quad9
• Yandex
• Все серверы — параллельный опрос всех 7 серверов сразу

Совет: выбирайте DNS-сервер, совпадающий с настройками вашего роутера — так маршруты будут максимально точными.

📦 Форматы результата

• .txt — список команд route ADD <IP> MASK <mask> 0.0.0.0 для Keenetic
• .bat — то же самое, что txt, просто другой формат

📼 PCAP-анализ

Загрузите один или несколько файлов .pcap/.pcapng (суммарно до 500 МБ) — бот извлечёт из них домены. Доступны два режима:

• Посмотреть адреса — просто список доменов, найденных в трафике
• Резолвинг — полный цикл DNS-резолвинга найденных доменов с генерацией файла маршрутов

Если на сервере временно не хватает места на диске, задача автоматически встаёт в очередь и запускается, как только место освобождается.

🌍 Работа с доменами

Способы ввода доменов

1. Ручной ввод

Просто отправьте сообщение с доменами:

domain1.com

domain2.com

domain3.com

2. Загрузка файла

Отправьте файл .txt или .xlsx со списком доменов:

domain1.com

domain2.com

domain3.com

Вы можете скопировать из DevTools браузера все адреса (клик правой кнопкой мыши по любому запросу → "Копировать все URL's") и скинуть боту — он сам обработает адреса и уберёт дубликаты.

Если Telegram просит сократить сообщение — значит, вы отправляете слишком много адресов текстом. Сохраните их в .txt файл и отправьте файлом.

Большой список готовых адресов по сервисам можно найти в репозитории GitHub (отображены не все платформы — воспользуйтесь поиском).

3. Выбор платформы

Используйте кнопки главного меню для выбора предустановленных платформ.

4. Мои адреса

Команда /my_urls — добавьте адреса в свой персональный список один раз и запускайте резолвинг сразу из него одной кнопкой.

Процесс обработки

1.     Отправьте домены любым удобным способом

2.     Выберите дополнительные опции:

·       Для пользовательских доменов: доступны поиск поддоменов и сбор IP в подсети

·       Для платформ: только сбор IP в подсети (поиск поддоменов отключён для скорости обработки)

3.     Выберите формат результата (.txt, .bat, .xlsx)

4.     Выберите DNS-сервер (или опросите все сразу)

5.     Получите готовый файл — бот сам выполнит 3 прогона резолвинга для надёжности результата

Имейте в виду: в роутеры Keenetic влезает не более 1024 маршрутов. Если нужно больше — собирайте адреса в подсети, но ограничение в 1024 распространяется и на них тоже.

Отмена задачи: кнопка "Отмена" или команда /cancel прерывает текущий резолвинг или обработку PCAP.

🏢 Платформы

Бот поддерживает набор предустановленных популярных платформ.

Как использовать:

1.     Нажмите кнопку нужной платформы

2.     При необходимости включите сбор в подсети

3.     Выберите формат результата и DNS-сервер

4.     Получите готовый файл со всеми IP-адресами платформы

💳 Подписка

Управление подпиской

Проверка статуса:

/subscription

Покупка подписки:

1. Отправьте /subscription
2. Нажмите "Оформить подписку"
3. Оплатите удобным способом
4. Подписка активируется автоматически сразу после оплаты

Актуальная стоимость подписки показывается в боте при оформлении.

Поддерживаемые способы оплаты:

• 💳 Банковские карты (Visa, MasterCard, МИР)
• 📱 Кошелёк ЮKassa

Автоматическое продление

Автоматическое продление подписки (списание без вашего участия) не реализовано. За день до окончания подписки бот присылает напоминание, а после истечения — уведомление с кнопкой для оформления новой подписки.

📋 Мои адреса

Команда /my_urls открывает персональный список адресов:

• До 1000 адресов на пользователя
• Добавление текстом или файлом .txt/.xlsx
• Резолвинг всего списка одной кнопкой

Помните: в роутер Keenetic нельзя добавить более 1024 маршрутов, поэтому хранить и резолвить существенно больше адресов обычно не имеет смысла.

🤖 Команды бота

Основные команды

• /start — запуск бота и начало работы
• /subscription — управление подпиской
• /my_urls — мои адреса
• /terms — пользовательское соглашение
• /instructions — подробная инструкция
• /support — написать в поддержку

Кнопки и интерфейс

• Кнопки платформ — быстрый выбор предустановленных наборов
• "Назад" — возврат к предыдущему шагу
• "Отмена" — прерывание текущей операции
• Inline-кнопки — интерактивные элементы в сообщениях

❓ Часто задаваемые вопросы

🔧 Технические вопросы

Q: Сколько времени занимает анализ доменов?

A: Зависит от количества доменов и включённых опций (поиск поддоменов, подсети). Бот всегда делает 3 прогона резолвинга автоматически.

Q: Какой максимальный размер файла можно загрузить?

A: Для PCAP-файлов — до 500 МБ суммарно за раз. Для списков доменов (.txt/.xlsx) жёсткого ограничения нет, но не стоит загружать по несколько тысяч адресов за один раз — старайтесь отправлять не более 300 адресов без учёта сбора поддоменов, так обработка пройдёт быстрее.

Q: Поддерживаются ли IDN-домены (кириллические)?

A: Да, бот корректно обрабатывает интернационализированные доменные имена.

Q: Можно ли анализировать IP-адреса напрямую?

A: Да, бот распознаёт и обрабатывает как домены, так и IP-адреса.

💰 Вопросы по подписке

Q: Есть ли возврат средств?

A: Да, возврат возможен согласно пользовательскому соглашению, если после оплаты бот не использовался.

Q: Действует ли подписка на всех устройствах?

A: Да, подписка привязана к вашему Telegram-аккаунту и работает на всех устройствах.

🔒 Конфиденциальность и безопасность

Что мы храним

• Идентификатор Telegram (для привязки подписки к учётной записи)
• История запросов (для улучшения сервиса)
• Информацию о подписке (статус, id платежа в ЮKassa, для предоставления услуг)

Что мы НЕ храним

• Содержимое анализируемых доменов
• Персональные данные (номера телефонов, email и т.д.)
• Данные банковских карт (обрабатываются YooKassa)

Ваши права

• Запросить удаление всех данных
• Получить отчёт о хранимых данных
• Отозвать согласие на обработку

🛡️ Поддержка

Способы связи с поддержкой

🤖 Через бота:

/support

После команды /support открывается прямой чат с поддержкой — ваши сообщения (текст, файлы, фото) доставляются администратору, а ответы приходят вам прямо в бота.

Что включить в обращение

1. Описание проблемы — подробно опишите, что происходит
2. Шаги воспроизведения — как можно повторить проблему
3. Скриншоты — если применимо

🛠️ Решение проблем

Q: При оплате ошибка net.:ERR_UNKNOWN_URL_SCHEME

Попробуйте оплатить через другое приложение Telegram. Не все клиенты Telegram поддерживают WebApp (старые версии, альтернативные клиенты, Telegram X).

Q: Бот не отвечает на сообщения

Попробуйте перезапустить диалог командой /start или сбросить текущее действие командой /cancel.

Q: Ошибка при обработке доменов

A: Возможные причины:

1. Некорректный формат доменов
2. Недоступность DNS-серверов
3. Слишком большое количество обрабатываемых адресов/поддоменов за один раз — попробуйте сократить список

Q: Загрузил файл в роутер, но сайт не открывается или открывается частично

1. В файле более 1024 строк маршрутов, и важные для работы сайта записи не попали в роутер из-за ограничения на количество маршрутов
2. Попробуйте включить сбор поддоменов для нужного адреса — по кнопкам платформ не всегда есть актуальная информация, и нужного поддомена может там не быть
3. Чтобы получить только нужные вам адреса и не засорять роутер лишним, лучше собирать нужные адреса через DevTools браузера
4. Если ничего не помогло — опишите проблему через /support 

Спасибо за использование DomainMapper Bot! 🚀

⚠️ Примечание:

Компания Meta Platforms Inc. (владелец социальных сетей Instagram и Facebook) признана экстремистской организацией и её деятельность запрещена на территории Российской Федерации. В боте не создан для обхода блокировок и администрация бота не дает рекомендации по обходу блокировок.