RWP DocsRWP Docs

Appearance

Личный кабинет ›
Начало

Инструкции установки

Пошаговое руководство по установке и запуску Remnawave Telegram Shop Bot

Предварительные требования ​

Перед началом убедитесь, что у вас есть:

  • Linux сервер или VPS
  • Установленные Docker и Docker Compose
  • Токен Telegram бота от @BotFather
  • Панель Remnawave с API токеном и X_API_KEY
  • Поддержка PostgreSQL (включена в docker-compose)

Установка ​

Шаг 1: Клонируйте репозиторий

bash
  git clone https://github.com/Jolymmiels/remnawave-telegram-shop
  cd remnawave-telegram-shop

Шаг 2: Создайте файл окружения

bash
  cp .env.sample .env

Шаг 3: Настройте основные переменные

Отредактируйте .env с вашими параметрами:

bash
TELEGRAM_TOKEN=your_bot_token_here
DATABASE_URL=postgresql://user:password@postgres:5432/remnawave
REMNAWAVE_URL=https://your-panel.com
REMNAWAVE_TOKEN=your_api_token
X_API_KEY=tinyauth login:pass in base64
ADMIN_ID=your_id
PRICE_1=5
PRICE_3=12
PRICE_6=20
PRICE_12=35

Шаг 4 (опционально): Настройте платежные системы

Бот поддерживает несколько платежных систем — включите нужные в .env:

СистемаПеременная включенияДокументация
YooKassa (карты)YOOKASA_ENABLED=trueНастройка YooKassa
Platega (СБП, карты, крипто)PLATEGA_ENABLED=trueНастройка Platega
Telegram StarsTELEGRAM_STARS_ENABLED=trueTelegram Stars
CryptoPayCRYPTO_PAY_ENABLED=trueCryptoPay
TributeTRIBUTE_WEBHOOK_URL=...Tribute

Вебхуки

YooKassa, Platega и Tribute подтверждают оплату через вебхуки — боту нужен публичный HTTPS-домен, а путь вебхука должен содержать случайный секрет (openssl rand -hex 32). Подробности в документации каждой системы.

Шаг 5: Запустите бота

bash
  docker compose up -d

Шаг 6: Проверьте установку

bash
  docker compose logs -f remnawave-telegram-shop-bot

Бот готов, когда вы видите сообщение "Starting bot".

Шаг 7: Протестируйте бота

Отправьте команду /start вашему боту в Telegram

Инструкции обновления ​

Для обновления до последней версии:

bash
docker compose pull
docker compose down
docker compose up -d

Матрица совместимости версий ​

RemnawaveБот
1.62.3.6
2.0-2.1.93.2.4
2.2.*3.2.5+

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

Бот не отвечает ​

  • Проверьте, работает ли контейнер: docker compose ps
  • Проверьте корректность токена Telegram
  • Просмотрите логи: docker compose logs remnawave-telegram-shop-bot

Ошибка подключения к БД ​

  • Убедитесь, что контейнер PostgreSQL запущен
  • Проверьте формат DATABASE_URL
  • Проверьте учётные данные БД

Ошибки API Remnawave ​

  • Проверьте доступность REMNAWAVE_URL
  • Проверьте действительность REMNAWAVE_TOKEN
  • Протестируйте подключение к API из контейнера

Следующие шаги ​