Skip to content

Latest commit

 

History

History
718 lines (504 loc) · 35.2 KB

README-RU.md

File metadata and controls

718 lines (504 loc) · 35.2 KB
Raw

DNS Domain Expiration Checker from ak545

Python

ddec.py - Это python-скрипт для проверки сроков окончания регистрации ваших доменов.

Этот скрипт развивает идею другого скрипта DNS Domain Expiration Checker, Автор: Matty < matty91 at gmail dot com >

Скриншоты

Скрипт в работе

Ещё больше

Скрипт в работе

Пример email

Пример email

Пример Telegram сообщения

Описание

Если вы находитесь здесь, возможно, у вас истёк срок действия домена, и вы справились с неприятностями, связанными с его восстановлением. Это не весело, правда? Чтобы вам снова не попасть в подобную ситуацию, вы можете установить и запустить ddec.py для мониторинга ваших доменных имён. Если вы добавите этот скрипт в планировщик заданий (например, в cron, если у вас Linux или в Task Scheduler, если у вас Windows), то он будет следить за своевременностью обновления доменных имён. Если скоро наступят сроки окончания регистрации ваших доменных имён, скрипт вовремя сообщит вам об этом (или по электронной почте или по Telegram или непосредственно в консоли). Если вы владеете несколькими доменными именами, обслуживаемые различными регистраторами, этот скрипт так же поможет стандартизировать все уведомления об истечении сроков регисрации доменных имён.

Инсталляция

Для работы скрипта необходим Python версии 3.6 или выше. Разумеется, необходимо сперва установить сам Python. В Linux он обычно уже установлен. Если нет, установите его, например:

$ sudo yum install python3
$ sudo dnf install python3
$ sudo apt install python3
$ sudo pacman -S python

Дополнительно вам потребуется Python package installer (установщик модулей Python), например pip. Установить в Linux его можно так:

$ sudo yum install python3-pip
$ sudo dnf install python3-pip
$ sudo apt install python3-pip
$ sudo pacman -S python-pip

Для Apple macOS:

$ xcode-select --install

Установите brew:

$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Установите Python:

$ export PATH=/usr/local/bin:/usr/local/sbin:$PATH
$ brew install python

Примечание: brew

Для Microsoft Windows скачайте дистрибутив и установите его. Я рекомендую скачивать "Download Windows x86 executable installer" если у вас 32-х битная ОС и "Download Windows x86-64 web-based installer" если у вас 64-х битная ОС. Во время установки рекомендую отметить все опции (Documentation, pip, tcl/tk and IDLE, Python test suit, py launcher, for all users (requeres elevation)).

Предварительно, возможно понадобится обновить сам pip (установщик модулей Python):

$ python -m pip install --upgrade pip
или
> py -m pip install --upgrade pip

Установка и обновление зависимостей

$ pip install -U python-whois
$ pip install -U python-dateutil
$ pip install -U colorama
$ pip install -U exrex

и

$ pip install -U requests[socks]

или

$ pip install -U PySocks

Если Вы работаете под управлением Linux или macOS, и запуск скрипта планируете производить от имени текущего пользователя, то дополнительно указывайте опцию --user. В этом случае необходимые зависимости будут устанавливаться в домашнюю папку текущего пользователя системы и доступны при запуске из планировщика задач (cron) от имени этого текущего пользователя.

В зависимости от вашего Python окружения, ваши действия будут немного иными, например, возможно, вам потребуется указать ключ --user (для pip) или вместо команд python и pip использовать команды python3 и pip3. Если вы используете виртуальные окружения, то скорее всего, все эти действия вам необходимо будет сделать после входа в соответствующее окружение.

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

$ ddec.py -h
usage:  ddec.py [Options]

        A simple python script to display or notify a user by email and/or via Telegram
        about the status of the domain and the expiration date.

        DNS Domain Expiration Checker

