怎么用这页

这一页只回答「这个字段怎么填、取值是什么、默认值多少」。哪项功能在哪个客户端、哪套 UI 生效，统一看自定义功能的支持矩阵，本页不复述；其中「编辑器里有开关但客户端不生效」的几处，也在那一页的「必须知道的坑」里。

下表里的项名就是编辑器界面上的中文标题，按标题对照即可。

这些项都收在老客户端的编辑器「自定义功能配置」面板里，需要先用对接码验证通过才会显示。

本页只收录仍需对接码解锁的字段。一批原本也收在自定义面板、但普通区已经有同款控件的开关（各界面隐藏开关、云端调度），已并入配置项手册，本页不再重复列出。

配色

这一组配色项只有老客户端支持，而且其中只有「登录按钮颜色」「套餐筛选按钮颜色」在老客户端的新 UI 也生效，其余各项只作用于旧 UI；完整支持情况见总览页的矩阵。

编辑器里每一项由一个取色器加一个「颜色值」文本框组成；下表「取值或默认值」给出的是客户端自带的默认色，留空即沿用该默认色。

说明	取值或默认值
流量条自定义：客户端流量进度条的颜色	#00897B
公告弹窗图标背景自定义：公告弹窗里图标底部的背景色	#00897B
官网按钮图标自定义：订阅页官网图标的颜色	#00897B
刷新按钮图标自定义：订阅页刷新图标的颜色	#00897B
公告按钮图标自定义：订阅页公告图标的颜色	#00897B
登录按钮颜色自定义：登录按钮的颜色	#374151
套餐订阅按钮颜色自定义：套餐列表「订阅」按钮的颜色	#00897B
套餐筛选按钮颜色自定义：套餐列表上方筛选标签的颜色	#00897B
邀请码文本颜色自定义：邀请码文字的颜色（背景偏深时可与下一项一起调）	#00897B
邀请码卡片背景颜色自定义：邀请码卡片的底色	#4DB6AC
可用佣金卡片背景颜色自定义：「可用佣金」卡片的底色	#4DB6AC
邀请统计总邀请图标颜色自定义：邀请统计里「总邀请」的图标颜色	#00897B
邀请统计返佣比例图标颜色自定义：邀请统计里「返佣比例」的图标颜色	#00897B
邀请统计总佣金图标颜色自定义：邀请统计里「总佣金」的图标颜色	#00897B

颜色类字段的填写规则

• 两个控件，改哪个都行：取色器和「颜色值」文本框双向同步，改任意一个效果相同；旁边还有一个「清空」按钮。
• 留空即沿用默认：把「颜色值」清空（或点「清空」），表示继续使用客户端自带的默认色，不会把颜色改坏。
• 两种写法：六位的 #RRGGBB，或带透明度的八位 #AARRGGBB（前两位是透明度）。保存时会自动转成大写、缺 # 会自动补上；格式不合规会直接报错并拒绝保存。
• 重新打包才生效：颜色随档案写入配置，要重新打包并分发新产物才会体现，见软件打包。

流量条这一组要配套开关才生效

「流量条自定义」在档案里的真实路径是 subscription_usage.traffic_bar_color，并且必须同时打开 subscription_usage.traffic_bar_color_enabled 才会生效——只填颜色、配套开关没开，流量条不会变色。

配套开关打开后，流量条会固定使用你设的颜色，不再按用量比例自动变色；关掉它则恢复按比例变色，留空同样表示沿用默认色。它的键名写法与其余配色项不同，是历史命名的遗留，不影响你填写。

订阅页图标那几个字段别填错

「官网按钮图标」「刷新按钮图标」「公告按钮图标」这三项的界面说明文字完全相同（都是「留空则继续使用默认图标颜色」），只能靠标题区分。填错不会报错，只会让另一个图标的颜色变掉——对照上面的界面标题逐字确认一下再保存。

界面显示与入口

这一组都是开关，控制客户端上某个界面元素或行为是否出现。下面四项分属不同主题、互相独立。

这一组受「打包分支」影响

• sspanel-uim 分支缺：「隐藏购买页优惠码」在这个分支的新客户端上没有实现。
• SSPanel 节点页面解析只有 sspanel-metron 分支的老客户端读它，且默认开启；新客户端不读这个开关。

完整差异见总览页的分支说明，以及「必须知道的坑」。

