迁移 sing-box 配置时,最容易出错的是把客户端状态、订阅地址和配置文件当成同一份数据。按层备份可以保留回退路径。
先认清项目边界
sing-box 官方仓库维护的是代理核心与配置文档。图形客户端可能有自己的导入字段和存储位置,不能仅凭核心版本推断客户端一定兼容。
迁移前做三份记录
分别保存原配置文件、订阅地址和当前使用的策略名称;同时记录旧设备的核心版本与系统权限。不要把包含隐私的订阅内容上传到公开仓库或聊天中。
在新设备逐层导入
先导入不含多余规则的最小配置,确认 JSON/YAML 结构和传输字段能被当前客户端解析,再恢复规则、DNS 和路由项。格式异常时参考本站的 配置格式检查逐段缩小问题范围。
只做一个固定测试
完成 VPN 授权后,先用固定 HTTPS 目标和一个已知策略组测试。成功后再恢复其他规则;如果启动失败,回退到最小配置并比较差异,不要直接覆盖旧备份。
来源与边界
本文依据 sing-box 官方仓库的配置说明整理,不承诺跨客户端或跨版本无条件兼容。