Black Fox Group
FA

移动端完整教程

Black Fox Config Builder 教程文章

使用 Config Builder 在手机端管理 3X-UI (Sanaei) 面板的分步指南：快速创建单个或批量配置、生成二维码、复制订阅链接及管理用户。

Config Builder 产品页 返回全部教程 直接下载 APK

应用定位与首次启动

  • 非 VPN 客户端：Config Builder 内置无任何代理核心，不会改变手机网络流量，仅向您的 3X-UI 服务器发送管理指令。
  • 首次启动选择语言：首次打开 Config Builder 时会弹出语言选择页，可在 10 种语言中任选。
  • 凭据安全：所有面板密码与 API 密钥均通过系统级 Android Secure Storage 加密保存。

界面整体结构（顶部与底部栏）

  • 顶部状态栏：Disconnected（灰色）表示未连接，Connected（绿色）表示已就绪。
  • 悬浮提示条 (Toast)：在连接、保存或删除时实时提示进行中、成功或错误状态。
  • 底部 6 个标签页：Connection、Single、Bulk、List、Settings、Contact。

1. 语言切换、更新与活动日志（Settings）

在第五个标签页（Settings）中可以管理语言、版本更新与运行日志：

  • Language（语言）：下拉支持 10 种语言，选择波斯语会立即切换为完整 RTL 布局。
  • Check for updates（检查更新）：对比当前版本与服务器版本，若有新版本可带百分比进度直接下载并安装 APK（强制更新会立即弹窗）。
  • Updates & Remote Config：查看服务器版本并从双服务器（blackfoxupdate.ir 与 foxnext.net）手动刷新版本、钱包和公告信息。
  • Activity log（活动日志）：自动记录带时间戳的 [INFO]、[OK]、[ERROR] 日志，支持 Copy log 与 Clear log。
图 1：Config Builder 设置与活动日志界面
图 1：Config Builder 设置与活动日志界面

2. 安全连接 3X-UI 面板（Connection）

在第一个标签页输入面板信息，Config Builder 支持两种认证方式：

  • Panel URL（必填）：完整面板地址（含协议、端口与路径），例如 https://sub.domain.com:2053/mybase。
  • Username 与 Password：标准面板登录账号密码。
  • API Key (optional)：填写 API 密钥后将自动启用 API 模式并锁定账号密码框，提升连接与生成速度。
  • Sub URI (optional)：如订阅地址使用独立域名或端口，可在此填写基础 URL；否则留空。

4 个按钮说明

  • Connect：校验并安全保存凭据、连接面板并立即拉取 Inbound 列表，会话在断开前保持有效。
  • Disconnect：仅在已连接时可用，关闭当前会话并清空生成页。
  • Save：仅保存凭据到本地安全存储，不立即连接。
  • Delete：断开当前连接并清除手机内保存的面板信息。
图 2：Config Builder 面板连接界面
图 2：Config Builder 面板连接界面

3. 创建单个配置（Single）

顶部状态变为绿色（Connected）后，进入第二个标签页：

  • Config name：仅允许英文字母、数字、空格与连字符（-），自动拦截重名；点击 ↻ 可生成 Black fox-XXXXXX 格式随机名称。
  • Traffic (GB)：默认 10 GB，输入 0 表示不限流量。
  • Duration (days)：默认 30 天，输入 0 表示不限时长。
  • 选择 Inbound：支持多选面板入站节点，并可随时点击刷新图标同步。
  • Create config：点击蓝色按钮即可立即生成配置并写入历史记录。

生成结果区

  • 两个独立链接：分别展示直连 Config link 与订阅 Sub link。
  • 两个独立二维码：并排显示 Config QR 与 Sub QR，轻触二维码即可复制链接。
  • Clear page：弹窗确认后清空当前表单与结果。
v2rayNG 使用建议：若希望在 v2rayNG 等客户端中自动显示套餐名称、剩余流量与到期天数，请发送 Sub 链接或 Sub 二维码。
图 3：Config Builder 单个配置生成界面
图 3：Config Builder 单个配置生成界面

4. 批量生成配置（Bulk）

在第三个标签页可一次性批量生成多个配置：

  • Base name：账号名称前缀（如 Team），点击 ↻ 生成唯一随机前缀。
  • Count：需要生成的数量（默认 10），总数量 = Count × 所选 Inbound 数量。
  • Traffic & Duration：统一应用于整批配置（0 = 无限制）。
  • 进度条与 Stop：点击 Create bulk configs 后显示进度条、计数器及 Stop 按钮。

批量链接管理

  • 双列网格：并排展示 Config link 与 Sub link，轻触任意单元格即可复制。
  • 按行号成对复制（Link number + Copy）：输入行号后点击 Copy，可同时复制该行的两条链接。
图 4：Config Builder 批量生成界面
图 4：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：Config Builder 历史列表界面
图 5：Config Builder 历史列表界面

6. 联系与官方支持（Contact）

最后一个标签页（Contact）汇聚了官方支持渠道：

  • 官方网站：www.foxnext.net
  • 支持邮箱：[email protected]
  • GitHub 仓库：BlackFoxGroup
  • Telegram 官方频道：@BlackFoxVpnn
  • Telegram 客服：@HiBlackFox
  • 购买与服务机器人：@BlackFox_Agent_Bot
  • Telegram 交流群：@Black_Fox_Group
动态更新：打开 Contact 标签页时会从 foxnext.net 拉取最新联系地址。
图 6：Config Builder 联系与支持界面
图 6：Config Builder 联系与支持界面

7. 常见错误与故障排除

错误或问题主要原因解决步骤
No inbounds found on the panel尚未连接面板或面板中无启用的 Inbound。先在 Connection 点击 Connect 至状态变绿，再确认 3X-UI 至少启用了一个 Inbound。
无法连接 / Connect failed地址错误、端口未开放或手机 VPN 冲突。输入包含协议、端口与路径的完整 Panel URL，尝试切换手机 VPN 开关后重试，并在 Settings 查看日志。
面板版本不受支持服务器 3X-UI 版本过旧。将服务器上的 3X-UI 升级到 3.3.0 或更高版本。
名称非法或重复错误使用了非英文字符、特殊符号或重复名称。仅使用英文字母、数字、空格和 -，或点击 ↻ 生成唯一名称。
自动更新 APK 无法安装Android 限制安装未知来源应用。在系统提示时为 Config Builder 开启 Install unknown apps 权限后重新安装。
Config Builder 产品页 返回全部教程 APKPure 页面