Gotify

Gotify - self-hosted сервер push-уведомлений. Скрипт, cron, мониторинг или CI делают POST на ваш сервер, и сообщение прилетает в Android-приложение и веб-интерфейс - без Firebase, Telegram и чужого SaaS.

Главное в устройстве - модель данных. У пользователя есть приложения (только отправляют, токен с префиксом A) и клиенты (только читают: телефон, браузер, скрипт; токен C). Чужие ленты не видны, самозапись выключена, сообщения хранятся в базе.

С 3.0.0 (июль 2026) - вход через OIDC, session elevation (повторный пароль перед опасными действиями), токены показываются один раз. 3.1.0 (27 августа 2026) довела SSO: локальные пароли можно выключить, администраторы - из группы IdP.

Границы: клиент только Android (Google Play и F-Droid), на iPhone - веб без системных пушей; каналов e-mail и SMS нет; русской локализации нет, кириллица в сообщениях работает.

Веб-интерфейс - три экрана: Messages, Apps и Clients, плюс Users для администратора. На стенде мы завели два приложения, «Мониторинг сервера» и «CI/CD Pipeline», и отправили через API три сообщения с разными приоритетами.

Экран Apps - «кто имеет право писать». Приложение на каждый источник: утек токен - отзывается один источник, а не весь доступ. С 3.x токен виден один раз при создании; ротация есть, подсмотреть старый нельзя.

Экран Clients - «кто имеет право читать». Вход в веб-интерфейс создает клиент на 7 дней; отметка Elevation ends 59 минут - это session elevation: через час опасное действие снова попросит пароль. Basic-auth для скриптов считается поднятой всегда.

Пользователей заводит администратор; обычный пользователь чужих приложений не видит. «Кто получает алерты с прода» - это список в Users, а не память о том, кого добавили в чат.

Одному человеку self-hosting не про экономию: Pushover стоит 4,99 $ разово. Аргумент появляется в команде: Pushover for Teams - 5 $ за пользователя в месяц, на десятерых 600 $ в год; хостед-ntfy.sh - 6-25 $ в месяц. Gotify на CPU2-RAM4-DISK50 за 500 ₽ в месяц обслуживает весь отдел.

Gotify или ntfy

Разница в модели по умолчанию. В ntfy топики открыты: кто знает имя, тот пишет и читает, публикация без регистрации; есть iOS и UnifiedPush. В Gotify все закрыто с первого запуска. Один человек - ntfy; команда с учетками и SSO - Gotify; команда на iPhone - ntfy при любом раскладе.

Один бинарь на Go: REST API, WebSocket-стрим /stream, React-интерфейс и встроенный SQLite. Внешних зависимостей нет - ни Redis, ни SMTP, ни исходящих вызовов. База - файл data/gotify.db в томе /app/data, там же иконки; опционально MySQL или PostgreSQL.

Конфигурация с 3.x - только переменные GOTIFY_*, каждая умеет суффикс _FILE для Docker secrets; config.yml больше нет. Android-приложение держит WebSocket само, без Firebase: отсюда приватность и постоянное соединение на телефоне.

