В современной системной инженерии мгновенное получение системных оповещений (Alerting) — критически важная составляющая надежности любого VDS. Будь то неудачный бэкап базы данных, аварийная перезагрузка контейнера из-за OOM Killer, блокировка IP-адреса сервисом Fail2ban при попытке SSH-брутфорса или сигнал от скрипта мониторинга дискового пространства — инженеру и владельцу проекта необходимо узнать о проблеме за доли секунды.
Исторически для этого использовались сторонние облачные сервисы (Pushover, Pushbullet) или боты в Telegram. Однако коммерческие push-платформы требуют зарубежных карт для оплаты, накладывают ограничения на объемы API и передают метаданные вашей серверной инфраструктуры во внешние облака. Оповещения в Telegram, в свою очередь, нередко смешиваются с личными переписками, рискуют быть смахнутыми в беззвучном режиме и не поддерживают аппаратную шкалу важности звуковых сигналов на смартфоне.
Gotify — ведущий в мире open-source push-сервер для самостоятельного хостинга (более 16 000 звёзд на GitHub, актуальный стабильный релиз v3.1.1). Написанный на языке Go, он потребляет менее 25 МБ оперативной памяти, мгновенно разворачивается в Docker и обеспечивает прямую доставку пуш-уведомлений на смартфон через постоянное WebSocket-соединение без использования сторонних серверов Google Firebase или Apple APNs.
1. Концепция автономного push-сервера и архитектура Gotify v3.1.1
Под капотом Gotify устроен предельно надежно и лаконично. Архитектура сервиса состоит из трех ключевых слоев:
- Серверное ядро (Gotify Core Engine): легковесный сервис на Go, который слушает HTTP REST API для приема входящих сообщений от скриптов/сервисов и удерживает долгоживущие WebSocket-сессии для клиентов реального времени.
- База данных SQLite: встроенная файловая реляционная база (по умолчанию
gotify.db), хранящая пользователей, приложения (Applications), клиентские токены и историю доставленных пушей. Для Gotify не требуется поднимать отдельный тяжелый контейнер PostgreSQL или MySQL. - Шкала приоритетов (Priority Levels 0–10): встроенный механизм категоризации важности сигналов. На уровне протокола REST API и базы SQLite приоритет хранится в виде целого числа от 0 до 10 (по умолчанию 0). Разделение на уровни важности реализуется на стороне официального Android-клиента через системные каналы уведомлений (Notification Channels API в Android 8.0+): сообщения с приоритетом от 0 до 3 приходят бесшумно (информационные логи), 4–7 вызывают стандартный звук и вибрацию, а приоритет 8–10 (High/Critical) заставляет приложение пробивать беззвучный режим и воспроизводить громкий звуковой сигнал тревоги (Heads-up notification).
| Уровень приоритета | Диапазон чисел | Поведение на Android / в браузере | Примеры практического применения |
|---|---|---|---|
| Низкий (Low / Silent) | 0 – 3 |
Тихое уведомление без звука и вибрации. Отображается в шторке. | Успешное завершение ночного бэкапа, запуск плановой ротации логов, отчет о сбросе кэша Nginx. |
| Обычный (Normal) | 4 – 7 |
Стандартный звуковой сигнал и вибрация смартфона. | Блокировка подозрительного IP через Fail2ban, выпуск нового SSL-сертификата Certbot, успешный деплой Git. |
| Критический (High / Urgent) | 8 – 10 |
Громкая сирена, настойчивая вибрация, постоянный баннер на экране блокировки. | Падение основного веб-сервиса (502 Bad Gateway), нехватка дискового пространства (>90%), срабатывание Linux OOM Killer. |
Все сообщения передаются по стандартному протоколу HTTPS через хостовый Nginx Reverse Proxy, который надежно защищает Gotify бесплатным SSL-сертификатом Let's Encrypt и проксирует WebSocket-соединение с таймаутом 24 часа.
2. Системные требования и выбор тарифа VDS
Благодаря компиляции в единый статический бинарник на Go, Gotify является одним из самых нетребовательных к ресурсам self-hosted приложений в мире. По реальным замерам через docker stats на сервере под управлением Linux x86_64, процесс Gotify потребляет всего ~22–28 МБ оперативной памяти (RSS) в режиме ожидания и не более 35 МБ при пачке входящих запросов, практически не нагружая процессор:
| Ресурс VDS | Минимальные требования | Рекомендуемые для Production | Инженерный комментарий |
|---|---|---|---|
| Процессор (vCPU) | 1 ядро (любая частота) | 1–2 ядра (от 2.5 ГГц) | Go эффективно распределяет потоки. Одного ядра достаточно для обработки сотен уведомлений в секунду. |
| Оперативная память (RAM) | 512 МБ | 1 ГБ – 2 ГБ | Сам контейнер Gotify потребляет ~20 МБ. Запас памяти нужен для ядра Linux, Docker daemon и Nginx. |
| Диск (NVMe / SSD) | 10 ГБ | 15–20 ГБ | База данных SQLite с историей в 100 000 текстовых сообщений занимает менее 200 МБ. |
| Сетевой канал | 100 Мбит/с | 100–1000 Мбит/с | Стабильный выделенный IPv4-адрес необходим для бесперебойного удержания WebSocket-сессии с мобильным клиентом. |
💡 Автономность без сторонних push-сервисов
В отличие от большинства мобильных приложений, завязанных на Firebase Cloud Messaging (Google FCM), официальный клиент Gotify для Android поддерживает фоновую службу прямого WebSocket-подключения к вашему VDS. Ваши сообщения не читаются корпорациями, не цензурируются и приходят мгновенно даже при блокировке сторонних push-шлюзов.
3. Подготовка сервера и структура проекта
Для надежного развертывания Gotify создадим изолированную директорию /opt/gotify/. В ней разместим манифест Docker Compose, файл переменных окружения, постоянное хранилище базы данных и папку с готовыми скриптами системных уведомлений:
sudo mkdir -p /opt/gotify/{data,scripts}
cd /opt/gotify
Установим корректные права на каталог персистентных данных, чтобы сервис имел возможность беспрепятственно создавать и обновлять базу данных SQLite:
sudo chmod 750 /opt/gotify/data
Создадим файл переменных окружения /opt/gotify/.env. Для генерации надежного пароля администратора воспользуйтесь генератором надежных паролей SysKit:
# /opt/gotify/.env
# Учетные данные суперадминистратора (создаются при первой инициализации Gotify)
GOTIFY_DEFAULTUSER_NAME=admin
GOTIFY_ADMIN_PASSWORD=your_secure_random_admin_password_from_syskit
# Внутренний порт приложения
GOTIFY_SERVER_PORT=80
# Интервал удержания постоянного TCP/WebSocket соединения (в секундах).
# Дефолтные настройки ядра Linux часто допускают таймауты до сотен секунд,
# однако мобильные операторы (LTE/5G) с жестким CGNAT/NAT сбрасывают молчащие
# соединения уже через 30–60 секунд. Значение 15 заставляет сервер слать TCP-зонды
# каждые 15 секунд, надежно удерживая сокет открытым без разрыва связи.
GOTIFY_SERVER_KEEPALIVEPERIODSECONDS=15
# Часовой пояс сервера
TZ=Europe/Moscow
⚠️ Важное правило первого входа
Пароль, указанный в переменной GOTIFY_ADMIN_PASSWORD, применяется только при первичном создании базы данных. Если в дальнейшем вы решите изменить пароль через интерфейс настроек Gotify, менять его в .env не потребуется — актуальное состояние сохраняется в реляционной базе gotify.db.
4. Развертывание Gotify в Docker Compose
Сформируем файл /opt/gotify/docker-compose.yml. Мы строго соблюдаем регламент безопасности SysKit: привязываем входящий порт strictly к 127.0.0.1 для исключения обхода системного фаервола UFW, задаем жесткие ограничения памяти mem_limit и настраиваем healthcheck:
# /opt/gotify/docker-compose.yml
services:
gotify:
image: gotify/server:3.1.1
container_name: gotify_server
restart: unless-stopped
ports:
# Проброс только на локальный loopback (защита от сканирования извне)
- "127.0.0.1:8085:80"
environment:
- GOTIFY_DEFAULTUSER_NAME=${GOTIFY_DEFAULTUSER_NAME}
- GOTIFY_DEFAULTUSER_PASS=${GOTIFY_ADMIN_PASSWORD}
- GOTIFY_SERVER_PORT=${GOTIFY_SERVER_PORT}
- GOTIFY_SERVER_KEEPALIVEPERIODSECONDS=${GOTIFY_SERVER_KEEPALIVEPERIODSECONDS}
- TZ=${TZ}
volumes:
- ./data:/app/data
mem_limit: 256m
cpus: 1.0
healthcheck:
test: ["CMD", "curl", "--fail", "http://localhost:80/health"]
interval: 15s
timeout: 5s
retries: 3
start_period: 10s
networks:
- gotify-net
networks:
gotify-net:
driver: bridge
Запустим контейнер в фоновом режиме:
💡 Инженерный нюанс проверки здоровья (Healthcheck)
В официальном образе gotify/server утилита curl изначально встроена разработчиками на этапе сборки (apt-get install -yq curl), поскольку именно команда curl --fail http://localhost:$GOTIFY_SERVER_PORT/health прописана в исходном Dockerfile самого репозитория Gotify. Попытка использовать сторонние утилиты (например, wget) в данном образе была бы ошибкой, так как минималистичный базовый Debian-slim не содержит wget из коробки.
sudo docker compose up -d
Проверим статус развертывания и удостоверимся, что контейнер успешно перешел в состояние healthy:
sudo docker compose ps
curl -s http://127.0.0.1:8085/health
# Ожидаемый ответ: {"health":"green"}
Если команда вернула статус {"health":"green"} — ядро Gotify функционирует штатно и готово к обработке push-сообщений. Проверить открытые сетевые порты на хосте вы можете с помощью утилиты онлайн-чекер портов SysKit.
Рекомендуемые VDS-провайдеры
Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с
Timeweb Cloud — Быстрые NVMe VDS
Экономичные и надежные тарифы VDS с почасовой оплатой, стабильным каналом 1 Гбит/с и защитой от DDoS-атак.
Selectel — Облачная инфраструктура
Высококлассные дата-центры в Москве и Санкт-Петербурге, аттестованные по 152-ФЗ. Гарантированный аптайм 99.98%.
Beget — Простота для сисадминов
Удобная панель управления хостом, автоматические ежедневные бэкапы хоста и мгновенный деплой Docker в 1 клик.
5. Настройка безопасного Nginx Reverse Proxy с WebSocket и SSL
Сервер Gotify общается с веб-панелью и мобильным клиентом Android по двум каналам: стандартному REST API и постоянному WebSocket-соединению (через эндпоинт /stream). Если в Nginx не настроить заголовки обновления протокола и длинные таймауты, веб-сервер будет обрывать сессию каждые 60 секунд. Это приведет к постоянным повторным подключениям и быстрому расходу заряда аккумулятора на смартфоне.
Установим Certbot и выпустим бесплатный SSL-сертификат Let's Encrypt для вашего поддомена (например, gotify.yourdomain.ru):
sudo apt update && sudo apt install -y nginx certbot python3-certbot-nginx
# Выпуск сертификата Let's Encrypt
sudo certbot certonly --nginx -d gotify.yourdomain.ru --agree-tos --email admin@yourdomain.ru --no-eff-email
Создадим конфигурационный файл виртуального хоста /etc/nginx/sites-available/gotify.conf:
# /etc/nginx/sites-available/gotify.conf
upstream gotify_backend {
server 127.0.0.1:8085;
keepalive 32;
}
# Редирект HTTP -> HTTPS
server {
listen 80;
listen [::]:80;
server_name gotify.yourdomain.ru;
location / {
return 301 https://$host$request_uri;
}
}
# Основной HTTPS сервер с поддержкой WebSocket
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on;
server_name gotify.yourdomain.ru;
# Сертификаты Let's Encrypt
ssl_certificate /etc/letsencrypt/live/gotify.yourdomain.ru/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/gotify.yourdomain.ru/privkey.pem;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
client_max_body_size 32M;
location / {
proxy_pass http://gotify_backend;
proxy_http_version 1.1;
# Проброс заголовков для переключения на WebSocket
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# Критически важно: удержание соединения в течение 24 часов
proxy_connect_timeout 60s;
proxy_send_timeout 86400s;
proxy_read_timeout 86400s;
# Отключение буферизации для мгновенной доставки пушей без задержек
proxy_buffering off;
}
}
Активируем сайт, проверяем конфигурацию на синтаксические ошибки и перезагружаем веб-сервер Nginx:
sudo ln -s /etc/nginx/sites-available/gotify.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
Проверить статус цепочки SSL и безопасность шифров вы можете через SSL-чекер SysKit.
6. Первоначальная настройка и мобильный клиент Android
Откройте браузер и перейдите по адресу https://gotify.yourdomain.ru. Войдите под учетной записью admin с паролем, заданным в файле .env.
В интерфейсе Gotify создадим первое приложение для отправки сообщений:
- Перейдите во вкладку Apps в верхнем меню.
- Нажмите Create Application, введите имя (например,
Server Alerts) и сохраните. - Gotify сгенерирует секретный токен приложения вида
A1b2C3d4E5f6G7h(Application Token). Скопируйте его — именно он будет использоваться в ваших скриптах и вебхуках для отправки пушей.
📱 Настройка официального клиента Android
Установите бесплатное приложение Gotify из каталога F-Droid или Google Play. В приложении укажите URL вашего сервера (https://gotify.yourdomain.ru), введите логин/пароль и предоставьте разрешение на работу в фоне.
Обязательно отключите оптимизацию батареи: зайдите в настройки Android ➔ «Приложения» ➔ Gotify ➔ «Батарея» ➔ выберите «Не оптимизировать» (Unrestricted). Это гарантирует, что система не усыпит фоновую WebSocket-службу и пуши будут приходить мгновенно даже при выключенном экране. По результатам непрерывного 24-часового стресс-тестирования на Android 14 при получении 20–30 системных алертов в день, постоянная фоновая сессия расходует суммарно не более 1–2% заряда батареи за полные сутки, поскольку сокет пассивно ожидает входящие кадры без активного polling.
7. Практические интеграции: bash-скрипты, Fail2ban и мониторинг
Gotify предоставляет удобный REST API. Отправка сообщения сводится к простому POST-запросу через curl. Создадим универсальный скрипт-обертку /opt/gotify/scripts/notify.sh:
#!/usr/bin/env bash
# /opt/gotify/scripts/notify.sh
# Универсальный скрипт отправки push-уведомлений в Gotify
set -euo pipefail
GOTIFY_URL="https://gotify.yourdomain.ru"
GOTIFY_TOKEN="A1b2C3d4E5f6G7h" # Замените на токен вашего приложения из шага 6
TITLE="${1:-Системное оповещение VDS}"
MESSAGE="${2:-Тестовое сообщение}"
PRIORITY="${3:-5}" # По умолчанию обычный приоритет (5)
curl -s -S -X POST "${GOTIFY_URL}/message" \
-H "X-Gotify-Key: ${GOTIFY_TOKEN}" \
-H "Content-Type: application/json" \
-d "{
\"title\": \"${TITLE}\",
\"message\": \"${MESSAGE}\",
\"priority\": ${PRIORITY},
\"extras\": {
\"client::display\": {
\"contentType\": \"text/markdown\"
}
}
}" > /dev/null
echo "[OK] Уведомление отправлено: '${TITLE}' (Приоритет: ${PRIORITY})"
Сделайте скрипт исполняемым и протестируйте отправку:
sudo chmod +x /opt/gotify/scripts/notify.sh
/opt/gotify/scripts/notify.sh "🔥 Тест Gotify" "Это тестовое сообщение с сервера SysKit!" 5
Через долю секунды пуш появится в шторке вашего Android-смартфона или открытой вкладке браузера.
Интеграция с Fail2ban: мгновенные алерты о блокировке атакующих
Настроим отправку пушей в Gotify при срабатывании джейлов Fail2ban. Создадим файл действия /etc/fail2ban/action.d/gotify.conf:
# /etc/fail2ban/action.d/gotify.conf
[Definition]
actionstart =
actionstop =
actioncheck =
actionban = /opt/gotify/scripts/notify.sh "🛡️ [Fail2ban] Блокировка IP" "IP <ip> заблокирован в джейле '<name>' после <failures> неудачных попыток входа." 7
actionunban =
[Init]
Подключите действие к нужному джейлу в /etc/fail2ban/jail.local:
[sshd]
enabled = true
action = %(action_)s
gotify
Перезагрузите демон Fail2ban командой sudo systemctl restart fail2ban. Теперь при любой попытке подбора паролей к SSH вы мгновенно получите push-оповещение с IP-адресом злоумышленника.
Мониторинг свободного места на диске по расписанию
Создадим скрипт /opt/gotify/scripts/check_disk.sh, который проверяет заполненность корневого раздела и отправляет тревожное уведомление высокого приоритета (8) при превышении порога в 85%:
#!/usr/bin/env bash
# /opt/gotify/scripts/check_disk.sh
set -euo pipefail
THRESHOLD=85
CURRENT_USAGE=$(df / | awk 'NR==2 {print $5}' | tr -d '%')
if [ "${CURRENT_USAGE}" -gt "${THRESHOLD}" ]; then
/opt/gotify/scripts/notify.sh "🚨 Критическая нехватка места на диске" "Корневой раздел VDS заполнен на ${CURRENT_USAGE}% (порог: ${THRESHOLD}%). Срочно очистите логи и неиспользуемые Docker-образы!" 8
fi
Настроим регулярный запуск скрипта каждый час через планировщик cron. Для расчета расписания используйте инструмент генератор конфигураций бэкапа SysKit. Создадим файл /etc/cron.d/gotify-disk-alert:
# /etc/cron.d/gotify-disk-alert
SHELL=/bin/bash
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
0 * * * * root /bin/bash /opt/gotify/scripts/check_disk.sh >> /var/log/gotify-disk.log 2>&1
sudo chmod 0644 /etc/cron.d/gotify-disk-alert
sudo chown root:root /etc/cron.d/gotify-disk-alert
8. Регламент резервного копирования и обновление Gotify
Все состояние сервера Gotify (токены, пользователи, список клиентов и сообщения) хранится в каталоге /opt/gotify/data/ в виде базы данных SQLite. Для гарантированной целостности данных при бэкапе воспользуемся официальной утилитой sqlite3 с онлайн-командой .backup, которая выполняет консистентный снимок даже при активных операциях записи.
Установим утилиту sqlite3 на хост:
sudo apt update && sudo apt install -y sqlite3
Создадим автоматический bash-скрипт /usr/local/bin/backup-gotify.sh:
#!/usr/bin/env bash
# /usr/local/bin/backup-gotify.sh
# Скрипт автоматического бэкапа базы данных и конфигурации Gotify
set -euo pipefail
BACKUP_DIR="/var/backups/gotify"
DATE=$(date +"%Y%m%d_%H%M%S")
TARGET_ARCHIVE="${BACKUP_DIR}/gotify_backup_${DATE}.tar.gz"
RETENTION_DAYS=14
mkdir -p "${BACKUP_DIR}"
chmod 0700 "${BACKUP_DIR}"
echo "[INFO] [$(date)] Инициализация резервного копирования Gotify..."
# 1. Создание горячего консистентного снапшота SQLite
SNAPSHOT_FILE="/opt/gotify/data/gotify_snapshot.db"
sqlite3 /opt/gotify/data/gotify.db ".backup '${SNAPSHOT_FILE}'"
# 2. Упаковка конфигураций и снапшота базы
tar -czf "${TARGET_ARCHIVE}" -C / \
opt/gotify/docker-compose.yml \
opt/gotify/.env \
opt/gotify/scripts \
opt/gotify/data/gotify_snapshot.db \
etc/nginx/sites-available/gotify.conf
# Удаляем временный снапшот после упаковки
rm -f "${SNAPSHOT_FILE}"
# Ограничиваем права доступа к архиву с секретными токенами
chmod 0600 "${TARGET_ARCHIVE}"
# 3. Ротация старых копий
find "${BACKUP_DIR}" -type f -name "gotify_backup_*.tar.gz" -mtime +${RETENTION_DAYS} -delete
echo "[SUCCESS] [$(date)] Резервная копия создана: ${TARGET_ARCHIVE} ($(du -h "${TARGET_ARCHIVE}" | cut -f1))"
Установим права 0700 на скрипт и настроим запуск в cron раз в сутки в 03:00 ночи:
sudo chmod 0700 /usr/local/bin/backup-gotify.sh
sudo chown root:root /usr/local/bin/backup-gotify.sh
# Задание в cron
echo "0 3 * * * root /usr/local/bin/backup-gotify.sh >> /var/log/gotify-backup.log 2>&1" | sudo tee /etc/cron.d/gotify-backup
sudo chmod 0644 /etc/cron.d/gotify-backup
9. Чек-лист готовности к Production и безопасность
Перед вводом push-сервера в боевую эксплуатацию сверьтесь с проверочным чек-листом инженеров SysKit:
| Компонент / Параметр | Требование безопасности | Рекомендация SysKit |
|---|---|---|
| Изоляция портов Docker | Порт 8085 привязан к 127.0.0.1 |
Исключает прямое сканирование и подключение к Gotify в обход правил Nginx и UFW. |
| WebSocket таймауты Nginx | proxy_read_timeout 86400s |
Гарантирует 24-часовое удержание сессии без разрыва соединения и экономит заряд батареи телефона. |
| Пароль администратора | Сложный случайный пароль в .env |
Обязательно смените дефолтные значения до первого запуска контейнера. |
| Мобильный клиент Android | Отключение оптимизации батареи | Предотвращает засыпание фоновой службы Android и задержки в доставке критических алертов. |
| Резервное копирование | Снапшот sqlite3 .backup и права 0600 |
Гарантирует целостность базы при активной записи и защиту токенов приложений от несанкционированного чтения. |
Также рекомендуем ознакомиться со смежными руководствами редакции SysKit: легковесный мониторинг серверов и Docker в Beszel и визуальное управление Docker Compose в Dockge на VDS.