Options:
  -h, --help            Help
  -v, --version         Display the version number
  -f FILE, --file FILE  Path to the file with the list of domains (default is None)
  -d STRING, --domain STRING
                        Domain to check expiration on (default is None)
  -c, --print-to-console
                        Enable console printing (default is False)
  -l, --long-format     Enable detailed print in console (default is False)
  -i SECONDS, --interval-time SECONDS
                        Time to sleep between whois queries (in seconds, default is 60)
  -x DAYS, --expire-days DAYS
                        Expiration threshold to check against (in days, default is 60)
  -s FLOAT, --cost-per-domain FLOAT
                        The cost per one domain (in your currency, default is 0.00)
  -twtc, --track-whois-text-changes
                        Enable whois text change monitoring (default is False)
  -split, --split-long-message
                        Split a long message for Telegram into many short parts (default is False)
  -trim, --trim-long-whois-text
                        Trim long whois text of changes for a domain for Telegram (default is False)
  -t, --use-telegram    Send a warning message through the Telegram (default is False)
  -p URL, --proxy URL   Proxy link for Telegram only (default is None)
                        for example:
                        user:[email protected]:8080
                        socks5://127.0.0.1:9150
  -piw URL, --proxy-internal-whois URL
                        Socks-proxy link for internal whois engine only (default is None)
                        for example:
                        user:[email protected]:8080
                        127.0.0.1:9150
  -e EMAIL, --email-to EMAIL
                        Send a warning message to email address (default is None)
  -subject STRING, --email-subject STRING
                        Append custom text to the email subject (default is None)
  -ssl, --email-ssl     Send email via SSL (default is False)
  -auth, --email-auth   Send email via authenticated SMTP (default is False)
  -starttls, --email-starttls
                        Send email via STARTTLS (default is False)
  -oe, --use-only-external-whois
                        Use only external utility whois (default is False)
  -ee, --use-extra-external-whois
                        Use external whois utility for additional analysis (default is False)
  -nb, --no-banner      Do not print banner (default is False)

© AK545 (Andrey Klimov) 2019..2024, e-mail: ak545 at mail dot ru

Описание опций

-h, --help

Помощь

-v, --version

Показать номер версии

-f FILE, --file FILE

Путь к файлу со списком доменов (по умолчанию Нет)

Формат файла со списком доменов

    domain [%days%] [sleep:%seconds%] [cost:%cost%] [skip_checking_whois_text_changes]
    domain [sleep:%seconds%] [%days%]
    domain [%days%]
    domain [sleep:%seconds%]
    domain [cost:%cost%]
    domain
    @regexp:regular_expression [%days%] [sleep:%seconds%] [cost:%cost%] [skip_checking_whois_text_changes]
    @regexp:regular_expression [sleep:%seconds%] [cost:%cost%]
    @regexp:regular_expression [%days%]
    @regexp:regular_expression

domain - Имя домена

@regexp: - ключевое слово начала описания списка доменов при помощи регулярного выражения (не изменяйте его!)

regular_expression - регулярное выражение, описывающее правила формирования списка доменов (повторяющиеся доменные имена будут исключены)

%days% - Целое число, обозначающее за какое количество дней до истечения срока регистрации домена поднимать тревогу.

%seconds% - Целое число, количество секунд, на которое необходимо заснуть, перед тем, как продолжить анализ следующего домена. Ключевое слово "sleep:" не менять. Пробелы между этим ключевым словом и количеством секунд не допускаются.

%cost% - Число, обозначающее стоимость продления домена. Ключевое слово "cost:" не менять. Пробелы между этим ключевым словом и стоимостью не допускаются.

skip_checking_whois_text_changes - Ключевое слово для игнорирования возможной проверки на изменения текста whois.

Файл должен быть в кодировке UTF-8 без ВОМ, формат новой строки: Unix (0Ah)

Пример файла со списком доменов

