Перейти к содержимому

Обслуживание

Плановое обслуживание обычно сводится к обновлению образов, проверке миграций, логов и резервных копий. Подробная инструкция по автоматическим 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.

docker compose pull
docker compose up -d
docker compose logs -f migrate backend worker

В новых Compose-профилях журналы контейнеров ротируются автоматически: три файла по 10 МБ на контейнер. Настройки и область действия описаны в разделе деплоя.

Периодически проверяйте свободное место и размер системного журнала:

df -h /
sudo journalctl --disk-usage

На небольшом сервере с systemd администратор может отдельно ограничить journald. Следующий пример действует на весь сервер, включая другие приложения; установщик Minishop не меняет эту системную настройку:

sudo mkdir -p /etc/systemd/journald.conf.d
sudo tee /etc/systemd/journald.conf.d/50-minishop-limits.conf >/dev/null <<'EOF'
[Journal]
SystemMaxUse=256M
RuntimeMaxUse=64M
SystemKeepFree=1G
EOF
sudo systemctl restart systemd-journald

Лимиты журналов не освобождают место, занятое базой данных, резервными копиями или Docker-образами. Не удаляйте volumes и не обнуляйте управляемые Docker файлы журналов вручную во время работы контейнеров.

docker compose exec -T postgres sh -c 'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB"' > backup.sql

Worker может собирать ZIP-архивы с дампом PostgreSQL и snapshot compose-папки, отправлять их в Telegram и хранить последние архивы в data/backups. Настройка и восстановление описаны в отдельном разделе.

После изменения backup-настроек в .env перезапустите backend и worker:

docker compose up -d --build backend worker
docker compose logs -f backend worker

Восстановление из архива доступно в админке Система -> Бэкапы. Там же можно загрузить ZIP вручную, выбрать БД и/или compose-папка, а backend проверит архив перед запуском. Подробности: бэкапы и восстановление.

  • docker compose ps
  • docker compose logs -f backend worker frontend
  • /healthz на backend-домене
  • вход в Mini App и админку
  • тестовый платеж или тестовая активация