Skip to content

本页覆盖两个客户端编辑器里的三组选项:OSS 配置文件 配置项OSS 内置代理配置(clientProxy)OSS 在线客服配置(onlineSupport)。编辑器会根据这里填写的内容实时生成 OSS 配置文件,下载或加密后下发到 OSS,客户端启动时读取这份文件。

密钥与加密流程见 加密与密钥;静态更新配置(update)见 静态更新配置

OSS 配置文件 配置项

面板类型(panelType)

  • 控件:下拉选择
  • 取值范围sspanel / v2board / xboard

请选择当前站点使用的面板类型:

  • sspanel:SSPanel 系面板
  • v2board:V2Board 系面板;如果是 xiaov2board,请选择 v2board
  • xboard: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 的「服务状态」弹窗里自行开关与选择线路。

粘贴线路分享链接

  • 控件:多行文本

支持的协议:vlessvmesstrojanssssrhysteriahysteria2tuic。可以一次粘贴多行,也可以粘贴整段 Base64 编码的链接列表;解析导入后客户端会用这些线路组成自动测速组,始终选择延迟最低的一条,列表为空时内置代理不生效。

OSS 在线客服配置(onlineSupport)

客服配置改由 OSS 的 OSS 配置文件 下发,换客服不需要重新打包,编辑器会把这一组写入 onlineSupport。登录页、注册页是否显示客服入口由构建期开关决定,请到「自定义功能 → 显示登录注册页客服入口」配置,客户端不读 OSS 里的该字段。

remoteConfigInput

  • 控件:多行文本

编辑器中的内部字段:它是一个默认隐藏、只读的多行文本框(字段 id 即 remoteConfigInput),用于承载编辑器实时生成的 OSS 配置文件 内容,供预览与下载使用,你不需要直接填写。

提示

这个隐藏字段在两个编辑器里挂在不同的分组下:Xboard-Mihomo 编辑器把它放在「静态更新配置(update)」分组中(另见 静态更新配置),NexGen React 编辑器把它放在「OSS 在线客服配置(onlineSupport)」分组中。两个编辑器写入的都是同一份 OSS 配置文件

相关页面

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