grendervill
a9b1073877
Сервер сам загружает заголовок, описание и картинку страницы по ссылке из сообщения и отдаёт клиенту готовую карточку. Безопасность (главное здесь): - только http/https и без userinfo; запрет петли, частных сетей, link-local (169.254.169.254), CGNAT, multicast и IPv4-mapped вариантов; - проверка идёт по адресу, к которому реально открывается TCP (`net.Dialer.Control`), поэтому подмена DNS между проверкой и соединением (DNS rebinding) ничего не даёт; - не больше 3 редиректов, каждый хоп проверяется заново; таймаут 5 с, тело ≤ 512 КБ, только `text/html`; прокси из окружения игнорируются, cookie и авторизация не отправляются; в логи попадают только хост и код причины; - картинка по ссылке не скачивается — проверяется лишь её URL: экономия CPU на 1 vCPU и минус класс атак через декодирование. Кэш: таблица `link_previews` (миграция 00022, ключ — sha256 нормализованного URL), TTL по статусу (ok — сутки, empty/blocked — час, error — 10 минут). Ручка `GET /api/v1/link-previews?url=…` отвечает статусом (ok/empty/blocked/error) и карточкой только при ok; 20 новых загрузок в минуту на пользователя, кэшированные ответы лимит не тратят. `UNFURL_ENABLED=false` выключает функцию целиком, `features.unfurl_enabled` виден в `/meta`. Retention убирает истёкшие записи кэша. Тесты: 21 в `internal/unfurl` (включая DNS rebinding через локальный DNS-сервер, редирект во внутреннюю сеть, таймаут, лимиты размера и типа), ручки, store и миграция.
70 lines
4.7 KiB
Bash
70 lines
4.7 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=
|
|
|
|
|
|
# --- превью ссылок (Фаза 7) ---
|
|
UNFURL_ENABLED=true # сервер сам загружает превью страниц по ссылкам
|
|
UNFURL_TIMEOUT_SECONDS=5 # таймаут загрузки превью
|
|
|
|
AGE_RECIPIENT= # публичный age-ключ для шифрования бэкапов
|
|
BACKUP_KEEP_DAYS= # сколько дней хранить бэкапы (профиль задаёт значение)
|
|
BACKUP_OFFSITE_TARGET= # необязательно: rsync-цель (user@host:/path) или rclone:remote:path
|
|
BACKUP_OFFSITE_KEEP_DAYS= # необязательно: чистить копии на приёмнике старше N дней (rclone)
|