外观
先看这张流程表
拿到激活码之后,整个流程是有序的,顺序错了会白折腾。按下面来:
| 步骤 | 做什么 | 在哪做 |
|---|---|---|
| 1 | 把远程配置文件准备好——填好、加密、放到你能提供的网络地址上 | 编辑器「远程配置文件」区 + 你自己的存储服务 |
| 2 | 在「远程配置源」里填上文件地址和加密密钥 | 编辑器左侧导航「远程配置源」 |
| 3 | 其余功能按需开启,不需要的保持关闭 | 编辑器「配置项」区 |
| 4 | 保存当前档案 | 编辑器底部 |
| 5 | 开始打包,等云端编译完下载产物 | 编辑器「软件打包」区 |
第 1、2 步不要跳过,也不要放到最后做
远程配置文件是客户端运行时才去读的东西,它决定了客户端启动后能拿到什么(站点地址、内置代理线路、在线客服等)。
如果这一步没做就打包,客户端装到用户设备上可能连不上你的站点,而这批产物已经发出去了,改配置还得重新打包重新分发。所以请一开始就把远程配置搞定。
第一步:把远程配置文件准备好
远程配置文件是一份 JSON,客户端启动时会去你指定的地址把它拉下来。你要做四件事:
1. 在编辑器里填写内容
打开「远程配置文件」区,按页面上的项目逐项填写。填的内容会实时生成一份完整的 OSS 配置文件。
2. 加密
编辑器提供 AES-256-GCM 加密。加密是可选的,但强烈建议做——配置文件里有站点地址、内置代理线路、在线客服凭据这类内容,明文放在公网地址上等于公开。
加密时需要设置一个解密密钥,请务必记好:下一步要用,客户端也要用它才能读。
3. 把文件放到你能提供的地址上
把生成好的文件(加密后的那份)上传到你自己的对象存储或任意能直接访问该文件的服务上,拿到一个可访问的地址。
要点:
- 这个地址必须能被终端用户直接打开,客户端是在用户设备上去拉它的
- 建议用 HTTPS
- 建议加 CDN 或做多域名冗余,这块是单点——地址打不开,客户端就没法初始化
4. 回到编辑器的「远程配置源」填写地址与密钥
打开左侧导航里的**「远程配置源」**,做两件事:
- 把上一步拿到的文件地址填进去(可以填多个,做冗余)
- 把加密密钥填进「加密密钥(可选)」
这一步做完,客户端才知道去哪里拉这份文件、用什么解开它。
详细操作见远程配置文件。
第二步:其余功能按需开启
远程配置搞定之后,其余配置项就随意了——每一项都可以独立决定开不开,不需要的保持关闭即可,不影响整体流程。
编辑器的「配置项」区按分类组织:
| 分类 | 管什么 |
|---|---|
| 应用信息与图标 | 客户端名称、图标、品牌信息 |
| 界面行为、布局与隐藏项 | 界面风格、启动与连接行为、各类元素显隐 |
| 功能入口 | 首页各入口(签到、礼品卡、客服、Telegram 等)显隐 |
| 实用工具 | 网速测试、IP 查询、CF 优选等工具的入口 |
| 订阅、面板 API 与 SSPanel | 订阅来源、请求头、解密密钥等 |
| 自动离线与订阅缓存 | 离线可用性与缓存时长 |
| 远程配置与 OSS | 远程配置内容(面板类型、官网地址等)、OSS 内置代理、在线客服 |
| 静态更新配置 | 各平台下载地址、更新提示 |
| 加密与密钥 | 密钥相关设置 |
每一项的含义与取值见配置项手册。
有一批功能需要对接码
配色、套餐状态拦截、邀请与注册、云端调度这类不是所有用户都需要的能力,收在「自定义功能」面板里,需要用对接码验证后才显示。没拿到码就看不到,也不影响其他功能。见自定义功能。
第三步:保存并打包
- 点「保存当前档案」 —— 配置改完必须先保存,再打包;只改控件不保存,改动不会进入这次打包。
- 在「软件打包」区选参数 —— 内核、源码分支、版本标签、要打哪些平台。
- 点「开始打包」 —— 云端开始编译,「打包进度」面板会实时显示进度。
- 编译完成后去打包记录里点「下载」 —— 拿到各平台安装包。
产物覆盖 Windows、macOS、Linux、Android、iOS:Mihomo 内核可以出全平台包(含 Android TV、软路由、iOS 巨魔 IPA),Xray 内核目前支持 Windows、Android(手机)和 macOS。具体能勾哪些平台,以界面上实际可勾选的为准。
完整流程图
text
[1] 打开站点 → 填入激活码登录
▼
[2] 选择客户端入口(老客户端 / 新客户端)
▼
[3] 先做远程配置:填写 → 加密 → 传到自己的存储服务 → 把地址与密钥填回「远程配置源」
▼
[4] 其余配置项按需开启(不需要的保持关闭)
▼
[5] 点「保存当前档案」
▼
[6] 在「软件打包」区选内核 / 源码分支 / 版本标签 / 平台 → 点「开始打包」
▼
[7] 云端编译完成 → 在打包记录里点「下载」拿到产物
▼
[8] 把产物安装到设备上使用登录后你会看到什么
两个客户端
登录后你会进入两个客户端之一,它们各有自己的编辑器和打包参数,界面长得不同但结构一致:
| 客户端 | 界面上的角标 | 说明 |
|---|---|---|
Xboard-Mihomo_sub | 老客户端 | 功能较传统的一支,可选 Mihomo 内核 或 Xray 内核 |
NexGen Client React | 新客户端 | 界面更现代的一支,与老客户端各自独立配置 |
「选择客户端入口」页上有两个客户端,点一张卡片进入对应的编辑器。
界面长什么样
打包出来的客户端实际界面,按客户端与界面版本分别展示,见界面预览。
编辑器里的三个区域
| 区域 | 位置 | 干什么 |
|---|---|---|
| 配置项区 | 左侧导航切换 | 按分类逐项填写客户端要用的配置;页面底部有「保存当前档案」按钮 |
| 软件打包区 | 页面标题「软件打包」 | 选择打包内核、源码分支、版本标签和打包平台,然后点「开始打包」 |
| 远程配置文件区 | 页面标题「远程配置文件」 | 生成 OSS 配置文件,下载或加密后上传到自己的存储服务 |
软件打包区还会显示当前能不能打包、已经打包过几次、以及打包队列的状态。提交之后出现「打包进度」面板,可以看进度,也可以点「停止打包」。
页面导航
| 页面 | 什么时候看 |
|---|---|
| 用激活码登录 | 第一次进站、登录失败、想换一个客户端 |
| 远程配置文件 | 填写、加密、上传远程配置,以及把地址与密钥填回编辑器 |
| 软件打包 | 选打包参数、提交打包、看进度、停止打包 |
| 打包记录与产物下载 | 下载产物、查看历史记录、删除记录 |
| 自定义功能 | 拿到对接码,想解锁配色或额外功能开关 |
| 配置项手册 | 查每一项配置的含义与取值 |
术语表
| 术语 | 指什么 |
|---|---|
| 激活码 | 你登录站点用的凭据,由给你开通的人提供(见如何购买);一个激活码决定了你能用哪些客户端、能打包多少次 |
| 档案 | 一套保存下来的配置。点「保存当前档案」就是把当前填的配置存成一份档案,打包时按这份档案来 |
| 远程配置文件 | 客户端启动时去指定地址拉取的一份 JSON,决定客户端运行时拿到的站点信息与各项远端设置 |
| 产物 | 打包出来的安装包文件,如各平台的客户端安装包、软路由 IPK 包、iOS 巨魔 IPA |
| 内核 | 客户端里负责代理协议处理的核心组件。打包时二选一:Mihomo 内核(全平台打包)或 Xray 内核(目前仅支持 Windows、Android(手机)和 macOS) |
| 面板 | 你自己的 XBoard / V2Board / SSPanel 站点,也就是客户端最终要连的那套服务 |