sing-box 配置升级:按迁移说明修改,不靠删除报错字段
建立 sing-box 升级前后的配置对照,核对字段废弃与替代关系,分开验证 DNS、路由和接管,并保留能够恢复的版本与私人备份。
本页目录 · 5 个章节
配置能读取不代表行为未变化
核心升级可能调整字段、默认值和处理方式。旧配置在新版本报错是明显信号,但没有报错也不等于行为完全不变。升级前要知道自己依赖哪些 DNS、路由和入站功能,才能做有针对性的检查。
先记录图形应用与核心版本,再保存当前配置和必要说明。不要只保存节点列表,因为路由和 DNS 可能正是影响结果的部分。备份可能包含账号、密钥和订阅地址,应仅放在可信的私人位置。
根据版本跨度阅读迁移说明
sing-box 官方迁移页按版本列出变化。应从当前使用版本到目标版本之间逐项查看,不能只读最后一段。历史迁移内容包括 DNS 服务器格式、规则动作及 TUN 地址等,说明配置确实会随版本演进。
不要把某个字段出现在新文档中,等同于旧版本已经支持它。反过来,旧文章里的字段也可能已不适用于目标版本。教程或示例必须有版本范围,不能只标一个长期不变的“通用配置”。
一类功能一次修改
先处理结构和明确的替代字段,完成配置校验后,再验证 DNS、路由和接管。每次改动写下旧字段、新字段及预期行为,避免一次性替换大量内容后无法确认影响。
例如迁移某类路由动作时,应检查对应目标最终去了哪个出站,而不只是确认文件能够保存。涉及 DNS 时,还要验证使用域名的请求;仅用一个固定 IP 测试,可能遗漏解析流程的问题。
用原任务做前后对照
保持相同网络、配置来源和目标,分别检查日常外部任务与必要的局域网访问。确认规则是否仍按原目的工作,是否出现新的 DNS 或接口错误。测试记录应描述实际观察,而不是笼统写“全部正常”。
如果只有某一类目标出问题,回到对应的迁移项分析。不要为掩盖差异,把所有流量统一改成一个出站,也不要忽略日志警告直到它们变成下次升级的错误。短期可用与配置正确是两项判断。
恢复需要匹配备份与程序
出现不可接受的问题时,保存新状态后按项目说明恢复。旧核心未必能读取已迁移配置,因此程序与备份要配套。图形应用若自行管理配置生成,还应确认手工改动会不会在下次保存或订阅更新时被重新生成的内容覆盖。不要让两个版本同时操作同一个数据目录,以免互相覆盖。
恢复后检查系统代理、虚拟接口和路由是否回到预期状态。最后整理变更记录,保留能够解释问题的脱敏日志。下一次尝试升级时,就可以从已确认的差异继续,而不是重复下载和猜测。
了解订阅服务
结合账户条款与自己的使用需求判断。