Начало
Установка
Пошаговая инструкция по установке приватной версии 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-shopcd /opt/rwp-shopШаг 2: Загрузите Docker образ
Скачайте файл образа с me.rwp.rw/releases.
docker load -i rwp_shop-<VERSION>.tarШаг 3: Создайте необходимые директории
mkdir -p uploads translationssudo chmod -R 777 uploads translationsШаг 4: Скачайте файлы переводов
Скачайте en.json и ru.json и поместите в папку translations:
Или скачайте прямо на сервере:
wget -O ./translations/en.json https://s3.rwp.rw/translations/en.jsonwget -O ./translations/ru.json https://s3.rwp.rw/translations/ru.json# Добавьте файлам права, так как от каталога они не наследуются.chmod 777 ./translations/*.jsonШаг 5: Создайте конфигурацию Docker Compose
nano compose.yamlname: 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:3000REMNAWAVE_TOKEN=ваш_api_токен_remnawave
# TelegramTELEGRAM_TOKEN=ваш_токен_telegram_ботаADMIN_ID=123456789,987654321
# База данныхPOSTGRES_USER=postgresPOSTGRES_PASSWORD=postgresPOSTGRES_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Используйте этот способ, если бот будет работать на другом сервере, отличном от панели Remnawave. Бот подключается к Remnawave через внешний HTTPS URL.
Шаг 1: Создайте директорию проекта
mkdir -p /opt/rwp-shopcd /opt/rwp-shopШаг 2: Загрузите Docker образ
Скачайте файл образа с me.rwp.rw/releases.
docker load -i rwp_shop-<VERSION>.tarШаг 3: Создайте необходимые директории
mkdir -p uploads translationssudo chmod -R 777 uploads translationsШаг 4: Скачайте файлы переводов
Скачайте en.json и ru.json и поместите в папку translations:
Или скачайте прямо на сервере:
wget -O ./translations/en.json https://s3.rwp.rw/translations/en.jsonwget -O ./translations/ru.json https://s3.rwp.rw/translations/ru.json# Добавьте файлам права, так как от каталога они не наследуются.chmod 777 ./translations/*.jsonШаг 5: Создайте конфигурацию Docker Compose
nano compose.yamlname: 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:-}
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
volumes: rwp_shop_db_data:Шаг 6: Создайте файл окружения
nano .env# Подключение к Remnawave (внешний HTTPS URL)REMNAWAVE_URL=https://panel.example.comREMNAWAVE_TOKEN=ваш_api_токен_remnawave
# TelegramTELEGRAM_TOKEN=ваш_токен_telegram_ботаADMIN_ID=123456789,987654321
# База данныхPOSTGRES_USER=postgresPOSTGRES_PASSWORD=postgresPOSTGRES_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}server { listen 80; server_name bot.example.com; return 301 https://$host$request_uri;}
server { listen 443 ssl http2; server_name bot.example.com;
ssl_certificate /etc/letsencrypt/live/bot.example.com/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/bot.example.com/privkey.pem; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers HIGH:!aNULL:!MD5;
add_header Content-Security-Policy "frame-ancestors 'self' https://web.telegram.org https://webk.telegram.org https://webz.telegram.org https://*.telegram.org" always; proxy_hide_header X-Frame-Options;
location ~* \.html$ { add_header Cache-Control "no-cache, no-store, must-revalidate" always; proxy_pass http://127.0.0.1:9912; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; }
location ~* ^/assets/.*\.js$ { add_header Cache-Control "no-cache, no-store, must-revalidate" always; proxy_pass http://127.0.0.1:9912; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; }
location /assets/ { add_header Cache-Control "public, max-age=31536000, immutable" always; proxy_pass http://127.0.0.1:9912; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; }
location / { proxy_pass http://127.0.0.1:9912; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme;
client_max_body_size 50M; }}Перезапуск:
sudo systemctl reload caddysudo apt install certbot python3-certbot-nginx -ysudo certbot --nginx -d bot.example.comsudo ln -s /etc/nginx/sites-available/bot.example.com /etc/nginx/sites-enabled/sudo nginx -tsudo systemctl reload nginxПроверка установки
Заголовок раздела «Проверка установки»docker compose logs -f botНужны access-логи с ротацией? Смотрите Настройка access-логов.
Нужны прямые ссылки? Смотрите Вход через браузер (direct links).
Нужно S3 хранилище? Смотрите Настройка S3.
Справка по портам
Заголовок раздела «Справка по портам»| Сервис | Внутренний порт | Рекомендуемый внешний |
|---|---|---|
| Bot HTTP | 8080 | 9912 или 12345 |
| PostgreSQL | 5432 | - |
После установки
Заголовок раздела «После установки»После установки:
- Откройте
https://bot.example.comв Telegram Mini App - Войдите с вашим админским Telegram-аккаунтом
- Настройте параметры в админ-панели:
- Платёжные системы
- Тарифные планы
- Брендинг
- Роли и разрешения
Все остальные настройки управляются через UI админ-панели.
Полезные советы
Заголовок раздела «Полезные советы»Добавление кнопки меню в Telegram
Заголовок раздела «Добавление кнопки меню в Telegram»Чтобы добавить кнопку “Open” в Telegram, которая открывает личный кабинет вместо набора команд:
- Откройте Mini App @BotFather
- Выберите вашего бота
- Перейдите в Mini Apps → Menu Button
- Укажите URL вашего дашборда:
https://bot.example.com
- Опционально, можете указать название кнопки(Title)
Это добавит кнопку в чате Telegram, которая открывает Mini App с личным кабинетом пользователя.
Настройка Mini App под прямые ссылки(deep links)
Заголовок раздела «Настройка Mini App под прямые ссылки(deep links)»- Откройте Mini App @BotFather
- Выберите вашего бота
- Перейдите в Mini Apps → Mini App
- Укажите URL вашего дашборда:
https://bot.example.com
Без данной прямые ссылки(deep links) работать не будут