Обслуживание
Плановое обслуживание обычно сводится к обновлению образов, проверке миграций, логов и резервных копий. Подробная инструкция по автоматическим ZIP-бэкапам и восстановлению вынесена в бэкапы и восстановление.
Режим обслуживания пользователей
Заголовок раздела «Режим обслуживания пользователей»Если Remnawave недоступна или запланированы работы, откройте в админке
Система → Настройки → Общие, включите Режим обслуживания
и сохраните изменения. Настройка применяется без перезапуска. По умолчанию
MAINTENANCE_MODE_ENABLED=False; её также можно задать в .env, но сохранённое
переопределение из админки имеет приоритет.
Пользователи Telegram-бота получают сообщение о работах с просьбой попробовать
позже. Mini App показывает экран обслуживания с кнопкой повторной попытки,
а пользовательские API возвращают 503 с кодом maintenance_mode.
Администраторы сохраняют доступ к приложению и настройкам. Уведомления
платёжных провайдеров и проверка уже созданных платежей продолжают обрабатываться.
Ручной переключатель действует независимо от автоматики: после плановых работ выключите его и сохраните настройки.
Автоматическое обслуживание при недоступности панели
Заголовок раздела «Автоматическое обслуживание при недоступности панели»В том же разделе можно включить Автообслуживание при недоступности панели
(MAINTENANCE_MODE_AUTO_ENABLED). По умолчанию функция выключена. Задержка
MAINTENANCE_MODE_AUTO_DELAY_SECONDS задаёт минимальное время непрерывно
наблюдаемой недоступности; значение по умолчанию — 60 секунд, допустимо от 0
до 86400. Ноль включает режим после первой неудачной проверки.
Worker напрямую проверяет API панели каждые 15 секунд. Краткий сбой, завершившийся до истечения задержки, не закрывает приложение. Когда задержка истекла, Telegram-бот и Mini App используют тот же экран и ограничения обслуживания, что при ручном включении. Доступ администраторов, уведомления провайдеров и обработка уже начатых платежей сохраняются.
Первый успешный ответ панели снимает только автоматическое ограничение.
Ручной MAINTENANCE_MODE_ENABLED не изменяется. Администраторы с привязанным
Telegram получают уведомления о включении автоматического режима и восстановлении
панели; постоянный сбой не создаёт повторное уведомление на каждой проверке.
Без настроенного Telegram контроль панели продолжает работать без уведомлений.
Настройки применяются без перезапуска. Для проверки нужен работающий worker;
его состояние хранится в общей БД. Если проверки прекратились более чем на
90 секунд, устаревшее автоматическое ограничение перестаёт действовать.
Ручной режим при этом сохраняется. При возобновлении проверок отсчёт длительного
неподтверждённого сбоя начинается заново. В режиме dry_run и без адреса панели
автоматика не включается. Выключение функции сразу снимает автоматическое
ограничение, а служебное состояние очищается на ближайшей проверке worker.
Обновление
Заголовок раздела «Обновление»Место на диске и системный журнал
Заголовок раздела «Место на диске и системный журнал»В новых Compose-профилях журналы контейнеров ротируются автоматически: три файла по 10 МБ на контейнер. Настройки и область действия описаны в разделе деплоя.
Периодически проверяйте свободное место и размер системного журнала:
На небольшом сервере с systemd администратор может отдельно ограничить
journald. Следующий пример действует на весь сервер, включая другие
приложения; установщик Minishop не меняет эту системную настройку:
Лимиты журналов не освобождают место, занятое базой данных, резервными копиями или Docker-образами. Не удаляйте volumes и не обнуляйте управляемые Docker файлы журналов вручную во время работы контейнеров.
Резервная копия PostgreSQL
Заголовок раздела «Резервная копия PostgreSQL»Автоматические бэкапы
Заголовок раздела «Автоматические бэкапы»Worker может собирать ZIP-архивы с дампом PostgreSQL и snapshot compose-папки, отправлять их в Telegram и хранить последние архивы в data/backups. Настройка и восстановление описаны в отдельном разделе.
После изменения backup-настроек в .env перезапустите backend и worker:
Восстановление из архива доступно в админке Система -> Бэкапы. Там же можно загрузить ZIP вручную, выбрать БД и/или compose-папка, а backend проверит архив перед запуском. Подробности: бэкапы и восстановление.
Проверки после работ
Заголовок раздела «Проверки после работ»docker compose psdocker compose logs -f backend worker frontend/healthzна backend-домене- вход в Mini App и админку
- тестовый платеж или тестовая активация