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