#-------------------------------------------------------------
#
# Пример файла со списком доменов
# Допускается:
# - пустые строки
# - строка - комментарий (строка должна начинаться с символа "#")
# - строка - название заголовка группы (строка должна начинаться с символа "!")
#
# Формат задания строки домена:
# - имя домена (обязательно первым)
# - значение истечения срока в днях (целое число)
# - значение интервала в секундах перед тем как перейти к следующей проверке (sleep:целое число)
# - стоимость продления домена (cost:float)
# - пропустить проверку изменений текста whois для этого домена (skip_checking_whois_text_changes)
#
# Например:
# ! Группа 1
# имя_домена
# имя_домена число
#
# ! Группа 2
# имя_домена число sleep:число cost:float skip_checking_whois_text_changes
# имя_домена sleep:число число 
# имя_домена sleep:число
#
# ! Regexp Группа 3
# @regexp:регулярное_выражение cost:0 sleep:4 skip_checking_whois_text_changes
#
# Если значение истечения срока в днях не задано,
# используется значение по-умолчанию или из параметра командной строки
#
# Если значение интервала в секундах перед тем как перейти к следующей проверке не задано,
# используется значение по-умолчанию или из параметра командной строки
#
# Если значение стоимости продления домена не задано,
# используется значение по-умолчанию или из параметра
# командной строки
#
#-------------------------------------------------------------

! Это пример заголовка группы
a.ru
linux.cafe 1000 sleep:8 cost:890.00
cyberciti.biz sleep:10 70
dotmobi.mobi 80
spotch.com sleep:15
yahoo.com
prefetch.net
nixcraft.com
abc.xyz
codepen.io
habr.com
freepascal.org
mikrotik.com skip_checking_whois_text_changes
git-scm.com
github.com
python.org

! Социальные сети
livejournal.com
facebook.com
twitter.com

! Youtube
youtube.tv  
youtube.com

! Regexp Группа (имена доменов генерируются при помощи регулярных выражений, дубликаты автоматически игнорируются)
@regexp:youtube\.(com|org|net) cost:0 sleep:4 skip_checking_whois_text_changes
@regexp:youtube[0-9]\.com cost:0 skip_checking_whois_text_changes sleep:4
@regexp:youtube([0-9]|1[0-5])\.com cost:0 skip_checking_whois_text_changes sleep:4

-d STRING, --domain STRING

Домен для проверки срока действия (по умолчанию Нет)

-c, --print-to-console

Включить печать в консоли (по умолчанию False) В консоли печатаются столбцы "Domain Name", "Expiration Date" и "Days Left".

-l, --long-format

Включить подробную печать в консоли (по умолчанию False) В консоли печатаются столбцы "Domain Name", "Whois server", "Registrar", "Expiration Date" и "Days Left".

-i SECONDS, --interval-time SECONDS

Время ожидания между whois-запросами (в секундах, по умолчанию 60)

-x DAYS, --expire-days DAYS

Порог истечения срока действия для проверки (в днях по умолчанию 60) За сколько дней перед окончанием срока регистрации домена начинать предупреждать.

-s FLOAT, --cost-per-domain FLOAT

Стоимость продления домена (по умолчанию 0.00)

-twtc, --track-whois-text-changes

Включить мониторинг изменений текста whois (по умолчанию False)

Если в файле со списком доменов для какого-то домена указано ключевое слово skip_checking_whois_text_changes, то для такого домена проверка на изменения текста whois будет проигнорирована.

-split, --split-long-message

Разбить длинное сообщение для Telegram на множество коротких частей (по умолчанию Нет)

-trim, --trim-long-text

Обрезать длинный whois-текст изменений домена для Telegram (по умолчанию Нет)

-t, --use-telegram

Отправить предупреждающее сообщение через Telegram (по умолчанию False)

-p URL, --proxy URL

Ссылка на прокси (только для Telegram), например: socks5://127.0.0.1:9150 (по умолчанию None).

-piw URL, --proxy-internal-whois URL

Ссылка на Socks-прокси только для внутреннего whois-движка, например: user:[email protected]:8080 или 127.0.0.1:9150 (по умолчанию None).

Не используйте опцию -oe/--use-only-external-whois с опцией -piw/--proxy-internal-whois.

-e EMAIL, --email-to EMAIL

Отправить предупреждение на адрес электронной почты (по умолчанию Нет). Здесь необходимо указать email адрес получателя.

-subject STRING, --email-subject STRING

Добавить свой текст в тему email-письма (по умолчанию Нет). Это дополнительная опция для --email-to.

-ssl, --email-ssl

