升级 sing-box 时最容易被忽略的问题，是配置文件与二进制并不总能独立升级。下面是一条不依赖特定订阅或服务端参数的检查流程。
1. 固定升级前快照
记录正在运行的版本、安装来源、配置文件和外部规则资源。复制一份可以回退的配置；若服务对可用性敏感，还应保留旧二进制或包版本的回退路径。
2. 查看目标版本通道
sing-box 当前稳定版为 v1.13.12。先选稳定目标版本，再针对目标版本检查兼容性；测试版本需要单独评估变更风险。
3. 在弃用列表里检索旧能力
打开官方弃用页面，用配置中的关键字段与能力名搜索。一个重要例子是：
- GeoIP 与 Geosite 在
1.8.0被标注为弃用，并在1.12.0被移除。
这意味着仍依赖这些资源的旧配置，面对当前稳定系列时不能只忽略告警，而需要按照迁移指南处理。
官方页面还记录不同版本中的 DNS、出站、TUN 等变化。只迁移你实际使用的部分，避免借升级之机不必要地改写整个配置。
4. 依据 Migration 逐项替换
对每个命中的弃用项：
- 找到官方 Migration 中对应条目。
- 在配置副本上完成一项替换。
- 记录替换原因与官方链接。
- 继续下一项，避免在发生错误时无法定位变化来源。
迁移片段会随发布变化，实际需要也取决于你的配置，因此应按目标版本文档逐项处理。
5. 校验并观察运行行为
完成替换后运行：
sing-box check若检查通过，再在受控环境重启服务并查看日志。对 DNS 或路由相关修改，还需要验证实际行为，而不仅是配置语法。
6. 更新维护记录
记录新版本、迁移日期、改动过的字段、验证结果与回滚文件。之后每次稳定版本变化，都从这份记录继续核查，而不是重新猜测旧配置来源。