В compose два контейнера: gotify (gotify/server:3.1.0, 211 MB, наружу только 127.0.0.1:8080) и caddy (caddy:2, 88,7 MB, публичные 80 и 443, Let's Encrypt). Есть зеркало ghcr.io/gotify/server. Тег закрепляем: между 2.x и 3.x обновление ломающее.

1. Создать VM и поставить Docker

   Тариф CPU2-RAM4-DISK50, Ubuntu 24.04 LTS. На чистом образе Docker нет; Engine и compose-плагин из официального репозитория docs.docker.com встали за 15 секунд.

2. Написать compose.yml и Caddyfile

   Пароль администратора сгенерируйте до первого запуска: он применяется только при создании базы. Домен к этому моменту должен указывать на IP сервера.

   sudo mkdir -p /opt/gotify/{gotify_data,caddy_data,caddy_config}
   sudo chown -R $USER:$USER /opt/gotify && cd /opt/gotify
   openssl rand -base64 18   # это будет GOTIFY_DEFAULTUSER_PASS
   
   cat > compose.yml <<'EOF'
   services:
     gotify:
       image: gotify/server:3.1.0
       restart: unless-stopped
       environment:
         GOTIFY_DEFAULTUSER_NAME: admin
         GOTIFY_DEFAULTUSER_PASS: "СЮДА_СГЕНЕРИРОВАННЫЙ_ПАРОЛЬ"
         GOTIFY_SERVER_SECURECOOKIE: "true"
         GOTIFY_SERVER_TRUSTEDPROXIES: "172.16.0.0/12"
         GOTIFY_REGISTRATION: "false"
         TZ: "Europe/Moscow"
       ports: ["127.0.0.1:8080:80"]
       volumes: ["./gotify_data:/app/data"]
     caddy:
       image: caddy:2
       restart: unless-stopped
       ports: ["80:80", "443:443"]
       volumes: ["./Caddyfile:/etc/caddy/Caddyfile", "./caddy_data:/data", "./caddy_config:/config"]
   EOF
   printf 'gotify.example.com {\n    reverse_proxy gotify:80\n}\n' > Caddyfile

   SECURECOOKIE=true - cookie сессии только по HTTPS, по голому http после этого не войти. TRUSTEDPROXIES - кому верить в X-Forwarded-For: Caddy приходит из docker-сети (на стенде 172.18.0.0/16), поэтому /12 с запасом. reverse_proxy gotify:80 - по имени сервиса, не localhost; почему - в граблях.

3. Поднять стек

   sudo docker compose pull && sudo docker compose up -d
   curl -s https://gotify.example.com/version    # {"version":"3.1.0",...}

   Образы скачались за 9,1 с с третьей попытки: первые две (32,7 и 37,1 с) оборвал таймаут Docker Hub. От up -d до контейнеров - 1,7 с, ответ 200 на loopback - через 3,8 мс, сертификат Let's Encrypt - за 1,5 с.

4. Завести учетки и отправить первое сообщение

   Первый вход - admin и пароль из compose.yml. Учетки инженерам - в Users (или POST /user с Basic-auth администратора); каждый создает приложение в Apps, токен показывается один раз. Дальше - сообщение от имени приложения:

   curl -sS -X POST https://gotify.example.com/message \
     -H "X-Gotify-Key: ТОКЕН_ПРИЛОЖЕНИЯ" \
     -F "title=Диск заполнен на 92%" -F "message=Свободно 3.8 ГБ из 50" -F "priority=8"

   Сообщение появляется в ленте и на телефоне в момент запроса - клиенты держат WebSocket. Инженер ставит Android-приложение и вводит адрес сервера с логином; клиент создается сам.

С 3.0.0 Gotify входит через любой OpenID Connect провайдер с PKCE: апстрим называет Authelia, Dex и Keycloak, Authentik сюда тоже попадает. Нужны issuer, client id и secret из IdP и callback, который заканчивается на /auth/oidc/callback.

      GOTIFY_OIDC_ENABLED: "true"
      GOTIFY_OIDC_ISSUER: "https://auth.example.com/realms/myrealm"   # Keycloak realm
      GOTIFY_OIDC_CLIENTID: "gotify"
      GOTIFY_OIDC_CLIENTSECRET_FILE: "/run/secrets/oidc_secret"
      GOTIFY_OIDC_REDIRECTURL: "https://gotify.example.com/auth/oidc/callback"
      GOTIFY_OIDC_GROUPS_CLAIM: "groups"
      GOTIFY_OIDC_GROUPS_USER: "devops"
      GOTIFY_OIDC_GROUPS_ADMIN: "devops-admins"
      GOTIFY_LOCALAUTH_ENABLED: "false"

GOTIFY_OIDC_AUTOREGISTER (по умолчанию true) создает пользователя при первом входе: новому инженеру достаточно попасть в группу в Keycloak. GROUPS_USER и GROUPS_ADMIN (3.1) решают, кто входит и кто администратор; права пересчитываются при каждом входе.

GOTIFY_LOCALAUTH_ENABLED=false выключает пароли совсем. Для Android-приложения у провайдера регистрируется второй redirect gotify://oidc/callback. Как поднять провайдер - в разборах Keycloak и Authentik.

Отправка - POST /message с токеном приложения в заголовке X-Gotify-Key и полями title, message, priority. Ни SDK, ни регистрации отправителя - поэтому Gotify стал стандартным адресатом для алертов в self-hosted-мире.

Из нашей базы знаний штатно шлют Uptime Kuma (встроенный провайдер), Beszel (через Shoutrrr) и n8n (HTTP-нода). Для cron - curl или gotify push -t "Бэкап" -p 5 "Готово".

Приоритет решает, насколько заметным будет уведомление: бэкапы - низкий, «диск заполнен» - высокий. Чего нет: входящих вебхуков в произвольном формате - Prometheus Alertmanager напрямую не умеет, нужен n8n или адаптер.

Проверено на Gotify v3.1.0, сентябрь 2026. На новых версиях результаты могут отличаться.

Релизы - GitHub Releases, есть SECURITY.md; 3.1.0 закрыл advisory GHSA-78w7-2h8c-8252. Обновление в пределах 3.x - смена тега и перезапуск; с 2.x - только по странице «Migrate to 3.x».

cd /opt/gotify && sudo docker compose stop gotify
sudo tar czf ~/gotify-$(date +%F).tgz -C /opt/gotify gotify_data
sed -i 's/gotify\/server:3.1.0/gotify\/server:НОВАЯ_ВЕРСИЯ/' compose.yml
sudo docker compose pull && sudo docker compose up -d

Бэкап - один каталог gotify_data: gotify.db (пользователи, история, хэши токенов) и images с иконками. Либо короткая остановка и tar, как выше, либо sqlite3 gotify.db ".backup copy.db" на горячую. Восстановление - положить каталог рядом с compose.yml; токены переедут с базой.

Что закрыть перед продом:

• GOTIFY_DEFAULTUSER_PASS задан до первого запуска и не равен admin;
• приложение слушает только 127.0.0.1:8080, наружу - Caddy с TLS, SECURECOOKIE=true, TRUSTEDPROXIES покрывает прокси;
• REGISTRATION остается false; одно приложение на источник, токены в скриптах - из secrets;
• тег образа закреплен; бэкап gotify_data по расписанию и хотя бы раз проверен восстановлением.

• ntfy - сосед по полке: открытые топики, curl без регистрации, iOS и UnifiedPush. Один человек или команда на iPhone - туда.
• Uptime Kuma, Beszel - основные отправители; на CPU2-RAM4-DISK50 все три живут на одной машине.
• Keycloak, Authentik - OIDC-провайдеры для входа команды: группы IdP становятся правами в Gotify.
• n8n - адаптер для всего, что не умеет слать само: Alertmanager, вебхуки GitLab, почта на входе.