Files
glchat/.env.example
T
grendervill 7afd23d6d4 feat(push): Web Push — VAPID, подписки устройств и отправка (AGENT.md 7.16)
Уведомления в браузере и на телефоне: сервер сам решает, кому их слать, и
подписывает запрос VAPID-ключом, поэтому уведомление приходит, даже когда
клиент закрыт.

Сервер:
- миграция 00021: `push_subscriptions` (эндпоинт уникален, ключи, счётчик
  неудач, время последней доставки);
- `internal/push` — VAPID-ключи (приватный PKCS#8 из конфига, публичный
  выводится из него), правила уведомлений повторяют
  `web/src/lib/desktopNotifications.ts` (упоминания и личные беседы, без своих
  и системных сообщений), очередь доставки, TTL 12 часов, Topic по комнате;
- 404/410 от push-сервиса удаляют подписку сразу, 5 неудач подряд — тоже,
  иначе копились бы мёртвые эндпоинты; retention чистит «молчащие» подписки;
- `internal/httpx/safeurl.go` — общий запрет внутренних адресов с проверкой
  адреса в момент подключения (DNS rebinding): эндпоинт подписки приходит от
  клиента, и без проверки сервер сам себе организует SSRF;
- `internal/gateway/presence.go` — `IsUserOnline`: если получатель в клиенте,
  уведомление покажет клиент, дублировать на телефон не нужно;
- ручки `GET /push/config`, `GET|POST|DELETE /push/subscriptions`, лимиты
  10 подписок и 20 уведомлений в минуту; ключ p256dh проверяется как настоящая
  точка P-256;
- установщик генерирует `VAPID_PRIVATE_KEY` (openssl, PKCS#8 DER в base64) и
  `VAPID_SUBJECT`, ключ переиспользуется при переустановке; для ручной установки
  есть `glchat vapid-keys`; `features.web_push_enabled` виден в `/meta`.

Тесты: правила и VAPID, доставка с поддельным push-эндпоинтом (шифрование,
заголовки VAPID/TTL/Topic, очистка мёртвых подписок), ручки и лимиты, отправка
при личном сообщении и упоминании, пропуск онлайн-получателей, миграция на
чистой БД.
2026-09-26 16:14:20 +03:00

65 lines
4.5 KiB
Bash

# glchat — пример окружения приложения.
# Реальный .env генерирует deploy/install.sh (права 600, не коммитится).
# Переменные приложения (читает internal/config), дефолты — в скобках.
# --- инстанс ---
DOMAIN=chat.example.com # домен инстанса (localhost)
FILES_DOMAIN=files.chat.example.com # поддомен пользовательского контента (files.$DOMAIN)
INSTANCE_NAME=glchat # название инстанса в /api/v1/meta
LISTEN_ADDR=127.0.0.1:8080 # адрес прослушивания (127.0.0.1:8080)
DATA_DIR=/opt/glchat/data # данные: db/, files/, backups/
WEB_ROOT=/app/web # собранный веб-клиент (SPA)
DATABASE_PATH= # по умолчанию $DATA_DIR/db/glchat.db
# --- логи ---
LOG_LEVEL=info # debug | info | warn | error
LOG_FORMAT=json # json | text
# --- SQLite (профиль производительности, AGENT.md 10.10) ---
SQLITE_READ_POOL=4 # размер пула чтения (2 для lite)
SQLITE_CACHE_SIZE=-8000 # КБ, отрицательное значение = КиБ (8 МБ)
SQLITE_MMAP_SIZE=134217728 # 128 МБ
GOMAXPROCS=2 # ограничение CPU для Go-рантайма (1 для lite)
# --- лимиты ---
MAX_UPLOAD_SIZE=26214400 # байт, по умолчанию 25 МБ (профиль)
SHUTDOWN_TIMEOUT_SECONDS=20 # graceful shutdown
DB_MAINTENANCE_INTERVAL_SECONDS=21600 # PRAGMA optimize раз в 6 часов
# --- чистка данных (Фаза 5) ---
RETENTION_INTERVAL_SECONDS=3600 # как часто запускать чистку (час)
RETENTION_AUDIT_DAYS=180 # сколько дней хранить журнал аудита (0 — всегда)
RETENTION_ORPHAN_HOURS=24 # через сколько часов удалять файлы без ссылок (0 — никогда)
# --- секреты (генерируются установщиком, никогда не коммитить) ---
SESSION_PEPPER= # HMAC-pepper перед Argon2id
MASTER_KEY= # AES-256-GCM для PII (hex, 32 байта)
TOTP_ENCRYPTION_KEY= # шифрование TOTP-секретов
WEBHOOK_SECRET= # подпись вебхуков
LIVEKIT_API_KEY= # ключ LiveKit (фаза 3)
LIVEKIT_API_SECRET= # секрет LiveKit (фаза 3)
# --- OAuth-провайдеры (Фаза 7): вход через внешние сервисы ---
# Пусто — провайдер выключен, ручка входа отвечает oauth.provider_not_configured.
# Адрес возврата для настроек приложения у провайдера:
# <домен>/api/v1/auth/oauth/<github|google|discord>/callback
OAUTH_GITHUB_CLIENT_ID=
OAUTH_GITHUB_CLIENT_SECRET=
OAUTH_GOOGLE_CLIENT_ID=
OAUTH_GOOGLE_CLIENT_SECRET=
OAUTH_DISCORD_CLIENT_ID=
OAUTH_DISCORD_CLIENT_SECRET=
# Необязательно: внешний адрес инстанса для redirect_uri (пусто — берётся из DOMAIN).
OAUTH_REDIRECT_BASE=
# --- Web Push (Фаза 7): уведомления в браузере и на телефоне ---
# Приватный VAPID-ключ (P-256) в PKCS#8 DER (base64, одной строкой). Пусто —
# Web Push выключен. Ключ генерирует установщик; вручную — `glchat vapid-keys`.
VAPID_PRIVATE_KEY=
# Контакт администратора для push-сервисов (mailto:admin@<домен> или https://…).
VAPID_SUBJECT=
AGE_RECIPIENT= # публичный age-ключ для шифрования бэкапов
BACKUP_KEEP_DAYS= # сколько дней хранить бэкапы (профиль задаёт значение)
BACKUP_OFFSITE_TARGET= # необязательно: rsync-цель (user@host:/path) или rclone:remote:path
BACKUP_OFFSITE_KEEP_DAYS= # необязательно: чистить копии на приёмнике старше N дней (rclone)