2026-10-04 来源核验：本文依据官方资料独立整理，未执行客户端 GUI、真实节点或设备实测。文中的验收步骤是操作建议。
两个版本号要分开记录
v2rayN 7.25.4 正式发行记录说明支持 sing-box 1.14，并限制最大版本到 1.14。PR #10091 将该范围描述为 1.14.x。客户端版本与核心版本各有自己的升级节奏，客户端能够检查到更新，不代表任意更高版本的核心都能理解它生成的配置。
先确定本次使用的核心
查看当前配置选择的核心和启动日志，记录实际核心版本。若本次使用 Xray，sing-box 的上限不是这次连接失败的直接证据。双核心或复杂接管模式还需要分别记录参与的核心，避免只看软件“关于”窗口。 若曾手动替换 bin 中的文件，应核对实际执行文件和备份日期。7.25.4 只能作为客户端版本标签，不能替你证明目录里的 sing-box 仍是发行包原件。
升级决策按配置来源分流
| 配置来源 | 需要核对 |
|---|---|
| 客户端生成 | 当前客户端是否支持目标核心的格式 |
| 自己维护的 JSON | 核心迁移说明与自定义字段 |
| 外部导入的自定义配置 | 提供者声明的核心及版本范围 |
| 不要为追求“最新版”绕过已声明的兼容范围。预发行版还需要核对是否仍属于允许的版本线，不能只比较数字大小。稳定工作环境应保留可回退的客户端、核心和配置组合。 |
换核心失败时怎么收窄问题
先保留启动错误与当前生成配置的脱敏副本，再区分“解析配置失败”和“已启动但连接失败”。前者优先对照字段兼容；后者再看目标连接、路由和 DNS。只恢复已知匹配的核心版本再试，避免一次同时换内核和客户端。 若恢复后问题消失，只能说明版本组合值得继续调查，不能宣称某个新版核心普遍不可用。本站未执行客户端与 1.14 核心的设备测试。升级回退指南提供组合记录方法。