Начало
Инструкции установки
Пошаговое руководство по установке и запуску Remnawave Telegram Shop Bot
Предварительные требования
Заголовок раздела «Предварительные требования»Перед началом убедитесь, что у вас есть:
- Linux сервер или VPS
- Установленные Docker и Docker Compose
- Токен Telegram бота от @BotFather
- Панель Remnawave с API токеном и X_API_KEY
- Поддержка PostgreSQL (включена в docker-compose)
Установка
Заголовок раздела «Установка»Шаг 1: Клонируйте репозиторий
Заголовок раздела «Шаг 1: Клонируйте репозиторий»git clone https://github.com/Jolymmiels/remnawave-telegram-shopcd remnawave-telegram-shopШаг 2: Создайте файл окружения
Заголовок раздела «Шаг 2: Создайте файл окружения»cp .env.sample .envШаг 3: Настройте основные переменные
Заголовок раздела «Шаг 3: Настройте основные переменные»Отредактируйте .env с вашими параметрами:
TELEGRAM_TOKEN=your_bot_token_hereDATABASE_URL=postgresql://user:password@postgres:5432/remnawaveREMNAWAVE_URL=https://your-panel.comREMNAWAVE_TOKEN=your_api_tokenX_API_KEY=tinyauth login:pass in base64ADMIN_ID=your_idPRICE_1=5PRICE_3=12PRICE_6=20PRICE_12=35Шаг 4 (опционально): Настройте платежные системы
Заголовок раздела «Шаг 4 (опционально): Настройте платежные системы»Бот поддерживает несколько платежных систем — включите нужные в .env:
| Система | Переменная включения | Документация |
|---|---|---|
| YooKassa (карты) | YOOKASA_ENABLED=true |
Настройка YooKassa |
| Platega (СБП, карты, крипто) | PLATEGA_ENABLED=true |
Настройка Platega |
| WATA (карты, СБП) | WATA_ENABLED=true |
Настройка WATA |
| Telegram Stars | TELEGRAM_STARS_ENABLED=true |
Telegram Stars |
| CryptoPay | CRYPTO_PAY_ENABLED=true |
CryptoPay |
| Tribute | TRIBUTE_WEBHOOK_URL=... |
Tribute |
Перед запуском (опционально, с 5.1.0): Добавьте картинку меню
Поместите свой JPEG/PNG в assets/menu.jpg, проверьте наличие строки - ./assets:/assets:ro в volumes сервиса bot и добавьте её, если она отсутствует. Задайте MENU_PHOTO_PATH=/assets/menu.jpg в .env. Без этого mount контейнер не сможет прочитать картинку. Без этой переменной бот работает с текстовым меню.
Картинка должна быть доступна для чтения UID 1000. Полная настройка и ограничения.
Шаг 5: Запустите бота
Заголовок раздела «Шаг 5: Запустите бота»docker compose up -dШаг 6: Проверьте установку
Заголовок раздела «Шаг 6: Проверьте установку»docker compose logs -f remnawave-telegram-shop-botБот готов, когда вы видите сообщение “Starting bot”.
Шаг 7: Протестируйте бота
Заголовок раздела «Шаг 7: Протестируйте бота»Отправьте команду /start вашему боту в Telegram
Инструкции обновления
Заголовок раздела «Инструкции обновления»Для обновления до последней версии:
docker compose pulldocker compose downdocker compose up -dДля перехода с 5.0.x на 5.1.0 сначала сохраните резервную копию БД. Новые таблицы кеша и закреплений создаются автоматически. Порядок обновления до 5.1.0.
Матрица совместимости версий
Заголовок раздела «Матрица совместимости версий»| 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 |
Устранение неполадок
Заголовок раздела «Устранение неполадок»Бот не отвечает
Заголовок раздела «Бот не отвечает»- Проверьте, работает ли контейнер:
docker compose ps - Проверьте корректность токена Telegram
- Просмотрите логи:
docker compose logs remnawave-telegram-shop-bot
Ошибка подключения к БД
Заголовок раздела «Ошибка подключения к БД»- Убедитесь, что контейнер PostgreSQL запущен
- Проверьте формат DATABASE_URL
- Проверьте учётные данные БД
Ошибки API Remnawave
Заголовок раздела «Ошибки API Remnawave»- Проверьте доступность REMNAWAVE_URL
- Проверьте действительность REMNAWAVE_TOKEN
- Протестируйте подключение к API из контейнера
Следующие шаги
Заголовок раздела «Следующие шаги»- Настройте способы оплаты
- Установите переменные окружения
- Узнайте о командах администратора