模板

模板决定客户端通过订阅链接具体会收到什么。面板 能够下发多种格式，每种格式都有自己的模板。

模板类型

类型	格式	适用对象
XRAY_JSON	JSON	基于 Xray-core 的客户端（Happ、INCY 等）
XRAY_BASE64	base64 字符串	适用于大多数客户端的通用格式
MIHOMO	YAML	Mihomo / Clash Meta
CLASH	YAML	Legacy Clash
STASH	YAML	Stash
SINGBOX	JSON	Sing-box

每种类型都有一个名为 Default 的模板。它不能重命名 或删除——当用户的模板损坏时，它是回退点。

Xray 配置

XRAY_JSON 类型的模板是客户端配置的骨架。主机可以引用 自己的 Xray JSON 模板（xrayJsonTemplateUuid），而其他 主机使用默认模板。路由规则可以强制 代入自己的模板并忽略主机的 ignoreHostXrayJsonTemplate 标志。

{
  "log": { "loglevel": "warning" },
  "outbounds": [
    { "protocol": "vless", "tag": "proxy" }
  ]
}

订阅与客户端配置模板

MIHOMO、CLASH 和 STASH 模板是带有必需标记的 YAML，面板 会把代理和组插入这些标记处：

proxies: # LEAVE THIS LINE!
proxy-groups:
  - name: '→ XLADA'
    type: 'select'
    proxies: # LEAVE THIS LINE!
rules:
  - MATCH,→ XLADA

# LEAVE THIS LINE! 标记不能删除。SINGBOX 和 XRAY_JSON 以 JSON 保存，而 XRAY_BASE64 是同样的 Xray 配置经过 base64 编码后的结果。

替换变量

订阅中的用户文本由 {{KEY}} 形式的变量组装而成。 它们可用于主机备注（remark）、customRemarks 和 自定义响应头中：

剩余 {{TRAFFIC_LEFT}}，共 {{TOTAL_TRAFFIC}}，天数：{{DAYS_LEFT}}
订阅：{{SUBSCRIPTION_URL}}
重置：{{NEXT_TRAFFIC_RESET_AT:format=DD.MM.YYYY}}

变量	值
USERNAME、EMAIL、TELEGRAM_ID、TAG、DESCRIPTION	用户数据
STATUS	状态（ACTIVE、LIMITED……）
TRAFFIC_USED、TRAFFIC_LEFT、TOTAL_TRAFFIC	可读形式的流量
TRAFFIC_USED_BYTES、TRAFFIC_LEFT_BYTES、TOTAL_TRAFFIC_BYTES、LIFETIME_USED_BYTES	以字节表示的流量
DAYS_LEFT、EXPIRE_UNIX	有效期
SUBSCRIPTION_URL、SHORT_UUID、ID	链接和标识符
RESET_STRATEGY	流量重置周期
CREATED_AT_UNIX、LAST_TRAFFIC_RESET_AT、NEXT_TRAFFIC_RESET_AT	日期
SS_HWID_LIMIT	设备限制

STATUS、RESET_STRATEGY、LAST_TRAFFIC_RESET_AT 和 NEXT_TRAFFIC_RESET_AT 带有参数——例如 {{STATUS:ACTIVE=一切正常}} 或 {{NEXT_TRAFFIC_RESET_AT:format=DD.MM.YYYY}}。值开头的 rwEncodeBase64: 前缀会把结果编码为 base64。

提示

请求头和 customRemarks 中的变量可以让你在订阅名称里直接 显示剩余流量，而无需打开面板。这在订阅设置 一节中配置。

注意

未知键会原样保留在文本中。在把模板推给所有人之前， 请在客户端中检查结果。

接下来

• 路由规则 —— 向客户端下发哪个模板。
• 主机 —— 把 Xray JSON 模板绑定到主机。
• Mihomo 模板 —— 现成的示例。
• 客户端 —— 哪些应用支持什么。