Skip to content

subscription-share.zh-CN.md

Latest commit

 

History

History
140 lines (103 loc) · 8.93 KB

subscription-share.zh-CN.md

File metadata and controls

140 lines (103 loc) · 8.93 KB
Raw

English | 简体中文

订阅分享管理

全新的订阅分享管理功能，取代了原有的单一 Token 模式，提供更安全、更灵活的分享链接管理能力。

核心特点

特点 说明
多链接管理 每个订阅可创建多个独立的分享链接，方便分发给不同用户或场景
安全 Token 采用随机生成的安全 Token，也支持自定义 Token 便于记忆
过期策略 支持永不过期、按天数过期、指定时间过期三种策略
独立统计 每个分享链接独立记录访问次数和 IP 日志
启用/禁用 可随时启用或禁用单个分享链接，无需删除
Token 刷新 一键刷新 Token，旧链接立即失效，安全便捷
二维码生成 支持为每个分享链接生成二维码，方便移动端扫码导入

⏰ 过期策略

策略 说明
永不过期 链接长期有效，除非手动禁用或删除
按天数过期 从创建时起指定天数后自动失效，如 7 天、30 天
指定时间过期 设置具体的过期日期和时间，到期后自动失效

📋 使用场景

场景一：分用户管理
├── 为朋友 A 创建分享链接（永不过期）
├── 为朋友 B 创建分享链接（30天后过期）
└── 各自链接独立统计，互不影响

场景二：安全分享
├── 创建临时分享链接（24小时或指定时间过期）
├── 使用完毕后可立即禁用
└── 若链接泄露，可刷新Token使旧链接失效

场景三：访问追踪
├── 不同分享链接对应不同来源
├── 通过访问日志了解各链接的使用情况
└── IP 地理位置自动识别，了解用户分布

升级说明

Tip

默认分享：系统升级后会自动为每个订阅创建一个「默认」分享链接，保持原有链接可用，确保平滑升级。

Note

客户端兼容：分享链接支持自动识别客户端类型，也可手动指定 Clash、Surge、V2ray 等客户端格式。

扩展客户端格式

  • 原生输出仍通过 /c?client=clash、/c?client=mihomo、/c?client=surge、/c?client=v2ray 提供。
  • 在 用户中心 -> Sub-Store 启用 sidecar 并选择目标后，分享链接还可以请求已选中的扩展目标：loon、egern、stash、surfboard、shadowrocket、quanx、sing-box、uri、json。
  • 扩展输出使用 SublinkPro 的 mihomo/Clash YAML 作为桥接格式，并调用外部 Sub-Store sidecar。sidecar parser 只转换代理节点，不保留策略组、规则、DNS 等完整 Clash 配置段。
  • 如果请求扩展客户端时未配置 sidecar，或目标未在用户中心选中，请求会返回明确错误，不会静默回退到 V2ray。

订阅更新间隔

  • 在订阅管理的「订阅设置」->「基础设置」中，可为每个订阅配置「更新间隔（小时）」。
  • 该值按小时保存，最大为 8760 小时；设置为 0 或不填写时使用默认更新间隔：Clash 为 24 小时，Surge 为 86400 秒。
  • 当客户端通过订阅链接获取 Clash 配置时，响应头会带上 profile-update-interval，单位为小时。
  • 当客户端获取 Surge 配置时，#!MANAGED-CONFIG 中的 interval 会按设置自动换算为秒。

节点选择来源

  • 手动选择节点会保存具体节点 ID，订阅输出会保留这些指定节点，直到再次编辑订阅。
  • 动态选择分组会保存分组名称，每次生成订阅时解析这些分组下的当前节点。
  • 动态选择机场会保存机场 ID，每次生成订阅时解析这些机场当前导入的节点。
  • 混合模式可以同时组合手动节点、动态分组和动态机场。输出顺序遵循已配置的排序，同名有效节点只保留最先出现的一份。

节点命名变量

NodeNameRule 控制订阅输出时的节点名称。留空时，SublinkPro 会保留节点的实际使用名称。变量会在生成订阅时替换，因此速度、延迟、国家、标签、解锁状态等值都来自系统当前保存的节点数据。

常用变量：

