Health Check эндпоинты
| Endpoint | Описание |
|---|
/health/unified | Агрегированный статус (режим бота, очередь, платежи) |
/health/telegram-webhook | Состояние очереди Telegram webhook |
/health/payment-webhooks | Активированные платёжные интеграции |
curl -s https://hooks.domain.com/health/unified | jq
Полезные команды
# Логи в реальном времени
docker compose logs -f bot
# Статус контейнеров
docker compose ps
# Перезапуск бота
docker compose restart bot
# Проверка PostgreSQL
docker compose exec postgres pg_isready -U remnawave_user
# Подключение к БД
docker compose exec postgres psql -U remnawave_user -d remnawave_bot
# Проверка Redis
docker compose exec redis redis-cli ping
# Использование ресурсов
docker stats
Частые проблемы
| Проблема | Диагностика | Решение |
|---|
| Бот не отвечает | docker logs remnawave_bot | Проверьте BOT_TOKEN и интернет |
| Ошибки БД | docker compose ps postgres | Проверьте статус PostgreSQL |
| Webhook не работает | curl http://localhost:8080/health/telegram-webhook | Проверьте WEBHOOK_URL, прокси и секрет |
| API недоступен | Проверьте логи бота | Проверьте REMNAWAVE_API_URL |
| Корзина не сохраняется | docker compose ps redis | Проверьте статус Redis |
| Платежи не проходят | Проверьте webhook’и | Настройте URL в платёжных системах |
FAQ
Какие требования к серверу?
Минимальные:
- 1 vCPU, 512 MB RAM, 10 GB диск
- Ubuntu 20.04+ или Debian 11+
- Docker и Docker Compose
Рекомендуемые:
- 2+ vCPU, 2+ GB RAM, 50+ GB SSD
Таблица производительности
| Пользователей | Память | CPU | Диск |
|---|
| 1,000 | 512MB | 1 vCPU | 10GB |
| 10,000 | 2GB | 2 vCPU | 50GB |
| 50,000 | 4GB | 4 vCPU | 100GB |
| 100,000+ | 8GB+ | 8+ vCPU | 200GB+ |
Как обновить бота?
cd /root/remnawave-bedolaga-telegram-bot
# Обновление до последней версии (main ветка)
git pull origin main
# Или до конкретной версии (стабильнее)
git fetch --tags
git checkout v2.7.0
# Перезапуск
make reload
Как сделать бэкап?
Автоматически: BACKUP_AUTO_ENABLED=true в .env
Через админ-панель: Админ панель → Настройки → Бэкапы → Создать
Ручной дамп БД через консоль:
Зайдите в папку с ботом и выполните:
docker exec remnawave_bot_db pg_dump -Fc -U postgres remnawave_bot > backup_$(date +%Y%m%d_%H%M%S).dump
Как восстановиться из копии БД?
docker exec -i postgres pg_restore -U postgres -d remnawave_bot --clean --if-exists < backup_XXXXXXXX_XXXXXX.dump
backup_XXXXXXXX_XXXXXX.dump на имя вашего файла дампа.
Флаг --clean удаляет существующие таблицы перед восстановлением. Убедитесь, что восстанавливаете нужный дамп. После восстановления перезапустите бота: make reload.
Бот не отвечает, что делать?
- Проверьте статус:
docker compose ps
- Посмотрите логи:
docker compose logs -f bot
- Проверьте
BOT_TOKEN в .env
- Убедитесь, что все контейнеры запущены
- Попробуйте перезапустить:
docker compose restart
Если не помогло — пишите в чат поддержки.