Gotator

Gotator — это инструмент для генерации DNS-словников с помощью перестановок.

🛠️ Установка

Если вы хотите внести изменения локально и скомпилировать, следуйте инструкциям ниже:

> git clone https://github.com/Josue87/gotator.git
> cd gotator
> go build

Если вы заинтересованы только в использовании программы:

> go install github.com/Josue87/gotator@latest

🐳 Docker вариант:

> git clone https://github.com/Josue87/gotator.git
> cd gotator
> docker build -t gotator . 
# Использование 
> docker run gotator -sub subdomains.txt  [...]

Примечание: Если вы используете версию 1.16 или выше и получаете ошибки, выполните следующую команду:

> go env -w GO111MODULE="auto"

Чтобы обновить версию, добавьте параметр -u в команду установки.

✨ Возможности

Gotator обладает следующими функциями для перестановок:

• Проверяет домен и TLD, анализируя ccSLD, чтобы не выходить за пределы области (example.com, example.com.mx и т.д.).
• Переставляет числа вверх и вниз [-numbers ], например:
  • Целевой поддомен — 10, а флаг numbers установлен в 3 [-numbers 3]; в результате получим числа от 7 до 13.
  • Целевой поддомен — dev1, а флаг numbers установлен в 3 [-numbers 3]; увидим dev0, dev1, dev2, dev3 и dev4 (исключая отрицательные числа).
  • Целевой поддомен — test10-demo2, а флаг numbers установлен в 1 [-numbers 1]; среди результатов увидим test11-demo2.example.com, test9-demo2.example.com, test10-demo3.example.com или test10-demo1.example.com. (Каждый раз меняется только одно число).
• Gotator имеет 3 уровня глубины [-depth ]:
  • Если глубина установлена в 1 (режим по умолчанию), для перестановки слова test на получим .

🗒 Опции

Флаги, которые можно использовать для запуска инструмента:

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

gotator -sub domains.txt -perm permutations.txt -depth 2 -numbers 5 > output.txt

Для фильтрации результата и удаления возможных дубликатов:

gotator -sub domains.txt -perm permutations.txt -depth 3 -numbers 10 -md | uniq > output2.txt

Замените uniq на sort -u в предыдущей команде, если хотите отсортировать результат. (Не рекомендуется из-за времени выполнения).

Примечание: Если вы компилируете локально, не забудьте поставить ./ перед вашим бинарным файлом!

🚀 Примеры

Примечание: Примеры могут относиться к более ранним версиям (где -mindup и adv не использовались).

У нас есть следующие списки:

В первом примере мы мутируем указанный поддомен:

В следующем примере мы указываем Gotator извлечь возможные домены из поддоменов с помощью -md:

Вы можете видеть, что example.com учитывается. Теперь пример со списком перестановок, содержащим test100demo, и с аргументом -numbers 3:

Можно увидеть большую глубину мутации, а также указать параметр prefixes (который добавляет небольшой список мутаций):

Последний пример показывает только часть вывода.

Наконец, пример с тихим режимом и разной глубиной с перенаправлением вывода в файл:

👉 Отказ от ответственности

Этот инструмент может генерировать файлы огромного размера и некоторые дубликаты; мы рекомендуем фильтровать вывод с помощью uniq или sort -u и быть осторожными с флагом depth из-за размера вывода (легко сгенерировать файлы размером > 10 ГБ). Имейте в виду, что при передаче вывода по конвейеру другим инструментам требуется, чтобы инструмент обрабатывал весь вывод сразу (sort, uniq).

• Примеры:

# Фильтрация вывода по размеру
gotator -sub subs.txt -perm perm.txt -depth 2 -numbers 5 -md | head -c 1G > output1G.txt

# Фильтрация вывода по строкам
gotator -sub subs.txt -perm perm.txt -depth 3 -mindup -numbers 20 | head -n 100000 > output100Klines.txt

# Сортировка уникальных строк
gotator -sub subs.txt -perm perm.txt -depth 2 -mindup -numbers 10 -prefixes | sort -u > outputSortUnique.txt

# Уникальные строки (удаляет только следующие друг за другом дубликаты) 
gotator -sub subs.txt -perm perm.txt -depth 3 -mindup | uniq > outputUnique.txt

# Уникальные строки 
gotator -sub subs.txt -perm perm.txt -depth 3 -mindup -adv | anew > outputAnew.txt

# Сортировка уникальных с ограничением размера
gotator -sub subs.txt -perm perm.txt -prefixes -adv | head -c 1G | sort -u > output1GSortedUnique.txt

Примечание: Примеры приведены с использованием sort -u, что замедлит генерацию результатов. Нет необходимости сортировать результаты, рекомендуется использовать anew.

Уведомление: Этот инструмент генерирует много выходной информации, рекомендуется использовать флаг mindup для уменьшения количества строк.