RapidDNS CLI

中文文档

Мощный интерфейс командной строки для взаимодействия с RapidDNS API. Этот инструмент позволяет выполнять DNS-поиск, сложные запросы и масштабный экспорт данных непосредственно из терминала.

Возможности

• DNS-поиск: Поиск по домену, IP или CIDR.
• Сложный запрос: Использование мощного синтаксиса запросов (например, domain:example ADN tld:com AND type:A).
• Экспорт данных: Автоматическое управление задачами экспорта: запуск, проверка статуса, загрузка и распаковка.
• Извлечение данных:
  • Извлечение и дедупликация поддоменов в список.
  • Извлечение и дедупликация IP-адресов в список.
  • Генерация статистики по IP-сегментам (количество подсетей).
• Гибкий вывод: Сохранение результатов в форматах JSON, CSV или Text.
• Поддержка конвейеров: Чистое разделение stdout/stderr для объединения с другими инструментами.
• Конфигурация: Простое управление API-ключами.

Установка

Через go install

Требования: Go 1.16+

Вы можете установить последнюю версию напрямую:

go install github.com/rapiddns/rapiddns-cli@latest

После установки убедитесь, что $GOPATH/bin (или каталог bin Go для вашей настройки) находится в вашем PATH, затем вы можете выполнить:

rapiddns-cli --help

Сборка из исходного кода

Требования: Go 1.16+

1. Клонируйте репозиторий:

   root@kitploit:~

   git clone https://github.com/rapiddns/rapiddns-cli.git
   cd rapiddns-cli
   

2. Соберите для вашей платформы:

   Windows:

   root@kitploit:~

   go build -o rapiddns-cli
   

   Linux:

   root@kitploit:~

   GOOS=linux GOARCH=amd64 go build -o rapiddns-cli
   

   macOS (Intel):

   root@kitploit:~

   GOOS=darwin GOARCH=amd64 go build -o rapiddns-cli
   

   macOS (Apple Silicon/M1/M2):

   root@kitploit:~

   GOOS=darwin GOARCH=arm64 go build -o rapiddns-cli
   

Конфигурация

Для использования полных возможностей RapidDNS (особенно экспорта и неограниченного поиска) вам нужен API-ключ.

1. Получите ваш API-ключ в профиле RapidDNS.
2. Настройте его в CLI:

rapiddns-cli config set-key <YOUR_API_KEY>

Проверка текущего ключа:

rapiddns-cli config get-key

Примечание: Без API-ключа результаты поиска могут быть ограничены, а функция экспорта будет отключена.

Использование

1. Базовый поиск

Поиск по домену, IP или CIDR.

rapiddns-cli search tesla.com

Опции:

• --page: Номер страницы (по умолчанию 1).
• --type: Фильтр по типу (subdomain, same_domain, ip, ip_segment, advanced).
• -o, --output: Формат вывода (json, csv, text). По умолчанию: json.
• -f, --file: Сохранить вывод в указанный файл.
• --column: Вывести только указанный столбец в консоль (subdomain, , , ).

Примеры:

# Сохранение в CSV
rapiddns-cli search tesla.com -o csv -f results.csv

# Автоматически получить до 1000 записей
rapiddns-cli search tesla.com --max 1000

# Извлечь только поддомены
rapiddns-cli search tesla.com --extract-subdomains

# Извлечь только IP и статистику
rapiddns-cli search tesla.com --extract-ips

# Извлечь И то, И другое
rapiddns-cli search tesla.com --extract-subdomains --extract-ips

2. Конвейер и вывод в консоль

Разработан для хакеров и автоматизации. Стандартный вывод (stdout) содержит чистые данные, а статус/ошибки отправляются в stderr.

Вывод только поддоменов (текстовый список):

rapiddns-cli search tesla.com --column subdomain -o text

Вывод:

api.tesla.com
www.tesla.com
...

Вывод только IP (массив JSON):

rapiddns-cli search tesla.com --column ip -o json

Вывод:

[
  "1.2.3.4",
  "5.6.7.8"
]

Тихий режим (только извлечение в файлы):

rapiddns-cli search tesla.com --extract-subdomains --silent

3. Сложный запрос

Выполнение сложных запросов с использованием синтаксиса RapidDNS через команду search и --type advanced.

rapiddns-cli search "domain:apple.com AND type:A" --type advanced

4. Экспорт данных (рекомендуется для больших объёмов)

Команда export обрабатывает весь рабочий процесс: запрос экспорта, ожидание завершения, загрузку файла и его обработку.

rapiddns-cli export start tesla.com

Опции:

• --type: Тип поиска (subdomain, sameip, ip_segment, advanced). Используйте advanced для синтаксиса запросов.
• --max: Максимальное количество записей для экспорта (0 означает все, по умолчанию 0).
• --compress: Сжать результат в ZIP (по умолчанию true).
• --extract-subdomains: Извлечь поддомены из загруженного CSV.
• --extract-ips: Извлечь IP-адреса и сгенерировать статистику подсетей из загруженного CSV.

Пример полного рабочего процесса:

rapiddns-cli export start tesla.com --max 10000 --extract-subdomains --extract-ips

Пример экспорта со сложным запросом:

Для использования синтаксиса сложного запроса при экспорте укажите --type advanced:

rapiddns-cli export start "domain:apple AND type:A" --type advanced

Эта команда выполнит:

1. Запуск задачи экспорта для tesla.com.
2. Ожидание обработки сервером.
3. Загрузку ZIP-файла в каталог result/.
4. Распаковку содержимого.
5. Создание tesla.com_subdomains.txt (список поддоменов).
6. Создание tesla.com_ips.txt (список уникальных IP-адресов).
7. Создание tesla.com_ip_stats.txt (статистика по IP-подсетям).

Структура вывода

Все результаты по умолчанию сохраняются в каталоге result/.

• {keyword}_subdomains.txt: Чистый список уникальных поддоменов.
• {keyword}_ips.txt: Чистый список уникальных IP-адресов.
• {keyword}_ip_stats.txt: Статистика количества IP-адресов по подсетям (IPv4 /24, IPv6 /64).
• rapiddns_export_{keyword}_{date}.csv: Необработанные экспортированные данные.

Справка

Выполните любую команду с параметром --help, чтобы увидеть более подробную информацию.

rapiddns-cli --help
rapiddns-cli search --help
rapiddns-cli export --help