Отправить email-письмо по протоколу SSL (по умолчанию False). Это дополнительная опция для --email-to.

-auth, --email-auth

Отправлять email-письмо через SMTP с авторизацией (по умолчанию False). Это дополнительная опция для --email-to.

-starttls, --email-starttls

Отправить email-письмо по протоколу STARTTLS (по умолчанию False). Это дополнительная опция для --email-to.

-oe, --use-only-external-whois

Использовать только внешниюю утилиту whois (по умолчанию False). В этом режиме анализ данных внутренним движком не производится. Полностью доверяем работе внешней утилиты whois.

-ee, --use-extra-external-whois

Использовать внешниюю утилиту whois для дополнительного анализа (по умолчанию False)

Я рекомендую использовать этот режим. В этом режиме анализ данных сперва производится внутренним движком, а при возникновении ошибок - повторно уже внешней утилитой whois. Почему я рекомендую именно этот режим? Потому что в ряде случаев, например, для доменов из зоны .COM, управление доменами может быть делегировано каким-то другим региональным регистраторам. И если вы покупаете домен у регионального регистратора, то и продлевать домен вы будет у него, а не у родительского регистратора. Но так как синхронизация данных между региональным и родительским регистраторами происходит не моментально (задержка составлят от нескольких минут до нескольких часов), то если вы будете запрашивать whois информацию при помощи только внешней утилиты whois, вы получите данные от родительского регистратора. Внешняя утилита whois так работает. И если региональный регистратор к этому моменту ещё не успеет синхронизировать свои данные с родительским, вы получите ложное сообщение о том, что домен ещё не продлён, хотя на самом деле с ним уже всё хорошо. Внутренний движок скрипта позволяет обнаруживать факт делегирования управления доменами от родительского регистратора к региональному. Информацию о сроке регистрации домена внутренний движок берёт от регионального регистратора чьи данные являются наиболее достоверными и свежими.

-nb, --no-banner

Не печатать баннер (по умолчанию False). Баннер, это информация о среде исполнения скрипта: версия Python, имя компьютера, имя ОС, релиз ОС, версия ОС, архитектура, ЦПУ, сводная таблица предустановленных опций и информация о пути к внешней утилите whois.

Внешняя утилита whois

В большинстве ОС Linux утилита whois уже имеется. Если нет, установите её. Например:

Для Ubuntu/Debian:

$ sudo apt update && sudo apt upgrade
$ sudo apt install whois

Для устаревших RPM-Based дистрибутивов Linux (RHEL 6.x/RHEL 7.x/CentOS 6.x/CentOS 7.x):

$ sudo yum install jwhois

Для более новых RPM-Based дистрибутивов Linux (RHEL 8.x/CentOS 8.x/Fedora 22 и выше/Rocky Linux/Alma Linux):

$ sudo dnf install jwhois

Для Arch/Manjaro:

$ sudo pacman -S whois

Для Apple macOS:

$ brew install whois

Примечание: brew

Для ОС Microsoft Windows лучше всего использовать форк whois из пакета cygwin.

Загрузите и запустите cygwin. В ходе установки cygwin задайте установку пакета whois. Запомните, куда устанавливается сам cygwin (например, в папку c:\cygwin64).

После установки cygwin откройте командную строку с правами администратора.

Примечание: используйте CMD.exe, не используйте Powershell (для него команда совсем другая)!

Выполните команду (смотрите ниже; в Windows 7/8/8.1/10/11 переменные среды можно изменять через графический интерфейс пользователя):

> setx /M PATH "c:\cygwin64\bin;%PATH%"

Обратите внимание! Для полноценной работы утилиты whois из состава пакета cygwin требуются файлы (в этом репозитории они находятся в папке /cygwin64/bin/. Примите к сведению, что это версии для 64 битной операционной системы MS Windows.):

whois.exe
cygiconv-2.dll
cygidn-11.dll
cygintl-8.dll
cygwin1.dll

Глобальные константы в скрипте

Часть опций находится внутри скрипта. Нет никакого смысла выносить их в параметры, так как настроить их требуется всего один раз, после чего успешно о них забыть.

