Инструкции

Подробные руководства по настройке и использованию системы

Смена секретного пути

Текущий: /admin123/

U1 HOST

Быстрый переход к хостинг-провайдеру.

Перейти на хостинг

Запуск бота на PC

Windows 10+ · Локальный запуск для разработчиков

Скачать архив

Редактирование текстов

HTML-оформление сообщений и новостей

Открыть тексты

Методы оплаты

YooKassa, Platega, TG Star, CryptoBot, YooMoney

Открыть настройки

Обновление сертификата

Замена домена и обновление SSL

Приветственное видео

Добавление видео для триала пользователей

Конфигуратор ключа

Использование шаблонов ключей вместо запросов в 3X-UI

Парсер логов nginx

Сбор данных об устройствах пользователей из access.log

Инструкция: смена секретного пути

Смена секретного пути нужна для защиты страницы входа в веб-админку.

1. В веб-админке в разделе Настройки → Основные найдите параметр admin_secret_path.

2. Укажите желаемый путь, например: GfyuoiPood, затем нажмите Сохранить. Допустимы латиница, цифры, - и _, без пробелов и /.

3. На сервере откройте конфиг nginx (/etc/nginx/sites-available/buryatvpn или ваш конфиг) и измените location:

Было (пример)

location /admin123/ { rewrite ^/admin123/(.*)$ /$1 break; proxy_pass http://127.0.0.1:16389/; 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 /GfyuoiPood/ { rewrite ^/GfyuoiPood/(.*)$ /$1 break; proxy_pass http://127.0.0.1:16389/; 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; }

4. Проверьте конфиг и перезагрузите nginx:

Команда применения

sudo nginx -t && sudo systemctl reload nginx

5. Входите по новому адресу: https://домен/ВАШ_ПУТЬ/.

Важно: не используйте короткие/очевидные пути и не передавайте новый путь посторонним.

Инструкция: запуск бота на PC

Скачайте архив проекта кнопкой «Скачать архив» на карточке «Запуск бота на PC» и распакуйте в отдельную папку.
Установите Python и зависимости проекта.
Заполните `.env` и проверьте настройки БД/бота.
Запустите основной процесс проекта через ваш стартовый скрипт.

Базовые команды (пример)

python -m venv .venv .venv\Scripts\activate pip install -r requirements.txt python main.py

Инструкция: редактирование текстов

Откройте Настройки → Тексты в панели администратора.
Выберите нужный шаблон сообщения и отредактируйте контент.
Используйте безопасное HTML-оформление и проверяйте предпросмотр.
Сохраните и проверьте итоговое сообщение в боте.

Инструкция: методы оплаты

Включение/выключение методов оплаты и ввод ключей выполняется в разделе: Настройки → Основные → Методы оплаты.

Важно: для теста платежей используйте отдельные тестовые ключи и убедитесь, что webhook URL доступен из интернета.

1) YooKassa

Зарегистрируйте магазин в YooKassa. В личном кабинете получите Shop ID и Secret Key.
В меню кабинета перейдите в раздел Настройки → HTTP-уведомления и добавьте URL.
В админке откройте Настройки → Основные → Методы оплаты и заполните поля:
yookassa_shop_id — ID магазина
yookassa_secret_key — секретный ключ
Включите переключатель «Показывать метод оплаты YooKassa».
Сохраните настройки. Теперь пользователю будет предложен YooKassa.

Пример callback URL

https://ваш-домен/payments/yookassa/webhook

2) Platega

Перейдите на сайт Platega и зарегистрируйтесь.
Свяжитесь с менеджером для получения ключей доступа:
platega_merchant_id — ID мерчанта
platega_api_secret — секретный ключ API
После успешного получения ключей добавьте вебхук (Callback URL) в личном кабинете Platega:

Пример callback URL

https://ваш-домен/payments/platega/callback

В админке откройте Настройки → Основные → Методы оплаты и заполните полученные ключи.
Настройте методы оплаты в поле platega_enabled_methods:

Примеры platega_enabled_methods

[2] // Только СБП [2, 10] // СБП и Карты RUB

Внимание: изменение набора методов Platega выполняется через персонального менеджера. Если нужен новый метод — напишите ему.

3) CryptoBot

Откройте бота @CryptoBot.
В разделе API создайте приложение и получите API Token.
В админке укажите cryptobot_token и включите метод оплаты CryptoBot.
Сохраните. Счет создается ботом автоматически.

4) YooMoney

Создайте OAuth-приложение в YooMoney и получите токен.
Заполните поля: yoomoney_token, yoomoney_account, yoomoney_notification_secret.
Настройте HTTP-уведомления (webhook) в YooMoney:

Пример webhook URL

https://ваш-домен/payments/yoomoney/webhook

Важно: настройка YooMoney может быть сложной для неопытных пользователей и требует внимательной проверки OAuth + webhook.

5) Telegram Stars и ручные методы

Для Telegram Stars просто включите метод show_payment_tgstar.
Для ручной оплаты заполните ссылки: manual_transfer_link_30, manual_transfer_link_60, manual_transfer_link_90.
Включите метод show_payment_manual и сохраните настройки.

Инструкция: обновление сертификата

Обновите DNS-запись домена на актуальный IP сервера.
Проверьте, что 80/443 порты доступны извне.
Запустите пере-выпуск сертификата через системный скрипт.
Перезапустите веб-сервис и проверьте сертификат в браузере.

Если используется CDN/прокси, убедитесь, что origin-сертификат и режим SSL настроены корректно.

Инструкция: приветственное видео

Подготовьте видеофайл в подходящем размере и формате.
Загрузите видео в раздел текстов/медиа приветствия.
Проверьте сценарий отправки для новых пользователей (trial).
Протестируйте выдачу на тестовом аккаунте.

Инструкция: конфигуратор ключа

Откройте раздел панели, где настраиваются шаблоны ключей.
Укажите формат ссылки и нужные переменные шаблона.
Сохраните шаблон и выполните тестовую генерацию.
Проверьте, что выдача ключа не требует прямого запроса в 3X-UI.

Инструкция: парсер логов nginx

Убедитесь, что `access.log` доступен для чтения сервисом.
Откройте инструмент парсинга логов и задайте период анализа.
Запустите парсер и дождитесь завершения обработки.
Проверьте карточки устройств/браузеров и экспорт отчета при необходимости.