对于配置驱动的核心程序，版本发布信息必须和配置兼容性一起维护。一个新版本可能修复运行问题，也可能使旧字段进入弃用或移除阶段。
当前稳定版
当前稳定版本如下：
| 通道 | 版本 | 发布日期 | 使用建议 |
|---|---|---|---|
| 稳定版 | v1.13.12 | 2026-05-15 | 新安装与常规维护优先评估 |
测试版本可能包含尚未稳定的行为变化。版本在发布后可能继续变化，安装前不要只依靠旧截图或转载内容。
升级流程
- 记录正在运行的二进制版本、配置文件和外部 rule-set 来源。
- 阅读目标版本的发布说明与 Change Log。
- 对照弃用列表搜索现有配置使用的功能。
- 按迁移说明完成相应替换。
- 运行
sing-box check，随后在受控环境启动并检查 DNS、路由与日志。 - 保留可回滚的旧二进制与配置，直到运行结果满足预期。
旧配置为什么需要单独检查
GeoIP、Geosite 等内容在旧教程里很常见，但文档说明它们已于 1.12.0 移除。类似变化意味着“曾经可用”的配置无法作为当前稳定版的可靠起点，也不应把带有潜在过期字段的整套模板当作所有场景通用的起点。
继续操作前，可按迁移已弃用配置的检查流程逐项处理现有配置。