Параметры SMTP

SMTP_SERVER

адрес SMTP сервера

Примеры:

    SMTP_SERVER = os.getenv("SMTP_SERVER", "localhost")
    # SMTP_SERVER = os.getenv("SMTP_SERVER", "smtp.gmail.com")
    # SMTP_SERVER = os.getenv('SMTP_SERVER', 'smtp.mail.ru')
    # SMTP_SERVER = os.getenv('SMTP_SERVER', 'smtp.yandex.ru')

SMTP_PORT

SMTP порт

Примеры:

    # SMTP_PORT = int(os.getenv("SMTP_PORT", "587"))  # Для starttls
    # SMTP_PORT = int(os.getenv("SMTP_PORT", "465"))  # Для SSL
    SMTP_PORT = int(os.getenv("SMTP_PORT", "25"))   # По умолчанию

SMTP_SENDER

Email адрес отправителя

Примеры:

    SMTP_SENDER = os.getenv("SMTP_SENDER", "[email protected]")

SMTP_PASSWORD

SMTP пароль

Примеры:

    SMTP_PASSWORD = os.getenv("SMTP_PASSWORD", "P@ssw0rd")

Параметры Telegram

TELEGRAM_TOKEN

Токен Telegram бота

Примеры:

    TELEGRAM_TOKEN = 'NNNNNNNNN:NNNSSSSaaaaaFFFFFEEE3gggggQQWFFFFF01z'

TELEGRAM_CHAT_ID

Идентификатор канала Telegram

Примеры :

    TELEGRAM_CHAT_ID = '-NNNNNNNNN'

Получить помощь по API Telegram: https://core.telegram.org/bots Создать бота можно пообщавшись в Telegram с @BotFather

TELEGRAM_URL

Telegram API URL

Примеры:

    TELEGRAM_URL = "https://api.telegram.org/bot" + TELEGRAM_TOKEN + "/"

Опции внешней утилиты whois

WHOIS_COMMAND

Команда запуска внешней утилиты whois

Примеры:

    WHOIS_COMMAND = "whois"
    # WHOIS_COMMAND = "/usr/bin/whois"
    # WHOIS_COMMAND = "c:\\cygwin64\\bin\\whois.exe"
    # WHOIS_COMMAND = r"c:\cygwin64\bin\whois.exe"

Примечание: Не используйте для ОС Microsoft Windows аналогичную утилиту whois от автора Марка Руссиновича. При отправке whois-запросов на некотрые whois-сервера (например, на сервера GoDaddy.com) она может зависнуть или вернуть неверный результат.

WHOIS_COMMAND_TIMEOUT

Максимальное время ожидания выдачи результата от внешней утилиты whois (в секундах). По истечении этого времени внешний процесс whois будет принудительно завершён. Сам скрипт продолжит свою работу.

Примеры:

    WHOIS_COMMAND_TIMEOUT = 10

Стоимость продления домена

G_CURRENCY_SYMBOL

Задаёт символ национальной валюты

Примеры:

    # G_CURRENCY_SYMBOL = '$'
    # G_CURRENCY_SYMBOL = '¥'
    # G_CURRENCY_SYMBOL = '£'
    # G_CURRENCY_SYMBOL = '€'
    G_CURRENCY_SYMBOL = '₽'

Параметры оценки времени до окончания сроков регисрации домена

G_SOON_ADD

Сколько дней должно остаться до окончания срока регистрации домена, когда об окончании срока можно судить, как "очень скоро", но ещё Валидно. Эти дни прибавляются к параметру --expire-days (или к аналогичному значению в файле списков доменных имён)

Примеры:

    G_SOON_ADD = 21

Если --expire-days (или аналогичное значение в файле списков доменных имён) равно 60 дней, то за 81 дня до окночания срока регистрации домена (60 + 21), такой домен будет в категории "Скоро".

Как добавить скрипт в Linux cron

Для этого создайте crontab задачу, которая будет выполняться, например, каждую полночь от имени пользователя (создавать задачи от имени root не лучшая идея):

Предположим, ваш логин в Linux: user

Ваша домашняя папка: /home/user