说明	取值或默认值
登录窗口套餐状态拦截：开启后，无套餐、已到期或流量用尽的用户登录时会看到弹窗提示；关闭则不提示	开启 / 关闭；默认关闭
节点弹窗仅显示主策略节点：选择节点弹窗直接显示主策略组节点，不再先显示其他分流组	开启 / 关闭
隐藏购买页优惠码：购买套餐页默认隐藏优惠码使用区域及输入框	开启 / 关闭
SSPanel 节点页面解析：节点列表改从 SSPanel 的节点页面解析。老客户端只有 sspanel-metron 分支读它（且默认开启）；新客户端不读它，行为固定为 API 优先、失败自动回退	开启 / 关闭

邀请与注册

先看这一组是用来做什么的

核心用途：给不同的推广者（aff）各打一份专属客户端，把各自的身份烧进去。

典型玩法是这样的：

1. 你找到一个有推广能力的推广者，谈好返佣比例；
2. 为他单独打包一份客户端，把他的邀请码预置进这份客户端——就是下面这两项做的事；
3. 他把这份客户端发给他的用户；
4. 用这份客户端注册的用户，就都算他推广来的，他拿对应的返佣。

关键在于客户端是按档案分别打包的：你可以给每个推广者打一份带他自己邀请码的客户端，多个推广者互不干扰。

如果所有用户都用同一个客户端

那就用不上这一组，保持关闭即可——用户注册时自己填邀请码就行。这一组只在你要按推广者分发不同客户端时才有意义。

注册邀请绑定

它做的事：把邀请码预置进这份客户端，用户注册时自动带上，不用他自己填。

界面标签	说明	取值或默认值
注册邀请绑定	总开关。关闭时，下面两个字段填了也不生效	开启 / 关闭
绑定模式	决定什么时候用预置的邀请码	见下方两种模式；默认「用户未填时使用默认邀请码」
邀请码	这个推广者的邀请码	文本，占位提示 填写默认注册邀请码；开启总开关时必填

两种绑定模式（下拉框里就是这两项）：

• 用户未填时使用默认邀请码（default_when_empty）：用户自己填了就用他自己的，没填才用你预置的。默认值。 适合「推广者带来的人如果自己有邀请码，就尊重他自己的归属」。
• 强制使用默认邀请码（force_override）：不管用户填了什么，一律替换成预置的。 适合「这份客户端发出的注册必须归这个推广者，不接受其他归属」。

保存校验

开启总开关后必须填「邀请码」，否则会拒绝保存并提示「开启注册邀请绑定时，请填写邀请码」。

自定义邀请链接

它解决什么：默认情况下，邀请页只显示邀请码，不显示完整的注册链接。

原因是完整的注册链接里带着你的后端（面板）地址，公开出去等于把这个地址暴露给别人。所以默认干脆不生成、也不显示。

这一项就是用来解决这个矛盾的：开启后，客户端改用你自己指定的另一个地址去拼完整链接——

你填的基础地址 + /#/register?code=邀请码

链接指向的是你的对外地址、不是后端地址，所以可以放心地在邀请页上展示，让用户直接复制或扫码。

界面标签	说明	取值或默认值
自定义邀请链接	总开关。关闭时邀请页上那一整块完整链接都不显示，只留邀请码	开启 / 关闭
邀请链接地址	只填基础地址即可，不用自己拼路径——客户端会自动在后面接上 /#/register?code=邀请码	网址，示例 https://example.com；开启总开关时必填，需以 http:// 或 https:// 开头

保存校验

开启总开关后，地址必须以 http:// 或 https:// 开头，否则会拒绝保存并提示「开启自定义邀请链接时，请填写 http:// 或 https:// 开头的邀请链接地址」。

支持情况

• 注册邀请绑定：老客户端只有旧 UI 会读它（旧 UI 注册页自动带上邀请码）；新客户端两套 UI 都生效。
• 自定义邀请链接：两个客户端都生效；新客户端的 sspanel-uim 分支没有实现。

相关页面

• 有哪些功能、在哪个客户端和哪套 UI 生效 → 自定义功能
• 常规配置项手册导航 → 配置项手册
• 界面行为与各类隐藏项 → 界面行为、布局与隐藏项
• 云端调度（已并入常规配置项） → 云端调度
• 功能入口相关配置 → 功能入口
• 订阅、面板 API 与 SSPanel → 订阅、面板 API 与 SSPanel
• 按配置键快速定位全部选项 → 全部选项速查
• 配好之后怎么打包 → 软件打包