{% extends "base.html" %} {% from "partials/instruction_modals.html" import instruction_modal %} {% block title %}Инструкции{% endblock %} {% block title_header %}Инструкции{% endblock %} {% block content %}

Инструкции

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

Смена секретного пути
Текущий: /{{ admin_secret_path or 'admin123' }}/
{% for hp in hosting_providers or [] %}
{{ hp.name }}
Быстрый переход к хостинг-провайдеру. {% if hp.login or hp.password %}
Логин: {{ hp.login or '—' }}
Пароль: {{ hp.password or '—' }} {% endif %}
Перейти на хостинг
{% else %}
U1 HOST
Быстрый переход к хостинг-провайдеру (по умолчанию).
Перейти на хостинг
{% endfor %}
Запуск бота на PC
Windows 10+ · Локальный запуск для разработчиков
Скачать архив
Редактирование текстов
HTML-оформление сообщений и новостей
Открыть тексты
Методы оплаты
YooKassa, Platega, TG Star, CryptoBot, YooMoney
Открыть настройки
Обновление сертификата
Замена домена и обновление SSL
Приветственное видео
Добавление видео для триала пользователей
Конфигуратор ключа
Использование шаблонов ключей вместо запросов в 3X-UI
Парсер логов nginx
Сбор данных об устройствах пользователей из access.log
{% call instruction_modal('secretPathModal', 'Инструкция: смена секретного пути', 'bi-shield-lock', 'Инструкция: смена секретного пути') %}
Смена секретного пути нужна для защиты страницы входа в веб-админку.

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

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

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

Было (пример)
location /{{ admin_secret_path or 'admin123' }}/ { rewrite ^/{{ admin_secret_path or '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://домен/ВАШ_ПУТЬ/.

Важно: не используйте короткие/очевидные пути и не передавайте новый путь посторонним.
{% endcall %} {% call instruction_modal('pcLaunchModal', 'Инструкция: запуск бота на PC', 'bi-hdd-rack', 'Инструкция: запуск бота на PC') %}
  1. Скачайте архив проекта кнопкой «Скачать архив» на карточке «Запуск бота на PC» и распакуйте в отдельную папку.
  2. Установите Python и зависимости проекта.
  3. Заполните `.env` и проверьте настройки БД/бота.
  4. Запустите основной процесс проекта через ваш стартовый скрипт.
Базовые команды (пример)
python -m venv .venv .venv\Scripts\activate pip install -r requirements.txt python main.py
{% endcall %} {% call instruction_modal('textsModal', 'Инструкция: редактирование текстов', 'bi-fonts', 'Инструкция: редактирование текстов') %}
  1. Откройте Настройки → Тексты в панели администратора.
  2. Выберите нужный шаблон сообщения и отредактируйте контент.
  3. Используйте безопасное HTML-оформление и проверяйте предпросмотр.
  4. Сохраните и проверьте итоговое сообщение в боте.
{% endcall %} {% call instruction_modal('payInstructionModal', 'Инструкция: методы оплаты', 'bi-credit-card-2-front', 'Инструкция: методы оплаты') %}
Включение/выключение методов оплаты и ввод ключей выполняется в разделе: Настройки → Основные → Методы оплаты.
Важно: для теста платежей используйте отдельные тестовые ключи и убедитесь, что webhook URL доступен из интернета.

1) YooKassa

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

2) Platega

  1. Перейдите на сайт Platega и зарегистрируйтесь.
  2. Свяжитесь с менеджером для получения ключей доступа:
    platega_merchant_id — ID мерчанта
    platega_api_secret — секретный ключ API
  3. После успешного получения ключей добавьте вебхук (Callback URL) в личном кабинете Platega:
Пример callback URL
https://ваш-домен/payments/platega/callback
  1. В админке откройте Настройки → Основные → Методы оплаты и заполните полученные ключи.
  2. Настройте методы оплаты в поле platega_enabled_methods:
Примеры platega_enabled_methods
[2] // Только СБП [2, 10] // СБП и Карты RUB
Внимание: изменение набора методов Platega выполняется через персонального менеджера. Если нужен новый метод — напишите ему.

3) CryptoBot

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

4) YooMoney

  1. Создайте OAuth-приложение в YooMoney и получите токен.
  2. Заполните поля: yoomoney_token, yoomoney_account, yoomoney_notification_secret.
  3. Настройте HTTP-уведомления (webhook) в YooMoney:
Пример webhook URL
https://ваш-домен/payments/yoomoney/webhook
Важно: настройка YooMoney может быть сложной для неопытных пользователей и требует внимательной проверки OAuth + webhook.

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

  1. Для Telegram Stars просто включите метод show_payment_tgstar.
  2. Для ручной оплаты заполните ссылки: manual_transfer_link_30, manual_transfer_link_60, manual_transfer_link_90.
  3. Включите метод show_payment_manual и сохраните настройки.
{% endcall %} {% call instruction_modal('sslModal', 'Инструкция: обновление сертификата', 'bi-globe', 'Инструкция: обновление сертификата') %}
  1. Обновите DNS-запись домена на актуальный IP сервера.
  2. Проверьте, что 80/443 порты доступны извне.
  3. Запустите пере-выпуск сертификата через системный скрипт.
  4. Перезапустите веб-сервис и проверьте сертификат в браузере.
Если используется CDN/прокси, убедитесь, что origin-сертификат и режим SSL настроены корректно.
{% endcall %} {% call instruction_modal('welcomeVideoModal', 'Инструкция: приветственное видео', 'bi-play-circle', 'Инструкция: приветственное видео') %}
  1. Подготовьте видеофайл в подходящем размере и формате.
  2. Загрузите видео в раздел текстов/медиа приветствия.
  3. Проверьте сценарий отправки для новых пользователей (trial).
  4. Протестируйте выдачу на тестовом аккаунте.
{% endcall %} {% call instruction_modal('keyConfiguratorModal', 'Инструкция: конфигуратор ключа', 'bi-key', 'Инструкция: конфигуратор ключа') %}
  1. Откройте раздел панели, где настраиваются шаблоны ключей.
  2. Укажите формат ссылки и нужные переменные шаблона.
  3. Сохраните шаблон и выполните тестовую генерацию.
  4. Проверьте, что выдача ключа не требует прямого запроса в 3X-UI.
{% endcall %} {% call instruction_modal('nginxParserModal', 'Инструкция: парсер логов nginx', 'bi-file-earmark-text', 'Инструкция: парсер логов nginx') %}
  1. Убедитесь, что `access.log` доступен для чтения сервисом.
  2. Откройте инструмент парсинга логов и задайте период анализа.
  3. Запустите парсер и дождитесь завершения обработки.
  4. Проверьте карточки устройств/браузеров и экспорт отчета при необходимости.
{% endcall %} {% endblock %} {% block scripts %} {% include "partials/instruction_modals_script.html" %} {% endblock %}