Начало
Переменные окружения
Полный справочник переменных окружения приватной версии
Все переменные окружения задаются в .env и передаются в контейнер бота через секцию environment в compose.yaml. Переменные, отмеченные как обязательные, необходимы для запуска бота.
Обязательные переменные
Заголовок раздела «Обязательные переменные»| Переменная | Описание | Пример |
|---|---|---|
TELEGRAM_TOKEN |
Токен Telegram Bot API | 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 |
DATABASE_URL |
Строка подключения к PostgreSQL | postgres://user:pass@db:5432/postgres?sslmode=disable |
BOT_ADMIN_URL |
Публичный HTTPS URL админ-панели | https://bot.example.com |
REMNAWAVE_URL |
URL API Remnawave | http://remnawave:3000 или https://panel.example.com |
REMNAWAVE_TOKEN |
Токен API Remnawave | eyJhbG... |
ADMIN_ID |
Идентификаторы админов (через запятую) | 123456789,telegram:987654321,xxxxxxxx-xxxx-... |
LICENSE_KEY |
Лицензионный ключ из личного кабинета | LIC-XXXX-XXXX |
JWT_SECRET |
Секрет для JWT-аутентификации панели | openssl rand -hex 32 |
Формат ADMIN_ID
Заголовок раздела «Формат ADMIN_ID»ADMIN_ID поддерживает три формата, которые можно комбинировать через запятую:
| Формат | Пример | Описание |
|---|---|---|
| Число | 123456789 |
Telegram ID пользователя (обратная совместимость) |
Префикс telegram: |
telegram:123456789 |
Явный Telegram ID |
| UUID | 550e8400-e29b-41d4-a716-446655440000 |
UUID клиента из базы данных |
# Один админADMIN_ID=123456789
# Несколько админов, разные форматыADMIN_ID=123456789,telegram:987654321,550e8400-e29b-41d4-a716-446655440000Необязательные переменные
Заголовок раздела «Необязательные переменные»| Переменная | Описание | По умолчанию |
|---|---|---|
BOT_WORKERS |
Количество воркеров бота | 3 |
DEFAULT_LANGUAGE |
Язык интерфейса по умолчанию | ru |
HEALTH_CHECK_PORT |
HTTP-порт для проверки здоровья | 8080 |
REMNAWAVE_MODE |
Режим подключения: remote или local |
remote |
TELEGRAM_PROXY_URL |
Прокси для Telegram Bot API (HTTP, HTTPS, SOCKS5) | — |
TELEGRAM_API_URL |
Адрес собственного сервера telegram-bot-api. Пусто — https://api.telegram.org |
— |
MOYNALOG_PROXY_URL |
Прокси для API «Мой налог» (lknpd.nalog.ru) (HTTP, HTTPS, SOCKS5) | — |
Пользователь для модерации приложения
Заголовок раздела «Пользователь для модерации приложения»Для проверки приложения в App Store или Google Play можно задать один email с постоянным кодом входа. Такой пользователь проходит вход без доставки кода через SMTP и может создать учётную запись при первом входе.
| Переменная | Описание | По умолчанию |
|---|---|---|
REVIEW_USER_EMAIL |
Email проверяющего пользователя | — |
REVIEW_USER_OTP |
Постоянный одноразовый код: ровно 6 цифр | — |
Укажите обе переменные в .env и перезапустите сервис:
REVIEW_USER_EMAIL=reviewer@example.comREVIEW_USER_OTP=123456Прокси для Telegram
Заголовок раздела «Прокси для Telegram»Если Telegram API недоступен напрямую, укажите прокси-сервер:
# SOCKS5TELEGRAM_PROXY_URL=socks5://user:password@proxy.example.com:1080
# SOCKS5 без авторизацииTELEGRAM_PROXY_URL=socks5://proxy.example.com:1080
# HTTP проксиTELEGRAM_PROXY_URL=http://proxy.example.com:8080Прокси для «Мой налог»
Заголовок раздела «Прокси для «Мой налог»»Если API ФНS lknpd.nalog.ru недоступен напрямую (например, заблокирован на сервере), направьте запросы интеграции «Мой налог» через прокси:
# SOCKS5MOYNALOG_PROXY_URL=socks5://user:password@proxy.example.com:1080
# HTTP проксиMOYNALOG_PROXY_URL=http://proxy.example.com:8080AI-поддержка и база знаний
Заголовок раздела «AI-поддержка и база знаний»Модель, API-ключ, язык ответов и правила AI-поддержки настраиваются в админ-панели. Переменные окружения нужны только для отдельной базы знаний (RAG) и, при необходимости, прокси-сервера.
| Переменная | Описание | По умолчанию |
|---|---|---|
AI_KB_DATABASE_URL |
Строка подключения к отдельной pgvector-базе знаний. Пусто — база знаний и поиск по ней отключены, AI-поддержка без RAG продолжает работать | — |
AI_KB_POSTGRES_USER |
Пользователь PostgreSQL контейнера kb-db из Compose |
kb |
AI_KB_POSTGRES_PASSWORD |
Пароль PostgreSQL контейнера kb-db |
kb |
AI_KB_POSTGRES_DB |
Имя базы данных контейнера kb-db |
kb |
AI_PROXY_URL |
HTTP(S) или SOCKS5-прокси для запросов к AI-провайдеру и сервису эмбеддингов | — |
Включение базы знаний
Заголовок раздела «Включение базы знаний»При стандартном docker-compose.yaml используется отдельный сервис kb-db. Добавьте в .env:
# Учётные данные отдельной базы знанийAI_KB_POSTGRES_USER=kbAI_KB_POSTGRES_PASSWORD=change_this_passwordAI_KB_POSTGRES_DB=kb
# Адрес используется контейнером бота: kb-db — имя сервиса в ComposeAI_KB_DATABASE_URL=postgres://kb:change_this_password@kb-db:5432/kb?sslmode=disableПосле изменения перезапустите сервисы. Затем откройте настройки AI-поддержки в админ-панели, включите базу знаний и создайте или импортируйте статьи.
Прокси для AI-провайдера
Заголовок раздела «Прокси для AI-провайдера»Если OpenRouter, OpenAI или другой AI-провайдер недоступен с сервера напрямую, направьте запросы через прокси:
# HTTP(S)-проксиAI_PROXY_URL=http://user:password@proxy.example.com:8080
# или SOCKS5AI_PROXY_URL=socks5://user:password@proxy.example.com:1080В стандартном docker-compose.yaml добавьте переменную в секцию bot.environment, чтобы она попала внутрь контейнера:
- AI_PROXY_URL=${AI_PROXY_URL:-}Если переменная не задана, запросы к AI-провайдеру выполняются напрямую.
Иви, ИИ-помощник администратора
Заголовок раздела «Иви, ИИ-помощник администратора»Иви встроена в образ RWP Shop и по умолчанию выключена. Чтобы включить её, добавьте в .env и перезапустите бота:
ASSISTANT_ENABLED=true| Переменная | Описание | По умолчанию |
|---|---|---|
ASSISTANT_ENABLED |
Запускает Иви (true/false) |
выключено |
ASSISTANT_DATA_DIR |
Рабочая папка Иви с правом записи. Менять нужно, только если путь по умолчанию недоступен | /tmp/rwp-assistant |
Модель задаёт суперадмин в настройках ИИ, поле «Модель Иви». Ключ и адрес провайдера общие с ИИ-поддержкой, AI_PROXY_URL тоже действует. Пока модель не выбрана, Иви отвечает, что не настроена. Иви доступна администраторам основного магазина, в кабинетах партнёров её нет.
Заголовки Remnawave
Заголовок раздела «Заголовки Remnawave»Пользовательские заголовки, отправляемые с каждым запросом к API Remnawave. Формат: ключ:значение;ключ:значение.
# Один заголовокREMNAWAVE_HEADERS=X-Api-Key:your_secret_key
# Несколько заголовковREMNAWAVE_HEADERS=X-Api-Key:secret123;X-Custom-Header:custom_value
# Cookie для Remnawave Reverse-Proxy (egames)REMNAWAVE_HEADERS=Cookie:rEmnaprx=aBCDefghЛогирование
Заголовок раздела «Логирование»| Переменная | Описание | По умолчанию |
|---|---|---|
LOG_LEVEL |
Уровень логирования: debug, info, warn, error |
info |
ACCESS_LOG_ENABLED |
Включить HTTP access-логи (true/false) |
false |
ACCESS_LOG_PATH |
Путь к файлу access-лога; пусто = вывод в консоль | — |
LOG_LEVEL=infoACCESS_LOG_ENABLED=trueACCESS_LOG_PATH=/var/log/rwp-shop/access.log| Переменная | Описание | По умолчанию |
|---|---|---|
CORS_ALLOWED_ORIGINS |
Разрешённые источники через запятую | Fallback на BOT_ADMIN_URL |
# Один источникCORS_ALLOWED_ORIGINS=https://bot.example.com
# Несколько источниковCORS_ALLOWED_ORIGINS=https://bot.example.com,https://admin.example.comS3 хранилище
Заголовок раздела «S3 хранилище»| Переменная | Описание | По умолчанию |
|---|---|---|
S3_ENABLED |
Включить S3-совместимое хранилище (true/false) |
false |
S3_ENDPOINT |
Эндпоинт S3 API | — |
S3_ACCESS_KEY |
Ключ доступа S3 | — |
S3_SECRET_KEY |
Секретный ключ S3 | — |
S3_PUBLIC_URL |
Публичный HTTPS URL для presigned-ссылок | — |
S3_BUCKET |
Имя родительского бакета (опционально) | — |
S3_REGION |
Регион S3 | us-east-1 |
S3_FORCE_PATH_STYLE |
Адресация бакета: path-style (endpoint/bucket/key) включена по умолчанию; только точное значение false переключает на virtual-hosted style (bucket.endpoint/key) |
true |
Краткая справка
Заголовок раздела «Краткая справка»# === Обязательные ===TELEGRAM_TOKEN=DATABASE_URL=postgres://user:pass@db:5432/postgres?sslmode=disableBOT_ADMIN_URL=https://bot.example.comREMNAWAVE_URL=http://remnawave:3000REMNAWAVE_TOKEN=ADMIN_ID=123456789LICENSE_KEY=JWT_SECRET=
# === Необязательные ===BOT_WORKERS=3DEFAULT_LANGUAGE=ruHEALTH_CHECK_PORT=8080REMNAWAVE_MODE=remote# REMNAWAVE_HEADERS=# TELEGRAM_PROXY_URL=socks5://proxy:1080# TELEGRAM_API_URL=http://telegram-bot-api:8081
# === Пользователь для модерации приложения ===# REVIEW_USER_EMAIL=reviewer@example.com# REVIEW_USER_OTP=123456
# === AI-поддержка и база знаний ===# AI_KB_DATABASE_URL=postgres://kb:password@kb-db:5432/kb?sslmode=disable# AI_KB_POSTGRES_USER=kb# AI_KB_POSTGRES_PASSWORD=# AI_KB_POSTGRES_DB=kb# AI_PROXY_URL=socks5://proxy:1080
# === Логирование ===LOG_LEVEL=infoACCESS_LOG_ENABLED=false# ACCESS_LOG_PATH=
# === CORS ===# CORS_ALLOWED_ORIGINS=https://bot.example.com
# === S3 хранилище ===# S3_ENABLED=false# S3_ENDPOINT=# S3_ACCESS_KEY=# S3_SECRET_KEY=# S3_PUBLIC_URL=# S3_BUCKET=# S3_REGION=us-east-1# S3_FORCE_PATH_STYLE=true