Папка, где находится этот скрипт: /home/user/py

Чтобы запускать скрипт напрямую, выполните команду:

$ chmod +x /home/user/py/ddec.py

Скорректируйте в первой строке скрипта Шебанг (Unix), например:

Показать путь, где расположен python:

$ which python

или

$ which python3

Коррекция пути python в Шебанг:

#!/usr/bin/python
#!/usr/bin/python3
#!/usr/bin/env python
#!/usr/bin/env python3

Переименуйте скрипт:

$ mv /home/user/py/ddec.py /home/user/py/ddec

Проверьте запуск скрипта:

$ /home/user/py/ddec -h
$ /home/user/py/./ddec -h

Если всё нормально, запустите редактор crontab, если нет, вернитесь к настройке Шебанг:

$ crontab -u user -e

Здесь user - это ваш логин в Linux

Если вы, как и я не любите vim (я не видел ни одного человека, в совершенстве владеющего этим редактором, хотя, наверное, он где-то есть), вы можете редактировать задачи в вашем любимом редакторе, например, так:

$ EDITOR=nano crontab -u user -e
$ EDITOR=mcedit crontab -u user -e

или

$ VISUAL=nano crontab -u user -e
$ VISUAL=mcedit crontab -u user -e

В файле задач создайте примерно такую запись (не используйте ключи --print-to-console и --long-format):

0 0 * * * /home/user/py/ddec -nb -f /home/user/data/domains0.txt -twtc -i 5 -t -split -e [email protected] -ee >/dev/null 2>&1

или

0 0 * * * /home/user/py/./ddec -nb -f /home/user/data/domains0.txt -twtc -i 5 -t -split -e [email protected] -ee >/dev/null 2>&1

Указывайте полные пути к файлу данных и скрипту.

Примечание: cron

Посмотреть созданные задачи для пользователя user можно так:

$ crontab -u user -l

Удалить все задачи пользователя user можно так:

$ crontab -u user -r

Как добавить скрипт в Планировщик заданий Microsoft Windows

Обратитесь за помощью к документации

Пример:

> schtasks /Create /SC DAILY /TN "Domain Expiration Checker" /TR "'с:\ddec.py' -nb -twtc -t -split -e [email protected] -ee -f 'c:\domains.txt'" /ST 23:59

Спасибо

Автору оригинального скрипта: Matty < matty91 at gmail dot com > https://github.com/Matty9191

Отдельные благодарности за различные предложения и замечания:

Лицензия

GNU General Public License v3.0

Почему именно такая я и сам не знаю.

Ограничения

Я, автор этого python-скрипта, написал этот скрипт исключительно для своих нужд. Никаких гарантий не предоставляется. Вы можете использовать этот скрипт свободно, без каких либо отчислений, в любых целях, кроме Киберсквоттинга.

Вы можете вносить любые правки в код скрипта и делать форк этого скрипта при условии указания ссылки на меня и на Matty, как источника вашего вдохновения.

Постскриптум

  • Работа скрипта проверялась в Microsoft Windows 10/11, Linux Fedora 36/38/39, Linux Debian 9/10/11/12, Linux Ubuntu Desktop 18.04/20.04/20.10/22.04.3/23.04, CentOS Linux 7.9/8.5, CentOS Stream 8/9, Rocky Linux 8.9/9.3, Linux Manjaro 23.1.4, Apple macOS 13.4.1 Ventura на MacBook Pro M1.

Windows Fedora Debian Ubuntu Cent OS Rocky Linux Manjaro macOS

  • Программный код скррипта не идеален. Но прошу простить меня за это.
  • Да здравствует E = mc² !
  • Желаю всем удачи!

Последняя просьба

Пришло время положить конец Facebook. Работа там не является нейтральной с этической точки зрения: каждый день, когда вы идете туда на работу, вы делаете что-то не так. Если у вас есть учетная запись Facebook, удалите ее. Если ты работаешь в Facebook, увольняйся.

И давайте не будем забывать, что Агентство национальной безопасности должно быть уничтожено.

(c) David Fifield

Best regards, ak545 ( ru.mail©ak545² )