# Обновления, резервные копии и восстановление ## Перед обновлением Зафиксируйте текущий commit/digest образа, список миграций, адрес БД, путь uploads и предыдущий успешный релиз. Сделайте согласованную резервную копию БД и файлов вне сервера. Секреты храните отдельно с ограниченным доступом. Проверьте восстановление копии на отдельной среде. Миграции E2EE/парольного восстановления меняют протоколы клиента и сервера. Порядок перехода старых устройств описан в [E2EE](e2ee.md) и [восстановлении](password-recovery.md). Старые ключи, которых нет ни на устройстве, ни в архиве, сервер восстановить не может. ## Порядок релиза 1. Собрать и проверить конкретную ревизию, сохранить digest образа. 2. Проверить совместимость миграций с работающим кодом; при необходимости остановить запись. 3. Применить миграции тем же артефактом через `--migrate-only`. Не запускать конкурирующие миграции. 4. Запустить API с постоянными каталогами и нужным runtime. 5. Проверить внешний `/server/ready`, вход и refresh, историю, старое вложение, новый файл и WSS. 6. Проверить восстановление на новом устройстве и реальный push, если они входят в релиз. VPS-скрипт сериализует деплои, но автоматического отката БД нет. Если миграция завершилась ошибкой, схема уже могла измениться; сначала выясните состояние. [Команды VPS и возврат образа](vps-deployment.md). ## Что сохранять | Ресурс | Для чего нужен | | --- | --- | | PostgreSQL | Пользователи, сообщения, права, сессии, архивы ключей и ссылки на файлы | | `uploads` | Сами бинарные вложения, аватары, медиа реакций | | Runtime-секреты и конфигурация | Подключение, подпись JWT, хеширование refresh, Firebase, домен | | Образ и конфигурация релиза | Повторяемый запуск совместимой версии | | Пользовательский код/пароль и доверенное устройство | Расшифровка архива E2EE; операторская копия БД их не заменяет | Логи полезны для расследования, но не заменяют БД. Ограничьте их срок хранения и следите за размером: журналы могут содержать идентификаторы и внутренние ошибки. Не публикуйте runtime.env, токены и зашифрованные архивы в открытых обращениях поддержки. ## Восстановление после потери сервера 1. Поднимите изолированную среду и совместимый образ. 2. Восстановите согласованные копии БД и uploads; проверьте пути и права записи. 3. Восстановите runtime-конфигурацию. Смена JWT-секрета инвалидирует подпись старых токенов; смена `EncryptionOption:Secret` нарушает поиск старых refresh-хешей и требует нового входа. 4. Убедитесь, что миграции соответствуют коду, проверьте ready и пользовательские сценарии. 5. Переключите трафик после проверки. Не подключайте тестовое восстановление к production Firebase без намерения отправлять уведомления. Отключённый Firebase использует NullPushProvider и считает задачи обработанными; это не буфер для отложенной доставки. После восстановления старой БД push-задачи могут повториться: клиент дедуплицирует по messageId. ## Несколько экземпляров OnlineUserStore, ConnectionStore, SRP challenge и rate limiter локальны процессу. Несколько реплик требуют согласования SignalR/presence, маршрутизации/общего одноразового хранилища challenge и общих файлов. Одна только общая PostgreSQL не обеспечивает такую согласованность. ## Миграции сообщений и привилегий Перед запуском версии с ответами/пересылками и Govor+ примените MessagingAndUserBenefits и UserBenefitsRevision обычным способом проекта: `dotnet run --project Govor.API -- --migrate-only`. Добавляются nullable-поля происхождения пересылки в Messages, таблица UserBenefits и её ревизия. Старые сообщения и пользователи сохраняются; специальные права автоматически не назначаются.