Перейти к содержимому
RWP Shop Docs

Начало

Установка

Пошаговая инструкция по установке приватной версии Remnawave Telegram Shop Bot

  • Linux сервер или VPS
  • Установленные Docker и Docker Compose
  • PostgreSQL 18 или новее (входит в docker-compose ниже) — бот использует встроенную функцию uuidv7() и на более старой версии не запустится
  • Доменное имя с SSL-сертификатом
  • Реверс-прокси (Caddy или Nginx)
  • Установленная и настроенная панель Remnawave
  • Файл Docker образа приватной версии (.tar)

Выберите способ установки в зависимости от вашей конфигурации:

Используйте этот способ, если бот будет работать на том же сервере, что и панель Remnawave. Бот подключается к Remnawave через внутреннюю Docker-сеть.

Шаг 1: Создайте директорию проекта

mkdir -p /opt/rwp-shop
cd /opt/rwp-shop

Шаг 2: Загрузите Docker образ

Скачайте файл образа с me.rwp.rw/releases.

docker load -i rwp_shop-<VERSION>.tar

Шаг 3: Создайте необходимые директории

mkdir -p uploads translations
sudo chmod -R 777 uploads translations

Шаг 4: Скачайте файлы переводов

Скачайте en.json и ru.json и поместите в папку translations:

en.jsonru.json

Или скачайте прямо на сервере:

wget -O ./translations/en.json https://s3.rwp.rw/translations/en.json
wget -O ./translations/ru.json https://s3.rwp.rw/translations/ru.json
# Добавьте файлам права, так как от каталога они не наследуются.
chmod 777 ./translations/*.json

Шаг 5: Создайте конфигурацию Docker Compose

nano compose.yaml
name: rwp_shop
services:
bot:
image: rwp_shop:<VERSION>
container_name: rwp_shop
restart: unless-stopped
ports:
- "127.0.0.1:9912:8080"
depends_on:
db:
condition: service_healthy
volumes:
- ./translations:/translations
- ./uploads:/uploads
- /etc/machine-id:/etc/machine-id:ro
environment:
- REMNAWAVE_URL=${REMNAWAVE_URL}
- REMNAWAVE_TOKEN=${REMNAWAVE_TOKEN}
- TELEGRAM_TOKEN=${TELEGRAM_TOKEN}
- ADMIN_ID=${ADMIN_ID}
- DATABASE_URL=postgres://${POSTGRES_USER}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB}?sslmode=disable
- BOT_ADMIN_URL=${BOT_ADMIN_URL}
- LOG_LEVEL=${LOG_LEVEL:-info}
- ACCESS_LOG_ENABLED=${ACCESS_LOG_ENABLED:-true}
- ACCESS_LOG_PATH=${ACCESS_LOG_PATH:-}
- LICENSE_KEY=${LICENSE_KEY:-}
- REMNAWAVE_HEADERS=${REMNAWAVE_HEADERS:-}
- JWT_SECRET=${JWT_SECRET}
- TELEGRAM_PROXY_URL=${TELEGRAM_PROXY_URL:-}
networks:
- remnawave-network
db:
image: postgres:18-alpine
container_name: rwp_shop_db
restart: unless-stopped
environment:
- POSTGRES_USER=${POSTGRES_USER}
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
- POSTGRES_DB=${POSTGRES_DB}
- TZ=UTC
ports:
- "127.0.0.1:9999:5432"
volumes:
- rwp_shop_db_data:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
interval: 3s
timeout: 10s
retries: 3
networks:
- remnawave-network
volumes:
rwp_shop_db_data:
networks:
remnawave-network:
name: remnawave-network
external: true

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

nano .env
# Подключение к Remnawave (внутренняя Docker-сеть)
REMNAWAVE_URL=http://remnawave:3000
REMNAWAVE_TOKEN=ваш_api_токен_remnawave
# Telegram
TELEGRAM_TOKEN=ваш_токен_telegram_бота
ADMIN_ID=123456789,987654321
# База данных
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_DB=postgres
# URL админ-панели (требуется HTTPS)
BOT_ADMIN_URL=https://bot.example.com
# Логирование (опционально)
# LOG_LEVEL=info
# ACCESS_LOG_ENABLED=true
# ACCESS_LOG_PATH=
LICENSE_KEY=
# JWT секрет для авторизации в панели бота
JWT_SECRET=
# Пользовательские заголовки для Remnawave API (опционально)
# REMNAWAVE_HEADERS=
# Прокси для Telegram Bot API (опционально)
# TELEGRAM_PROXY_URL=socks5://proxy:1080

Шаг 7: Добавьте volume machine-id для лицензии

Лицензия привязана к уникальному идентификатору вашего сервера. Добавьте этот volume в compose.yaml в секцию bot:

volumes:
- ./translations:/translations
- ./uploads:/uploads
- /etc/machine-id:/etc/machine-id:ro

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

docker compose up -d
bot.example.com {
header * {
Strict-Transport-Security "max-age=63072000; includeSubDomains; preload"
X-Content-Type-Options "nosniff"
X-XSS-Protection "1; mode=block"
-Server
-X-Frame-Options
Content-Security-Policy "frame-ancestors 'self' https://web.telegram.org https://webk.telegram.org https://webz.telegram.org https://*.telegram.org"
Referrer-Policy strict-origin-when-cross-origin
X-Robots-Tag "noindex, nofollow"
}
encode gzip zstd
@html path / *.html
header @html Cache-Control "no-cache, no-store, must-revalidate"
@immutable {
path /assets/*
not path *.js
}
header @immutable Cache-Control "public, max-age=31536000, immutable"
reverse_proxy 127.0.0.1:9912
}

Перезапуск:

sudo systemctl reload caddy
docker compose logs -f bot

Нужны access-логи с ротацией? Смотрите Настройка access-логов.

Нужны прямые ссылки? Смотрите Вход через браузер (direct links).


Нужно S3 хранилище? Смотрите Настройка S3.

Сервис Внутренний порт Рекомендуемый внешний
Bot HTTP 8080 9912 или 12345
PostgreSQL 5432 -

После установки:

  1. Откройте https://bot.example.com в Telegram Mini App
  2. Войдите с вашим админским Telegram-аккаунтом
  3. Настройте параметры в админ-панели:
    • Платёжные системы
    • Тарифные планы
    • Брендинг
    • Роли и разрешения

Все остальные настройки управляются через UI админ-панели.

Чтобы добавить кнопку “Open” в Telegram, которая открывает личный кабинет вместо набора команд:

  1. Откройте Mini App @BotFather
  2. Выберите вашего бота
  3. Перейдите в Mini Apps → Menu Button
  4. Укажите URL вашего дашборда:
    https://bot.example.com
  5. Опционально, можете указать название кнопки(Title)

Это добавит кнопку в чате Telegram, которая открывает Mini App с личным кабинетом пользователя.

  1. Откройте Mini App @BotFather
  2. Выберите вашего бота
  3. Перейдите в Mini Apps → Mini App
  4. Укажите URL вашего дашборда:
    https://bot.example.com

Без данной прямые ссылки(deep links) работать не будут