Skip to content

先看这张流程表

拿到激活码之后,整个流程是有序的,顺序错了会白折腾。按下面来:

步骤做什么在哪做
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 内置代理、在线客服
静态更新配置各平台下载地址、更新提示
加密与密钥密钥相关设置

每一项的含义与取值见配置项手册

有一批功能需要对接码

配色、套餐状态拦截、邀请与注册、云端调度这类不是所有用户都需要的能力,收在「自定义功能」面板里,需要用对接码验证后才显示。没拿到码就看不到,也不影响其他功能。见自定义功能

第三步:保存并打包

  1. 点「保存当前档案」 —— 配置改完必须先保存,再打包;只改控件不保存,改动不会进入这次打包。
  2. 在「软件打包」区选参数 —— 内核、源码分支、版本标签、要打哪些平台。
  3. 点「开始打包」 —— 云端开始编译,「打包进度」面板会实时显示进度。
  4. 编译完成后去打包记录里点「下载」 —— 拿到各平台安装包。

产物覆盖 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 站点,也就是客户端最终要连的那套服务

本文档依据 Xboard-Mihomo-builds 源码整理