> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bedolagam.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Устранение неполадок

> Диагностика и решение типичных проблем

## Health Check эндпоинты

| Endpoint | Описание |
| - | - |
| `/health/unified` | Агрегированный статус (режим бота, очередь, платежи) |
| `/health/telegram-webhook` | Состояние очереди Telegram webhook |
| `/health/payment-webhooks` | Активированные платёжные интеграции |

```bash theme={null}
curl -s https://hooks.domain.com/health/unified | jq
```

## Полезные команды

```bash theme={null}
# Логи в реальном времени
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 |
| После обновления бот не стартует, в логах базы «база ещё на PostgreSQL 15» | `docker compose logs postgres` | Выполните `make pg-upgrade` — см. [Обновление PostgreSQL 15 → 18](https://docs.bedolagam.ru/getting-started/postgresql-18-upgrade.md) |
| 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+ |

### Как обновить бота?

```bash theme={null}
cd /root/remnawave-bedolaga-telegram-bot

# Обновление до последней версии (main ветка)
git pull origin main

# Или до конкретной версии (стабильнее)
git fetch --tags
git checkout v2.7.0

# Перезапуск
make reload
```

> [!WARNING]
>
> Если бот работал на PostgreSQL 15, после обновления на версию с PostgreSQL 18 выполните один раз `make pg-upgrade` — скрипт сделает резервную копию и перенесёт базу. Подробно: [Обновление PostgreSQL 15 → 18](https://docs.bedolagam.ru/getting-started/postgresql-18-upgrade.md).

### Как сделать бэкап?

**Автоматически:** `BACKUP_AUTO_ENABLED=true` в `.env`

**Через админ-панель:** Админ панель → Настройки → Бэкапы → Создать

**Ручной дамп БД через консоль:**

Зайдите в папку с ботом и выполните:

```bash theme={null}
docker exec remnawave_bot_db pg_dump -Fc -U postgres remnawave_bot > backup_$(date +%Y%m%d_%H%M%S).dump
```

Файл дампа появится в текущей директории.

### Как восстановиться из копии БД?

```bash theme={null}
docker exec -i postgres pg_restore -U postgres -d remnawave_bot --clean --if-exists < backup_XXXXXXXX_XXXXXX.dump
```

Замените `backup_XXXXXXXX_XXXXXX.dump` на имя вашего файла дампа.

> [!WARNING]
>
> Флаг `--clean` удаляет существующие таблицы перед восстановлением. Убедитесь, что восстанавливаете нужный дамп. После восстановления перезапустите бота: `make reload`.

### Бот не отвечает, что делать?

1. Проверьте статус: `docker compose ps`
2. Посмотрите логи: `docker compose logs -f bot`
3. Проверьте `BOT_TOKEN` в `.env`
4. Убедитесь, что все контейнеры запущены
5. Попробуйте перезапустить: `docker compose restart`

Если не помогло — пишите в [чат поддержки](https://t.me/+wTdMtSWq8YdmZmVi).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.