⏰
blog.cat.ssl

Скрипт для автоматического контроля срока SSL: примеры на Bash и Python

21.11.2026
← Все статьи

Сертификаты Let's Encrypt продлеваются автоматически, но «автоматически» не значит «никогда не ломается». Продление может остановиться из-за изменённого DNS, нового правила файрвола, переполненного диска или из-за того, что веб-сервер не перечитал новый сертификат. Коммерческие сертификаты и вовсе продлеваются вручную, и через год о них легко забыть. В итоге владелец сайта узнаёт о проблеме, когда клиенты пишут, что браузер называет сайт опасным. Чтобы этого не случалось, хватит небольшого скрипта, который каждый день проверяет все домены.

Что должен проверять скрипт

Самое важное: скрипт должен проверять сертификат не в файле, а именно через сервер. На диске может лежать новый сертификат, а веб-сервер всё ещё отдаёт старый — и пользователь видит именно его. Поэтому скрипт подключается к каждому домену через порт 443, читает дату окончания сертификата, который вернул сервер, и считает оставшиеся дни. Если дней меньше заданного порога или само подключение не удалось, отправляется уведомление.

Важно правильно выбрать порог. Сертификаты Let's Encrypt обычно продлеваются примерно за 30 дней до окончания, поэтому если осталось 14 дней, значит, с продлением что-то не так. Для годовых коммерческих сертификатов лучше ставить порог в 30 дней: покупка и подтверждение нового сертификата занимают больше времени.

Скрипт на Bash

Допустим, небольшая веб-студия в Ташкенте следит за десятками сайтов своих клиентов: сайт кафе, страница частной клиники, интернет-магазин и другие. Скрипт ниже проверяет каждый домен из списка и собирает проблемные. Команда timeout нужна, чтобы неотвечающий сервер не подвесил скрипт. date -d — возможность GNU coreutils, она работает на Linux-серверах, а в macOS запись будет другой.

#!/usr/bin/env bash
# /usr/local/bin/ssl-check.sh
DOMAINS="example.uz www.example.uz shop.misol.uz"
WARN_DAYS=14
ALERTS=""

for d in $DOMAINS; do
  end=$(echo | timeout 15 openssl s_client -connect "$d:443" -servername "$d" 2>/dev/null \
        | openssl x509 -noout -enddate 2>/dev/null | cut -d= -f2)
  if [ -z "$end" ]; then
    ALERTS+="$d: ERROR (no certificate)"$'\n'
    continue
  fi
  days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
  if [ "$days" -lt "$WARN_DAYS" ]; then
    ALERTS+="$d: $days days left"$'\n'
  fi
done

if [ -n "$ALERTS" ]; then
  printf '%s' "$ALERTS"
  exit 1
fi
echo "All certificates OK"

При обнаружении проблемы скрипт завершается с кодом 1, если всё в порядке — с кодом 0. Это упрощает подключение к другим системам мониторинга. Перед запуском дайте файлу право на выполнение и проверьте его вручную.

sudo chmod +x /usr/local/bin/ssl-check.sh
/usr/local/bin/ssl-check.sh; echo "exit code: $?"

Уведомления в Telegram

Записи в лог недостаточно: лог никто не читает каждый день. Отправка сообщения через Telegram-бота — простой и действенный способ. Сначала создайте бота через BotFather и получите токен, затем напишите боту и узнайте идентификатор чата. Не вписывайте токен в сам скрипт, храните его в отдельном файле, который может читать только root. Тогда токен не утечёт, если вы покажете скрипт кому-то или добавите его в репозиторий.

# /etc/ssl-check.env  (chmod 600)
TG_TOKEN="токен-бота"
TG_CHAT="chat-id"

# в конец ssl-check.sh, перед exit 1:
source /etc/ssl-check.env
curl -s -X POST "https://api.telegram.org/bot${TG_TOKEN}/sendMessage" \
  -d chat_id="${TG_CHAT}" \
  --data-urlencode text="SSL monitoring:
$ALERTS" > /dev/null

Сообщение отправляется только при проблеме. Если каждый день приходит «всё хорошо», люди быстро перестают читать такие сообщения, и настоящее предупреждение тоже останется без внимания.

Ежедневный запуск через cron

Когда скрипт готов, остаётся добавить его в cron. Проверки раз в день достаточно: срок сертификата измеряется днями, и проверка каждую минуту даёт только лишнюю нагрузку. Перенаправление вывода в лог поможет потом понять, что и когда произошло.

crontab -e

# каждый день в 09:00
0 9 * * * /usr/local/bin/ssl-check.sh >> /var/log/ssl-check.log 2>&1

Вариант на Python

Если на сервере есть Python или проверку нужно встроить в более крупную систему мониторинга, хватит стандартной библиотеки. Важная особенность этого варианта в том, что ssl.create_default_context() проверяет сертификат полностью: полноту цепочки, совпадение имени и срок. Если сертификат уже истёк или цепочка сломана, подключение завершится ошибкой, и скрипт покажет это как ERROR. На самом деле это плюс: с таким сертификатом пользователи тоже не смогут открыть сайт.

#!/usr/bin/env python3
import socket, ssl, time

DOMAINS = ["example.uz", "www.example.uz", "shop.misol.uz"]
WARN_DAYS = 14

def days_left(host):
    ctx = ssl.create_default_context()
    with socket.create_connection((host, 443), timeout=10) as sock:
        with ctx.wrap_socket(sock, server_hostname=host) as tls:
            cert = tls.getpeercert()
    expires = ssl.cert_time_to_seconds(cert["notAfter"])
    return int((expires - time.time()) // 86400)

for host in DOMAINS:
    try:
        d = days_left(host)
        status = "WARN" if d < WARN_DAYS else "OK"
        print(f"{status} {host}: {d} days")
    except Exception as e:
        print(f"ERROR {host}: {e}")

Тонкости проверки

Если у сервера несколько IP-адресов или сайт работает через CDN, из разных мест может возвращаться разный сертификат. В таком случае скрипт нужно направлять на каждый реальный адрес домена отдельно или следить за статусом сертификата в настройках CDN. Добавляйте в список не только основной домен, но и поддомены вроде www, почты и API: у них часто отдельные сертификаты, и о них забывают в первую очередь.

Периодически проверяйте и то, что сам скрипт работает. После переустановки сервера таблица cron может пропасть, а команда curl — исчезнуть. Простой способ — раз в месяц временно поставить в WARN_DAYS большое число и убедиться, что сообщение приходит.

Как подходить к этому на хостинге и VPS

На хостинге sayt.uz сертификаты Let's Encrypt продлеваются панелью автоматически, поэтому такой скрипт служит скорее дополнительной страховкой. На VPS вы управляете сертификатами сами, и такой контроль практически обязателен. Ещё надёжнее запускать скрипт не на проверяемом сервере, а на другом сервере или компьютере: даже если основной сервер полностью выйдет из строя, вы об этом узнаете.

Похожие статьи

📧 SSL для mail.домен.uz: как убрать предупреждение о сертификате в Outlook ⏳ Лимиты Let's Encrypt: ошибка «too many certificates» и как её решить 📜 Certificate Transparency: как работают открытые журналы SSL-сертификатов 🏢 SSL для внутренних (интранет) сайтов: как защитить офисные системы
🌐 Язык
🇺🇿 O⁠'zbek 🇺🇿 Özbek (yangi) 🇺🇿 Ўзбек 🇷🇺 Русский ✓ 🇬🇧 English