目标查询:sing-box 启动失败 remote rule-set 下载失败。资料核验:2026-11-04 北京时间。本文分析 route.rule_set 中 type: remote 的启动阶段,不处理客户端订阅 URL、Mihomo YAML 规则集或节点连接失败。没有在读者设备上复现具体报错,以下是基于官方字段说明和公开问题记录的可恢复排查路径。
先看结论
当日志把失败指向某个远程规则集 tag,先备份配置和可用缓存,记录实际 sing-box 版本,再查规则文件能否从当前下载路径取到。首次启动没有缓存,与已有缓存后的定期更新失败,处理方式不同。不要为了让内核启动就删掉整段路由规则、关闭证书校验或随意清空缓存;这样可能改变流量去向。
判断表:失败发生在哪一步
| 观察 | 优先核对 | 暂时不能下的结论 |
|---|---|---|
首次启动、没有缓存,日志指向 remote 规则集 |
url、下载使用的 HTTP client 或出站、网络可达性;1.14.0 及以上可评估 initial_path |
不能直接说代理节点失效 |
| 规则地址返回 403、404、重定向或 HTML | 文件提供方的当前地址、访问限制、实际响应内容 | HTTP 200 也不保证内容是规则文件 |
| 文件取到后仍报格式或版本错误 | format、实际文件内容、生成该文件的版本 |
改文件名不等于转换格式 |
| 以前能启动、最近更新失败 | 是否仍有缓存、上一次成功时间、默认 update_interval |
缓存可用不证明本轮更新成功 |
| 规则文件更新了但分流不变 | 路由或 DNS 规则是否引用对应 tag、新连接是否命中 |
文件时间变化不等于规则生效 |
按顺序恢复
- 先保留可回退的状态。复制当前 JSON 配置、规则文件和日志的脱敏摘要。不要公开订阅令牌、节点凭证、完整配置或含查询参数的私人 URL。若这是工作设备,先按组织网络规则处理。
- 确认版本和故障阶段。执行
sing-box version,在实际启动日志中找到失败的规则集tag。官方配置文档提供sing-box check检查命令;校验通过只说明静态配置符合检查条件,不证明远程下载成功。 - 确认对象是远程规则集。官方定义
inline、local、remote;只有remote使用url。本地文件应看path,普通订阅更新应转到本站订阅更新失败排查。先区分对象,避免改错 URL。 - 检查请求结果和文件内容。在相同网络与下载路径下查看规则地址的 HTTP 状态、最终跳转和文件头。公开文件可在隔离环境核对;私人地址不要提交给在线检测器。若得到登录页、验证码或错误页,先处理来源访问条件,再看解析器。
- 检查格式和版本。官方
format分为source和binary。请对照实际文件内容及所安装内核版本的文档,勿把改文件名当作格式转换;再看官方迁移指南。 - 排除下载路径的循环依赖。如果远程规则集必须经过某个出站下载,而该出站或路由又依赖这份尚未加载的规则集,先在安全的测试配置里验证下载路径。1.14.0 起官方提供
http_client和initial_path;initial_path用于无缓存时的初始内容,必须是已核对且与目标规则相符的文件。旧版download_detour从 1.14.0 起弃用,不能不看版本就机械替换字段。 - 恢复并验收。每次只改一个因素,重启后分别确认:配置检查、远程文件请求、解析成功、目标连接实际路由。失败就恢复备份;不要只以“程序能启动”作为完成标准。
官方文档说明:启用 experimental.cache_file.enabled 时远程规则集会缓存;update_interval 留空默认 1d。因此几分钟内没再次请求不必立刻当作异常。公开 Issue #4073 讨论了冷启动时远程规则不可获取造成的启动失败,但该提案已关闭且未计划实现;它只能证明有人报告这种场景,不能当作官方保证的修复方案。
适用范围与限制
这套检查针对 sing-box 核心的远程规则集。图形客户端可能使用不同的配置目录、缓存位置或内核版本,应以其界面实际显示为准。本文没有为任何特定系统、运营商或规则仓库做连通性实测,也不能保证某个 initial_path 或 HTTP client 一定解决读者的具体报错。若故障在普通节点、系统代理或 TUN,请回到问题排查;需要理解不同客户端配置边界,可先看客户端比较。
常见问题
规则集 URL 在浏览器能打开,为什么仍启动失败?
浏览器和内核可能使用不同的网络路径;返回内容也可能是 HTML、登录页或不匹配的文件格式。核对客户端日志中的实际请求和解析结果。
删掉缓存再试可以吗?
先备份。缓存可能是当前唯一能用的规则内容;删除会把定期更新问题变成无初始内容的冷启动问题。
download_detour 改成 http_client 就能好吗?
不能保证。先确认内核版本,按对应文档配置 HTTP client 并验证它的网络路径。download_detour 在 1.14.0 弃用,1.16.0 移除。
initial_path 是什么?
官方说明它从 1.14.0 起用于启动时没有可用缓存的初始规则内容。它是已核对文件的本地路径,不是自动修复远程地址的开关。
文件更新成功,为什么分流仍旧?
检查对应 tag 是否被路由或 DNS 规则引用,并用新建连接观察实际出站。下载成功、解析成功和规则命中是三个不同阶段。
来源
- sing-box 官方规则集字段说明,核验 2026-11-04。
- sing-box 官方配置与检查命令,核验 2026-11-04。
- sing-box 官方迁移指南,核验 2026-11-04。
- SagerNet/sing-box Issue #4073,仅作公开故障场景,状态为已关闭、不计划实现;核验 2026-11-04。
同行结构参考:NekoBox 中文指南的规则集更新失败文章;本站文章聚焦冷启动时的可恢复诊断与版本边界。