Подробное руководство для Android

Обучающая статья по Black Fox Config Builder

Пошаговое руководство по управлению панелью 3X-UI (Sanaei) на Android в Config Builder: одиночные и массовые аккаунты, QR-коды и ссылки подписки в пару касаний.

Назначение приложения и первый запуск

  • Не является VPN-клиентом: внутри Config Builder нет VPN-ядра и трафик телефона не меняется — приложение напрямую отправляет команды вашему серверу 3X-UI.
  • Выбор языка при первом запуске: сразу при открытии Config Builder появляется экран выбора одного из 10 языков.
  • Безопасность данных: все пароли, cookie и ключи панели шифруются средствами системы (Android Secure Storage).

Общая структура экрана (верхняя и нижняя панели)

  • Индикатор статуса сверху: Disconnected (серый) означает отсутствие подключения, Connected (зелёный) — готовность к работе.
  • Всплывающая полоса уведомлений (Toast): показывает статус в реальном времени (выполняется / успешно / ошибка).
  • 6 вкладок снизу: Connection, Single, Bulk, List, Settings и Contact.

1. Язык, обновления и журнал активности (Settings)

На пятой вкладке (Settings) управляются язык интерфейса, обновления и диагностические логи Config Builder:

  • Выбор языка (Language): список из 10 языков. При выборе персидского интерфейс мгновенно переключается в RTL.
  • Проверка обновлений (Check for updates): сравнивает установленную версию с сервером и при наличии обновления скачивает APK с прогрессом (%) и запускает установку.
  • Обновления и конфиг сервера (Updates & Remote Config): показывает версию на сервере и позволяет вручную обновить данные с двух серверов (blackfoxupdate.ir и foxnext.net).
  • Журнал активности (Activity log): автоматически записывает события с отметкой времени ([INFO], [OK], [ERROR]). Используйте Copy log и Clear log.
Рис. 1: Экран настроек (Settings) и журнал активности в Config Builder
Рис. 1: Экран настроек (Settings) и журнал активности в Config Builder

2. Безопасное подключение к панели 3X-UI (Connection)

На первой вкладке введите данные панели 3X-UI. Config Builder поддерживает два способа авторизации:

  • Panel URL (обязательно): полный адрес панели с протоколом, портом и путём, например https://sub.domain.com:2053/mybase.
  • Username и Password: стандартные данные входа (пароль скрыт точками).
  • API Key (optional): при вводе API-ключа автоматически включается режим API, поля логина/пароля блокируются, а операции выполняются быстрее.
  • Sub URI (optional): базовый адрес подписки, если он вынесен на отдельный домен или порт.

Назначение 4 кнопок

  • Connect: проверяет и сохраняет данные в защищённом хранилище, подключается к панели и загружает список inbound. Сессия активна до отключения.
  • Disconnect: активна только при подключении; закрывает сессию и очищает экраны создания.
  • Save: сохраняет введённые данные локально без подключения.
  • Delete: разрывает соединение и удаляет все сохранённые данные панели с устройства.
Рис. 2: Экран подключения к панели (Connection) в Config Builder
Рис. 2: Экран подключения к панели (Connection) в Config Builder

3. Создание одиночного конфига (Single)

Когда индикатор станет зелёным (Connected), перейдите на вторую вкладку:

  • Config name: только латинские буквы, цифры, пробелы и дефис (-); дубликаты запрещены. Значок ↻ создаёт случайное имя вида Black fox-XXXXXX.
  • Traffic (GB): по умолчанию 10 ГБ; значение 0 означает безлимитный трафик.
  • Duration (days): по умолчанию 30 дней; значение 0 означает бессрочный доступ.
  • Выбор Inbound: выпадающий список с форматом протокол · заметка · порт · статус; можно выбрать сразу несколько inbound и обновить список.
  • Create config: мгновенно создаёт конфиг и сохраняет его в локальную историю.

Результат создания

  • Две отдельные ссылки: прямая ссылка Config link и ссылка подписки Sub link.
  • Два QR-кода: Config QR и Sub QR — нажмите на любой QR-код для мгновенного копирования ссылки.
  • Clear page: очищает форму и результат после подтверждения.
Совет для пользователей v2rayNG: чтобы в v2rayNG автоматически отображались имя подписки, остаток трафика и срок действия, отправляйте Sub link или Sub QR.
Рис. 3: Экран одиночного создания (Single) в Config Builder
Рис. 3: Экран одиночного создания (Single) в Config Builder

4. Массовое создание конфигов (Bulk)

На третьей вкладке удобно выпускать сразу десятки конфигов:

  • Base name: префикс имён (например, Team) или случайное имя через ↻.
  • Count: количество клиентов (по умолчанию 10). Итог = Count × число выбранных Inbound.
  • Traffic и Duration: применяются ко всей партии (0 = безлимит).
  • Индикатор прогресса и Stop: отображается полоса прогресса, счётчик и кнопка Stop.

Удобное копирование результатов

  • Двухколоночная таблица: Config link и Sub link с синими номерами строк; нажатие на ячейку копирует ссылку.
  • Копирование пары по номеру (Link number + Copy): введите номер строки и нажмите Copy, чтобы скопировать обе ссылки сразу.
Рис. 4: Экран массового создания (Bulk) в Config Builder
Рис. 4: Экран массового создания (Bulk) в Config Builder

5. История и удаление с сервера (List)

Все созданные конфиги хранятся на четвёртой вкладке (List). Когда список пуст, отображается No configs created yet..

  • Строка списка: имя, объём (GB), срок (дни) и превью ссылки.
  • Выбор элементов: чекбоксы, Select all и счётчик Selected: N.
  • Меню ⋮: Copy link (копировать ссылки построчно), Delete from panel (удаление с сервера 3X-UI и из телефона; требует подключения и показывает отчёт при массовом удалении) и Delete from list (удаление только из памяти телефона).
Рис. 5: Экран списка и истории (List) в Config Builder
Рис. 5: Экран списка и истории (List) в Config Builder

6. Поддержка и официальные каналы (Contact)

На вкладке Contact собраны официальные ссылки проекта:

  • Сайт: www.foxnext.net
  • Email: [email protected]
  • GitHub: BlackFoxGroup
  • Канал Telegram: @BlackFoxVpnn
  • Поддержка Telegram: @HiBlackFox
  • Бот покупки и сервиса: @BlackFox_Agent_Bot
  • Группа Telegram: @Black_Fox_Group
Динамическое обновление: контакты подтягиваются с foxnext.net при открытии вкладки Contact.
Рис. 6: Экран контактов (Contact) в Config Builder
Рис. 6: Экран контактов (Contact) в Config Builder

7. Таблица ошибок и частые вопросы

Ошибка или проблемаПричинаРешение
No inbounds found on the panelНет подключения к панели или отсутствуют активные inbound.Нажмите Connect во вкладке Connection и проверьте наличие активного inbound в 3X-UI.
Не удаётся подключиться / Connect failedНеверный URL, закрытый порт или конфликт с VPN устройства.Укажите полный Panel URL с протоколом, портом и путём, проверьте при включённом/выключенном VPN и посмотрите лог в Settings.
Версия панели не поддерживаетсяУстаревшая версия 3X-UI на сервере.Обновите 3X-UI до версии 3.3.0 или выше.
Ошибка недопустимого или дублирующегося имениНелатинские символы, спецзнаки или повтор имени.Используйте только английские буквы, цифры, пробелы и - или значок ↻.
Автообновление APK не устанавливаетсяЗапрет установки из неизвестных источников в Android.Разрешите Install unknown apps для Config Builder и повторите установку.