外观
本页覆盖两个客户端编辑器里的三组选项:OSS 配置文件 配置项、OSS 内置代理配置(clientProxy)、OSS 在线客服配置(onlineSupport)。编辑器会根据这里填写的内容实时生成 OSS 配置文件,下载或加密后下发到 OSS,客户端启动时读取这份文件。
密钥与加密流程见 加密与密钥;静态更新配置(update)见 静态更新配置。
OSS 配置文件 配置项
面板类型(panelType)
- 控件:下拉选择
- 取值范围:
sspanel/v2board/xboard
请选择当前站点使用的面板类型:
sspanel:SSPanel 系面板v2board:V2Board 系面板;如果是 xiaov2board,请选择 v2boardxboard:XBoard 面板
提示
NexGen React 编辑器中 v2board 这一项显示为 v2board/xiaoV2board,与 Xboard-Mihomo 编辑器中的 v2board 是同一个取值。
官网地址(websiteUrl)
- 控件:文本框
- 示例:
https://your-site.com
这个地址就是客户端顶栏「官网」按钮的跳转目标——用户在客户端里点那个按钮,会用系统自带浏览器打开你在这里填的网址。通常填你的主站域名,例如 https://your-site.com。
几点实际行为:
| 行为 | 说明 |
|---|---|
| 显示条件 | 只有填了才出现。留空时客户端顶栏上的官网按钮整个隐藏,不是点了没反应 |
| 位置 | 顶栏上,紧跟在 Telegram 入口之后 |
| 打开方式 | 用系统默认浏览器打开,不在客户端内部打开 |
| 地址不可用 | 地址格式不对或打不开时,客户端会弹出「打开失败」提示,不会静默无响应 |
改这个地址不用重新打包
它放在 OSS 上,客户端启动时拉取,改完即时生效——不像写在档案里的配置项那样需要重新打包。
站点分组名称(OSS 配置文件 > panels 键名)
- 控件:文本框
- 示例:必须与基础设置中的“站点分组名称”完全一致
这个值会作为 OSS 配置文件 中 panels 的键名,必须与基础设置里的“站点分组名称”对应。两个编辑器对它的处理方式不同:
Xboard-Mihomo 编辑器——需要手工填写。界面上的原文提示是:
这里非常重要:这个值必须与基础设置里的“站点分组名称”完全一致,包括大小写。建议两个地方都直接填写品牌名;OSS 配置文件 会用它作为 panels 的键名,如果不一致,软件可能无法正确识别站点,甚至无法正常启动。
NexGen React 编辑器——这个输入框是只读的,自动跟随当前档案名称并写入 panels,不需要手工比对。
重要
在 Xboard-Mihomo 编辑器里,这个值一旦与基础设置中的“站点分组名称”不一致(包括大小写差异),软件可能无法正确识别站点,甚至无法正常启动。请务必逐字核对,建议两处都直接填写同一个品牌名。
OSS 内置代理配置(clientProxy)
先弄清它是什么:给客户端自己用的,不是给用户上网用的
内置代理只承载客户端自己的通讯请求——比如向你的面板请求用户信息、节点列表和订阅,以及检查更新、查询云端调度、打开在线客服这类由客户端主动发起的事。
用户的上网流量根本不经过它,那部分由用户订阅的节点负责。
所以它不是"给用户提供翻墙线路",而是保证客户端自己能把话说出去。
哪些请求走它,哪些不走
| 请求类型 | 走不走内置代理 |
|---|---|
拉取 OSS 上的 OSS 配置文件 | 恒直连。内置代理的节点和开关本身就来自这份文件,如果拉它也要先有代理,就成了「要先有配置才能拿到配置」 |
| 面板 API、在线客服、检查更新、云端调度等由客户端发起的请求 | 走内置代理 |
| 用户自己的上网流量 | 与内置代理无关,由订阅节点处理 |
因为第一行这一条,OSS 域名必须在用户网络上可达——它不会被代理救回来。
开启之后是「强制走」,不会偷偷退回直连
开启内置代理后,客户端通讯会被强制走内置代理,并且是拒绝直连的策略:
- 内置代理没准备好时,客户端会直接中断请求并报错,而不是悄悄改用直连。
- 这样设计是为了不泄露用户的真实出口 IP,也不暴露你的后端地址。
- 只有用户自己在 App 里把内置代理关掉,通讯才会退回直连。
换线路或改开关都由 OSS 下发、不需要重新打包。
启用内置代理
- 控件:开关
关闭后客户端完全不提供内置代理,用户在 App 里也开不起来。
首次启动默认开启
- 控件:开关
只决定用户首次启动是否默认走内置代理;用户手动调整过之后不再被这里覆盖。用户可以在 App 的「服务状态」弹窗里自行开关与选择线路。
粘贴线路分享链接
- 控件:多行文本
支持的协议:vless、vmess、trojan、ss、ssr、hysteria、hysteria2、tuic。可以一次粘贴多行,也可以粘贴整段 Base64 编码的链接列表;解析导入后客户端会用这些线路组成自动测速组,始终选择延迟最低的一条,列表为空时内置代理不生效。
OSS 在线客服配置(onlineSupport)
客服配置改由 OSS 的 OSS 配置文件 下发,换客服不需要重新打包,编辑器会把这一组写入 onlineSupport。登录页、注册页是否显示客服入口由构建期开关决定,请到「自定义功能 → 显示登录注册页客服入口」配置,客户端不读 OSS 里的该字段。
remoteConfigInput
- 控件:多行文本
编辑器中的内部字段:它是一个默认隐藏、只读的多行文本框(字段 id 即 remoteConfigInput),用于承载编辑器实时生成的 OSS 配置文件 内容,供预览与下载使用,你不需要直接填写。
提示
这个隐藏字段在两个编辑器里挂在不同的分组下:Xboard-Mihomo 编辑器把它放在「静态更新配置(update)」分组中(另见 静态更新配置),NexGen React 编辑器把它放在「OSS 在线客服配置(onlineSupport)」分组中。两个编辑器写入的都是同一份 OSS 配置文件。