Подробное руководство для 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.
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: разрывает соединение и удаляет все сохранённые данные панели с устройства.
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.
4. Массовое создание конфигов (Bulk)
На третьей вкладке удобно выпускать сразу десятки конфигов:
- Base name: префикс имён (например,
Team) или случайное имя через↻. - Count: количество клиентов (по умолчанию
10). Итог =Count × число выбранных Inbound. - Traffic и Duration: применяются ко всей партии (
0= безлимит). - Индикатор прогресса и Stop: отображается полоса прогресса, счётчик и кнопка
Stop.
Удобное копирование результатов
- Двухколоночная таблица:
Config linkиSub linkс синими номерами строк; нажатие на ячейку копирует ссылку. - Копирование пары по номеру (Link number + Copy): введите номер строки и нажмите
Copy, чтобы скопировать обе ссылки сразу.
5. История и удаление с сервера (List)
Все созданные конфиги хранятся на четвёртой вкладке (List). Когда список пуст, отображается No configs created yet..
- Строка списка: имя, объём (GB), срок (дни) и превью ссылки.
- Выбор элементов: чекбоксы,
Select allи счётчикSelected: N. - Меню ⋮:
Copy link(копировать ссылки построчно),Delete from panel(удаление с сервера 3X-UI и из телефона; требует подключения и показывает отчёт при массовом удалении) иDelete from list(удаление только из памяти телефона).
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.
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 и повторите установку. |