变量 含义
$Name 节点实际使用名称，取决于节点的名称模式
$LinkName 上游原始节点名称
$LinkCountry 节点国家代码，例如 HK、US；国家为空时显示 未知
$LinkCountryName 根据 $LinkCountry 到「应用设置 -> 国家规则」中查找得到的国家名称；没有对应国家规则名称时回退为国家代码
$Flag 根据国家代码生成的国旗 Emoji
$Group 节点分组；分组为空时显示 未分组
$Source 节点来源；手动节点显示为 手动
$Protocol 协议类型
$Index 输出序号
$DuplicateIndex 重名序号；第一次出现为空，后续依次为 1、2、3 等
$Tags 节点所有标签，使用 `
$TagGroup(name) 节点在指定标签组中的标签，存在时才输出
$Speed、$SpeedIcon 下载速度文本和速度状态图标
$Delay、$DelayIcon 延迟文本和延迟状态图标
$IpType、$Residential IP 质量标签，例如原生/广播、住宅/机房
$FraudScore、$FraudScoreIcon 欺诈评分和欺诈评分图标
$Unlock 解锁摘要
$Unlock(provider) 指定服务商的解锁结果，例如 $Unlock(netflix)
$UnlockStatus、$UnlockLabel、$UnlockRegion 可用时输出更细的解锁状态字段

国家名称逻辑依赖节点已经保存的国家代码。例如节点的 $LinkCountry = HK，并且 HK 国家规则的国家名称是 香港，那么 $LinkCountryName 会输出 香港；如果这个国家代码没有对应国家规则，则 $LinkCountryName 会输出 HK。如果希望调整命名规则中的国家名称，请修改「应用设置 -> 国家规则」里的国家名称。

示例规则：

[$Flag] $LinkCountryName - $LinkName $DuplicateIndex

对于名为 Premium 01 的香港节点，输出可能是 [🇭🇰] 香港 - Premium 01。如果后续节点生成了同名结果，$DuplicateIndex 可以为后续重名节点追加序号。

Mieru 输出说明

  • Mieru 当前仅支持 Clash/mihomo 输出；/c?client=clash 会按 mihomo YAML 字段输出 type: mieru、server、port 或 port-range、transport、username、password，并保留可选的 multiplexing、traffic-pattern 与链式代理 dialer-proxy。
  • Mieru 官方存在 mieru:// / mierus:// 分享链接，但官方文档未定义适合逐字段编辑的通用 URL schema。SublinkPro 内部使用 mieru://username:password@server:port?...#name 作为原始编辑和 Clash/mihomo 导入回写格式；需要端口范围时使用 portRange=2090-2099，不写 port。
  • /c?client=v2ray 与 Surge 当前不支持 Mieru；SublinkPro 会跳过 Mieru 节点，不会把 mieru:// 链接写入 v2ray base64，也不会生成 Surge 配置。

Snell 输出说明

  • Snell 支持 Clash/mihomo 与 Surge 输出。/c?client=clash 会按 mihomo YAML 字段输出 type: snell、server、port、psk，并保留可选的 version、udp 与 obfs-opts（mode / host）、通用连接层选项（tfo、mptcp、interface-name、routing-mark、ip-version）以及链式代理 dialer-proxy；/c?client=surge 会输出 snell, server, port, psk=...，并按需追加 version、obfs、obfs-host、tfo 与 udp-relay（mptcp、interface-name、routing-mark、ip-version 为 mihomo 专属，Surge 无对应字段不输出）。
  • Snell 官方没有定义通用的分享链接方案，mihomo 以 Clash YAML 字段描述 Snell。SublinkPro 内部使用 snell://server:port?psk=...&version=...&obfs=...&obfs-host=...#name 作为原始编辑和 Clash/mihomo、Surge 导入回写格式；version 默认为 mihomo 的 Snell v1，取值范围为 1/2/3。
  • /c?client=v2ray 当前不支持 Snell；SublinkPro 会跳过 Snell 节点，不会把 snell:// 链接写入 v2ray base64。

VLESS XHTTP 输出说明

  • 当订阅中的节点为 VLESS 且传输层为 xhttp 时，/c?client=clash 会输出 network: xhttp 与 xhttp-opts。
  • 如果 VLESS URL 带有 encryption，/c?client=clash 会保留为 mihomo 顶层 encryption 字段。
  • /c?client=v2ray 会继续输出 VLESS URL，并保留 type=xhttp、path、host、mode 与 extra。
  • 当顶层 VLESS ech 为 Xray 的 DNS / URI 风格时，/c?client=clash 会按 mihomo 可表达的范围输出顶层 ech-opts，其中可识别的查询域名会映射到 query-server-name。
  • 反过来，当节点来源于 Clash/mihomo YAML 导入且只有 ech-opts.query-server-name 可恢复时，系统会在保存节点链接前按本地兼容规则补成 ech=<query-server-name>+https://dns.alidns.com/dns-query。
  • 为避免生成表面可用但实际失真的配置，系统不会把 xhttp 静默转换成 http、h2 或 grpc。