SubBoost 订阅聚合实战：多个订阅合并成一份稳定输出

为什么要做订阅聚合

多订阅用户的日常痛点高度一致：

• 客户端里导入三四个订阅，节点列表长得看不过来，同名节点分不清谁是谁
• 想用一个「全部节点」的代理组做兜底，但各订阅的节点散落在不同订阅里，没法组合
• 某个机场跑路了，客户端里删订阅、重新配置，一轮折腾
• 手机和电脑分别维护，配置不同步

订阅聚合解决的就是这些：所有来源（订阅链接、YAML 文件、单条节点链接）统一导入 SubBoost，输出一份聚合订阅，所有客户端只订阅这一份。 以后无论哪个来源变化，你只维护 SubBoost 这一层，客户端无感。

导入三种来源

SubBoost 支持三类输入，覆盖了几乎所有场景：

订阅链接——机场给的 URL，直接粘贴导入，SubBoost 定时拉取更新。

YAML 文件——别人分享的完整 Clash 配置，或者你之前的存量配置，可以整体导入，其中节点被提取进节点池。

节点链接——ss://、vmess:// 之类的单节点分享链接，适合把朋友自建节点、临时节点收进同一个池子。

导入时的实操建议：给每个来源起一个可识别的名字，比如「机场A-年付」「自建-hk」。这个命名会成为后面节点筛选按来源过滤的依据，是聚合体系的地基。

聚合订阅的生成逻辑

导入完成后，SubBoost 把所有来源的节点合并进统一节点池，你在这个池子上做管理动作（重命名、筛选、分组），然后生成聚合订阅输出给客户端。

这个架构的核心好处是关注点分离：

来源层：机场A订阅 / 机场B订阅 / 自建节点
              ↓ 导入（自动刷新保持同步）
管理层：SubBoost 节点池（重命名、筛选、分组、链式、分流）
              ↓ 生成
输出层：一份聚合订阅 URL → 所有客户端

来源层怎么变（机场换节点、加新订阅）都不影响管理层和输出层；你在管理层做的所有策略调整，所有客户端立即生效。

自动刷新：让聚合「活」起来

聚合订阅最怕的事情：机场更新了节点，你的聚合还是旧的，节点全失效。SubBoost 的自动刷新功能解决这个问题——定时拉取各来源的最新内容，智能节点匹配把新旧节点对应起来。

这个「智能节点匹配」值得单独说：朴素的做法是每次刷新全部替换节点，导致你手工改过的名字、调整过的分组每次都被打回原形。智能匹配会识别「同一个节点只是地址/端口变了」的情况，保留你在管理层的加工结果。

配置建议：

• 刷新频率：按官方默认值起步即可，机场订阅内容一天内不会变太多次
• 配合健康检查：CRON_SECRET 保护定时任务触发端点（见部署教程的环境变量清单），确保只有你授权的调度能触发刷新

客户端怎么接

聚合生成后拿到一个订阅 URL，所有支持 Clash/Mihomo 格式的客户端统一使用这一份：

• 桌面：Clash Verge Rev、Mihomo Party 等
• 移动端：Stash、Shadowrocket（Clash 格式）、FlClash 等
• 路由器：OpenClash 等固件插件

实操顺序建议：先在桌面客户端接聚合订阅验证分流正常，再铺到手机和路由器。因为所有客户端用同一份配置，你在 SubBoost 里改一处（比如换分流策略），全家设备同时生效——这是聚合模式的终极便利。

聚合方案避坑清单

聚合跑起来之后，这几个坑都是高频翻车点，提前避开：

1. 来源命名偷懒。「订阅1」「未命名来源」当时省事，两周后想按来源筛选节点时对不上号。导入时命好名，是这个体系里成本最低、回报最高的动作。

2. 聚合订阅 URL 当公开链接分享。聚合订阅里是你全部来源的节点凭证，给出去等于把所有机场账号交出去。这份链接只进你自己的客户端。

3. 删除来源前不确认依赖。来源删了，它贡献的节点会从节点池消失，引用这些节点的筛选组、链式绑定跟着断。先检查有没有按这个来源过滤的代理组。

4. 把 YAML 来源当万能入口。导入完整配置时提取的是节点，原配置里的分流策略和 DNS 设置不会被继承——分流和 DNS 应该在 SubBoost 管理层配，别指望来源配置直接带过来。

5. 只加来源不清理。失效的机场、过期的订阅一直挂在来源列表里，刷新天天报错还占着位置。定期巡检来源健康度，该删就删。

6. 切换聚合时不清旧订阅。从散装订阅切到聚合订阅后，旧订阅还留在客户端里没删——节点重复出现、流量走向混乱，排查问题时全是干扰项。切换完成、验证聚合订阅正常后，把客户端里的旧订阅清掉，只留聚合这一份。

来源健康度巡检表

每月花五分钟，对着这张表过一遍来源层：

检查项	看什么	异常时的动作
拉取状态	各来源最近一次刷新是否成功	失败先查订阅链接是否过期或被重置
节点失效比例	来源内连不上的节点占比	长期大面积失效的来源考虑下架替换
节点规模突变	来源节点数突然暴增或清零	大概率是机场换线路或跑路前兆，去官网看公告
倍率变化	节点倍率标注有没有变	影响选节点策略，重命名标注同步更新
套餐有效期	机场套餐剩余时间	提前决定续费还是换来源，别等节点全失效

从多个订阅到一份「家庭标准配置」

把这套体系跑顺之后，你实际上拥有了「家庭网络的标准配置管理台」：

• 上一套精确分流策略，所有设备共享
• 节点质量差的下架，客户端不用动
• 换机场、加订阅，只是来源层多一条记录
• 配合防 DNS 泄露配置，全家设备的 DNS 行为统一可控

订阅聚合是 SubBoost 使用体系的骨架，骨架立住了，后面的高级功能都是在它上面做加法。