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

Администрирование

Обслуживание и лучшие практики

Обслуживание и оперативные лучшие практики

  • ✅ Контролируйте здоровье бота
  • ✅ Проверяйте логи ошибок
  • ✅ Пересматривайте подозрительных пользователей
  • ✅ Проверьте обработку платежей
  • ✅ Резервная копия БД
  • ✅ Пересматривайте логи доступа пользователей
  • ✅ Проверьте использование ресурсов
  • ✅ Протестируйте процедуры восстановления
  • ✅ Обновите образы Docker
  • ✅ Пересмотрите параметры безопасности
  • ✅ Аудит разрешений пользователей
  • ✅ Планируйте улучшения
  • ✅ Полный аудит безопасности
  • ✅ Пересмотр и ротация ключей
  • ✅ Оптимизация производительности
  • ✅ Проверка соответствия
docker compose exec postgres pg_dump \
-U remnawave \
-d remnawave \
> backup_$(date +%Y%m%d_%H%M%S).sql

Создайте /usr/local/bin/backup-bot.sh:

#!/bin/bash
DATE=$(date +%Y%m%d_%H%M%S)
docker compose -f /path/to/docker-compose.yaml exec postgres \
pg_dump -U remnawave -d remnawave \
> /backups/bot_$DATE.sql
gzip /backups/bot_$DATE.sql
crontab -e
# Выполнять ежедневно в 2 AM
0 2 * * * /usr/local/bin/backup-bot.sh
# Проверьте, что резервная копия действительна
gunzip -c backup_20241110_020000.sql.gz | head -100
# Проверьте обновления
docker pull ghcr.io/jolymmiels/remnawave-telegram-shop-bot:latest
# Обновите
docker compose pull
docker compose down
docker compose up -d
# Проверьте
docker compose logs -f remnawave-telegram-shop-bot

Версия 5.1.0 добавляет необязательную картинку меню и автоматическую замену закреплённого /start. Интеграция с Remnawave остаётся на API 3.4.1. Перед обновлением сохраните резервную копию PostgreSQL и исходных файлов: .env, docker-compose.yaml, translations и assets (если картинка используется). Не публикуйте резервную копию .env: она содержит секреты.

  1. Укажите образ ghcr.io/jolymmiels/remnawave-telegram-shop-bot:5.1.0 в сервисе bot либо используйте свой выбранный тег 5/latest.
  2. При необходимости добавьте ./assets:/assets:ro и настройте MENU_PHOTO_PATH. Сохраняйте остальные volumes.
  3. Обновите только бота, не останавливая БД (имя сервиса — из стандартного Compose):
docker compose pull bot
docker compose up -d --no-deps --force-recreate bot
docker compose logs --tail 100 bot

Миграция 000006_add_menu_state применяется автоматически при запуске и создаёт две новые таблицы:

  • bot_menu_photo — Telegram file_id и хеш исходной картинки для конкретного бота и пути;
  • bot_menu_pin — ID закреплений и незавершённые операции открепления для конкретного бота и чата.

Сохраняйте эти таблицы в резервной копии БД и не удаляйте volume PostgreSQL: без него потеряются не только кеш/закрепления, но и остальные данные бота. Не используйте docker compose down -v для обычного обновления.

После запуска отправьте /start, проверьте фото и inline-переходы, затем повторите /start: новое меню должно закрепиться, старое — открепиться. Отсутствие прав на закрепление не блокирует отправку самого меню и отражается в логах.

При замене только файла картинки достаточно перезапустить сервис bot; при изменении .env или mounts нужен up -d --force-recreate bot. Старые сообщения сохраняют старое фото, новый /start использует обновлённое.

Контролируйте обновления безопасности:

# Проверьте уязвимости
docker scout cves ghcr.io/jolymmiels/remnawave-telegram-shop-bot
# Обновите базовый образ при обнаружении проблем
docker compose build --pull

Всегда проверяйте совместимость перед обновлением:

Remnawave Бот
1.6 2.3.6
2.0-2.1.9 3.2.4
2.2.* 3.2.5+
2.3.* 3.5.*
2.8.* 4.1.*
3.4.1 5.0.x–5.1.x
# Никогда не коммитьте .env
echo ".env" >> .gitignore
# Ограничьте разрешения файла
chmod 600 .env
# Используйте сильные пароли
openssl rand -base64 32
# Каждые 90 дней
1. Сгенерируйте новый ключ в панели платежей/Remnawave
2. Обновите файл .env
3. Перезагрузите бота
4. Удалите старый ключ после проверки
  • Ограничьте Telegram ID администраторов
  • Используйте сильную аутентификацию
  • Включите 2FA где доступно
  • Контролируйте логи доступа
# Подключитесь к PostgreSQL
docker compose exec postgres psql -U remnawave -d remnawave
# Проверьте размеры таблиц
SELECT
schemaname,
tablename,
pg_size_pretty(pg_total_relation_size(schemaname||'.'||tablename))
FROM pg_tables
ORDER BY pg_total_relation_size(schemaname||'.'||tablename) DESC;
# Vacuum и анализ
VACUUM ANALYZE;
# Проверьте использование индексов
SELECT * FROM pg_stat_user_indexes ORDER BY idx_scan DESC;

Контролируйте и регулируйте:

# Проверьте использование
docker stats remnawave-telegram-shop-bot
# Обновите лимиты в docker-compose.yaml
services:
remnawave-telegram-shop-bot:
deploy:
resources:
limits:
cpus: '1'
memory: 1G
# Остановите сервисы
docker compose down
# Восстановите БД
gunzip -c backup_latest.sql.gz | \
docker compose exec -T postgres \
psql -U remnawave -d remnawave
# Запустите сервисы
docker compose up -d
# Проверьте целостность данных
docker compose exec postgres psql -U remnawave -d remnawave \
-c "SELECT COUNT(*) FROM subscriptions;"
# Протестируйте бота
docker compose logs -f remnawave-telegram-shop-bot

Планируйте рост:

Текущие пользователи: 1 000
Темп роста: 20% в месяц
Прогноз: 3 200 пользователей через 6 месяцев
Потребности ресурсов:
- БД: +50GB
- Память бота: +200MB
- Сеть: +100Mbps

Ведите подробные записи:

  • ✅ Изменения конфигурации
  • ✅ Инциденты безопасности
  • ✅ Проблемы производительности
  • ✅ Жалобы пользователей
  • ✅ Обновления системы
Проблема Причина Решение
Бот медленный Высокая нагрузка Масштабируйте ресурсы
БД полная Большие таблицы Архивируйте старые данные
Платежи сбиваются Проблема API Проверьте подключение
Утечка памяти Версия с ошибкой Обновите бота
  • GitHub Issues: Сообщайте об ошибках
  • Документация: Этот сайт
  • Telegram сообщество: Присоединитесь к группе
  • Коммерческая поддержка: Доступна (свяжитесь)