适用范围与准备
适用于 sing-box 加载规则集时报格式或版本错误,手中有 JSON 源文件或 .srs 二进制文件的用户。规则集不是节点订阅,也不是可直接运行的完整配置;示例只演示本地格式核对,不启动代理或下载未知规则。
先区分原因
rule-set 的 format 有 source 和 binary,两者编码不同;把扩展名从.json改成.srs不会完成编译。源规则集含 version 与 rules,版本对应内核支持范围;即使下载成功,也可能拿到不适用的格式或规则版本。
按顺序操作
- 记录实际内核版本及报错中指向的文件,先备份原可用配置和规则集。在新的空目录检查候选文件;URL返回登录页、HTML错误页时先修复获取方式,不把它重命名成规则文件。
- 对照文件格式与配置引用:JSON源格式用source,SRS二进制用binary。官方允许在路径/URL有.json或.srs扩展名时推断格式,但排障时明确写出format更便于核对,扩展名本身仍不是内容证明。
- 核对源文件version与内核版本。官方列出的对应起点为:规则集1对应sing-box 1.8.0,2对应1.10.0,3对应1.11.0,4对应1.13.0,5对应1.14.0;使用新增字段还要符合该字段要求,不只改version数字。
- 确需把可信JSON源格式编译成SRS时,使用同一目标环境的sing-box rule-set compile,明确指定一个新的输出文件。下面是示例命令,输入文件必须是真正的源规则集;不要把已有SRS再次当JSON编译。
- 在配置副本中核对type、tag、format和path/url,使用相同内核的配置检查及实际加载记录验证。规则集成功载入后,还要确认路由或DNS规则确实引用它,不能只凭新文件存在就认为分流生效。
sing-box version
sing-box rule-set compile --output rules-test.srs rules-source.json{
"type": "local",
"tag": "rules-test",
"format": "binary",
"path": "/absolute/path/rules-test.srs"
}怎样确认有效
同一内核能读取候选规则集,实际加载无格式或版本错误,且一次明确测试请求命中预期规则和出口。编译成功只证明该次源文件可编译,不等于引用链和网络路径正确。
无效时恢复与下一步
将配置副本中的引用恢复为原可用文件,保留原规则集,只删除自己生成的测试输出。仍失败时提交内核版本、format、规则集version及脱敏错误,不发送完整订阅或私有域名列表。