Администрирование
Обслуживание и лучшие практики
Обслуживание и оперативные лучшие практики
График регулярного обслуживания
Заголовок раздела «График регулярного обслуживания»Ежедневно
Заголовок раздела «Ежедневно»- ✅ Контролируйте здоровье бота
- ✅ Проверяйте логи ошибок
- ✅ Пересматривайте подозрительных пользователей
- ✅ Проверьте обработку платежей
Еженедельно
Заголовок раздела «Еженедельно»- ✅ Резервная копия БД
- ✅ Пересматривайте логи доступа пользователей
- ✅ Проверьте использование ресурсов
- ✅ Протестируйте процедуры восстановления
Ежемесячно
Заголовок раздела «Ежемесячно»- ✅ Обновите образы Docker
- ✅ Пересмотрите параметры безопасности
- ✅ Аудит разрешений пользователей
- ✅ Планируйте улучшения
Ежеквартально
Заголовок раздела «Ежеквартально»- ✅ Полный аудит безопасности
- ✅ Пересмотр и ротация ключей
- ✅ Оптимизация производительности
- ✅ Проверка соответствия
Резервная копия БД
Заголовок раздела «Резервная копия БД»Шаг 1: Ручная резервная копия
Заголовок раздела «Шаг 1: Ручная резервная копия»docker compose exec postgres pg_dump \ -U remnawave \ -d remnawave \ > backup_$(date +%Y%m%d_%H%M%S).sqlШаг 2: Автоматическая резервная копия
Заголовок раздела «Шаг 2: Автоматическая резервная копия»Создайте /usr/local/bin/backup-bot.sh:
#!/bin/bashDATE=$(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.sqlgzip /backups/bot_$DATE.sqlШаг 3: Добавьте в Cron
Заголовок раздела «Шаг 3: Добавьте в Cron»crontab -e# Выполнять ежедневно в 2 AM0 2 * * * /usr/local/bin/backup-bot.shШаг 4: Протестируйте восстановление
Заголовок раздела «Шаг 4: Протестируйте восстановление»# Проверьте, что резервная копия действительнаgunzip -c backup_20241110_020000.sql.gz | head -100Обновления и升级
Заголовок раздела «Обновления и升级»Обновите бота
Заголовок раздела «Обновите бота»# Проверьте обновленияdocker pull ghcr.io/jolymmiels/remnawave-telegram-shop-bot:latest
# Обновитеdocker compose pulldocker compose downdocker compose up -d
# Проверьтеdocker compose logs -f remnawave-telegram-shop-botОбновление до 5.1.0
Заголовок раздела «Обновление до 5.1.0»Версия 5.1.0 добавляет необязательную картинку меню и автоматическую замену закреплённого /start. Интеграция с Remnawave остаётся на API 3.4.1. Перед обновлением сохраните резервную копию PostgreSQL и исходных файлов: .env, docker-compose.yaml, translations и assets (если картинка используется). Не публикуйте резервную копию .env: она содержит секреты.
- Укажите образ
ghcr.io/jolymmiels/remnawave-telegram-shop-bot:5.1.0в сервисеbotлибо используйте свой выбранный тег5/latest. - При необходимости добавьте
./assets:/assets:roи настройте MENU_PHOTO_PATH. Сохраняйте остальные volumes. - Обновите только бота, не останавливая БД (имя сервиса — из стандартного Compose):
docker compose pull botdocker compose up -d --no-deps --force-recreate botdocker compose logs --tail 100 botМиграция 000006_add_menu_state применяется автоматически при запуске и создаёт две новые таблицы:
bot_menu_photo— Telegramfile_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 |
Укрепление безопасности
Заголовок раздела «Укрепление безопасности»Безопасность окружения
Заголовок раздела «Безопасность окружения»# Никогда не коммитьте .envecho ".env" >> .gitignore
# Ограничьте разрешения файлаchmod 600 .env
# Используйте сильные паролиopenssl rand -base64 32Ротация API ключа
Заголовок раздела «Ротация API ключа»# Каждые 90 дней1. Сгенерируйте новый ключ в панели платежей/Remnawave2. Обновите файл .env3. Перезагрузите бота4. Удалите старый ключ после проверкиКонтроль доступа
Заголовок раздела «Контроль доступа»- Ограничьте Telegram ID администраторов
- Используйте сильную аутентификацию
- Включите 2FA где доступно
- Контролируйте логи доступа
Оптимизация производительности
Заголовок раздела «Оптимизация производительности»Оптимизация БД
Заголовок раздела «Оптимизация БД»# Подключитесь к PostgreSQLdocker compose exec postgres psql -U remnawave -d remnawave
# Проверьте размеры таблицSELECT schemaname, tablename, pg_size_pretty(pg_total_relation_size(schemaname||'.'||tablename))FROM pg_tablesORDER 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.yamlservices: 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 сообщество: Присоединитесь к группе
- Коммерческая поддержка: Доступна (свяжитесь)