sing-box 的配置能力持续演进。对已经运行的实例，升级不是只替换一个可执行文件：配置中的旧字段、旧规则资源与平台行为变化同样需要评估。
当前稳定版本
稳定发布为 v1.13.12，GitHub 标注发布日期为 2026-05-15。
日常安装和升级通常优先选择正式稳定版。测试版本更适合需要提前验证新功能、并能承担兼容性变化的用户。
升级前要做的三件事
- 对照弃用列表检索当前配置涉及的字段或功能，并记下移除版本。
- 按迁移说明查找对应替换方式，逐项修改备份配置。
- 按检查与格式化配置执行校验，再在受控环境验证路由和日志。
常见的旧配置问题
官方弃用文档明确记录 GeoIP 与 Geosite 在 1.12.0 已移除，因此新配置不应继续依赖这两类旧资源。配置从更早版本迁移到当前稳定通道时，这类问题不是警告，而可能直接导致无法继续使用旧写法。