Установка Cabinet

​

Шаг 1. Настройка backend бота

# Включить Cabinet API
CABINET_ENABLED=true

# JWT секрет (сгенерируйте: openssl rand -hex 32)
CABINET_JWT_SECRET=your_random_secret_key_here

# Домен кабинета для CORS
CABINET_ALLOWED_ORIGINS=https://cabinet.example.com

make reload

​

Шаг 2. Получение frontend файлов

​

Вариант A: Docker образ (рекомендуется)

docker pull ghcr.io/bedolaga-dev/bedolaga-cabinet:latest

# Извлечь статику
docker create --name tmp_cabinet ghcr.io/bedolaga-dev/bedolaga-cabinet:latest
docker cp tmp_cabinet:/usr/share/nginx/html ./cabinet-dist
docker rm tmp_cabinet

​

Вариант B: Сборка из исходников (через Docker)

git clone https://github.com/BEDOLAGA-DEV/bedolaga-cabinet.git
cd bedolaga-cabinet
cp .env.example .env

VITE_API_URL=/api
VITE_TELEGRAM_BOT_USERNAME=your_bot_username
VITE_APP_NAME=My VPN
VITE_APP_LOGO=V

docker compose build
docker create --name tmp_cabinet cabinet_frontend
docker cp tmp_cabinet:/usr/share/nginx/html ./cabinet-dist
docker rm tmp_cabinet

​

Вариант C: Сборка без Docker (через npm)

# Установка NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc

# Установка Node.js LTS
nvm install --lts

git clone https://github.com/BEDOLAGA-DEV/bedolaga-cabinet.git
cd bedolaga-cabinet
cp .env.example .env
# Отредактируйте .env (VITE_API_URL, VITE_TELEGRAM_BOT_USERNAME и т.д.)

npm install
npm run build

sudo mkdir -p /srv/cabinet
sudo cp -r ./dist/* /srv/cabinet/

​

Шаг 3. Размещение файлов на сервере

# Создайте директорию
sudo mkdir -p /srv/cabinet

# Скопируйте файлы
sudo cp -r ./cabinet-dist/* /srv/cabinet/

​

Шаг 4. Настройка обратного прокси

​

Шаг 5. Запуск и проверка

# Перезагрузите Caddy
docker exec <caddy_container> caddy reload --config /etc/caddy/Caddyfile

# Или Nginx
docker exec <nginx_container> nginx -s reload

​

Альтернативная установка: Docker контейнер

​

docker-compose.yml

services:
  cabinet-frontend:
    image: ghcr.io/bedolaga-dev/bedolaga-cabinet:latest
    container_name: cabinet_frontend
    restart: unless-stopped
    networks:
      - bot_network

networks:
  bot_network:
    external: true
    name: remnawave-bedolaga-telegram-bot_bot_network

​

Caddyfile

https://cabinet.example.com {
    encode gzip zstd

    # API запросы → backend бота
    handle /api/* {
        uri strip_prefix /api
        reverse_proxy remnawave_bot:8080
    }

    # Frontend → nginx контейнер (порт 80 внутри Docker сети)
    handle {
        reverse_proxy cabinet_frontend:80
    }
}

​

Устранение проблем

​

CORS ошибка в консоли браузера

​

API возвращает HTML вместо JSON

​

502 Bad Gateway

1. Backend бота не запущен — проверьте docker ps
2. Контейнеры в разных Docker сетях:
   # Проверить сети контейнера
   docker inspect <container> --format='{{json .NetworkSettings.Networks}}' | python3 -m json.tool
   
   # Подключить к нужной сети
   docker network connect <network_name> <container_name>
   
3. Неправильное имя сервиса:
   docker exec <caddy_container> wget -qO- http://remnawave_bot:8080/health
   

​

Telegram авторизация не работает

1. VITE_TELEGRAM_BOT_USERNAME должен быть без @
2. Домен кабинета добавлен в BotFather → Bot Settings → Domain

​

Белый экран / SPA не работает

​

Белый экран, ошибка входа или бесконечная загрузка

1. Telegram → Настройки (меню слева)
2. Пролистайте в самый низ до номера версии
3. Зажмите палец на версии на пару секунд → отпустите (появится смайлик)
4. Зажмите на версии ещё раз → откроется Debug Menu
5. Нажмите «Clear WebView cache»
6. Вернитесь в бот

1. Telegram → вкладка «Настройки» (внизу справа)
2. Быстро тапните по иконке настроек 10 раз подряд (за 2-3 секунды)
3. Откроется Debug Menu
4. Нажмите «Clear WebView cache»
5. Вернитесь в бот

1. Настройки → Продвинутые настройки
2. Внизу нажмите «Experimental settings»
3. Очистите данные WebView
4. Перезапустите бот

1. Быстро кликните 5 раз по иконке «Настройки» внизу
2. Откроется Debug Menu
3. Нажмите «Clear WebView cache»
4. Перезайдите в бот

1. Полностью закройте Telegram (не сверните, а именно закройте) и откройте заново
2. Удалите чат с ботом и запустите заново через /start
3. Если ничего не помогает — переустановите Telegram. Все чаты, подписки и контакты хранятся в облаке и никуда не денутся