sing-box 内核是什么，为何换个版本配置就报错

sing-box 的文档有个习惯，不少字段后面跟着一行小字，写明从哪个版本开始才有。route 那一页，rule_set 标着 1.8.0，default_domain_resolver 标着 1.12.0，find_neighbor 标着 1.14.0。文档里另有一页专门列弃用清单，从 1.6.0 一路记到还没发布的 1.15.0，每一行写着哪个版本开始弃用、哪个版本删除、换成什么。

两处放在一起看，意思很明白。同一份 JSON，交给 1.11 能跑，交给 1.14 可能直接报错。用 sing-box 的人，得比用别的内核多盯一个版本号。

谁在做，配置长在哪

sing-box 出自 SagerNet，README 的版权行写的是 2022 年的 nekohasekai，GitHub 简介只有一句 The universal proxy platform。许可证是 GPL 第 3 版或更新版本，外加一条附加条款，衍生作品未经同意不得用这个名字，也不得暗示与它有关联。仓库的默认分支叫 testing，正式版也从这条分支上打标签，v1.14.1 就是。

它读 JSON，顶层现在有十几个键，节点放在 outbounds，分流放在 route，DNS 单独一块。和 mihomo 那套 YAML 互不相通，机场要单独生成一份 sing-box 格式的订阅，两种格式的对照在代理内核是什么那篇的表里。

弃用清单就是一张删除时间表

清单很长，挑几条和普通用户关系最大的列出来，括号里是那个版本在 GitHub 上的发布日期。

旧写法	标记弃用	删除	换成什么
GeoIP、Geosite 数据文件	1.8.0（2024-01-06）	1.12.0（2025-08-04）	rule-set
block、dns 这类特殊出站	1.11.0（2025-01-30）	1.13.0（2026-02-28）	规则动作
WireGuard 出站	1.11.0	1.13.0	endpoint
旧的 DNS 服务器写法	1.12.0	1.14.0（2026-08-31）	新的 DNS 服务器格式
TUN 的 stack 选项	1.15.0	1.17.0	删掉这一项，sing-tun 改用自己的协议栈

规律一眼能看出来。除了 GeoIP 和 Geosite 拖了四个小版本，其余多数隔两个小版本就删。弃用期间旧写法还能用，到了删除那一版就不再认。1.14.0 的更新说明里有一句，按约定移除弃用功能，旧的 DNS 服务器写法就是在这一版被拿掉的。

拿 DNS 这一条算一笔账。一份按 1.11 写法生成的配置，在 1.12 和 1.13 里还能跑，到 2026 年 8 月 31 日的 1.14.0 就读不进去了。反过来也一样，按新写法生成的配置交给停在 1.11 的老客户端，老内核不认识新字段。机场订阅和客户端两边的版本对不上，报错可能出在任何一边，订阅更新失败那篇把几种常见原因分开讲了。

迁移指南和弃用清单是配套的，按版本列了 21 节，从 1.8.0 把 GeoIP 迁到 rule-set，到 1.15.0 迁移 TUN 协议栈，每一节给出改前改后的写法。自己写配置的人，升级前把跨过的那几个版本的小节看一遍就够了。

大约半年一个小版本，每一版都往里加东西

最近几个小版本的间隔很整齐。1.10.0 在 2024 年 10 月 15 日，1.11.0 在 2025 年 1 月 30 日，1.12.0 在 2025 年 8 月 4 日，1.13.0 在 2026 年 2 月 28 日，1.14.0 在 2026 年 8 月 31 日。小版本之间是修订版，最新正式版是 2026 年 9 月 15 日的 v1.14.1，更新说明只有一行，修复和改进。三天后的 9 月 18 日，下一代的 v1.15.0-alpha.6 已经以预发布的身份挂了出来。

每个小版本的更新说明，开头都是一份自上一版以来的重要变化。挑和机场用户有关的几条看。

1.11.0 引入了规则动作，拦截、劫持 DNS 这些事从特殊出站挪进了路由规则，WireGuard 出站升级为 endpoint，Hysteria2 加了端口跳跃。1.12.0 重写了 DNS 服务器部分，加了域名解析器选项和 TLS 分片，AnyTLS 协议也是这一版加的，说明里对它的描述是号称能减轻 TLS 代理的流量特征，并带着一套新的多路复用方案。1.13.0 加了 NaiveProxy 出站和 ping 代理，还顺手放进了 Claude Code 和 OpenAI Codex 的多路复用服务，通用平台这几个字不是白写的。

1.14.0 的清单最长。协议方面加了 Snell，说明里还评论了一句 Surge，大意是 Surge 以为闭源、不扩散就能让 Snell 保持隐蔽，到 2026 年这已经做不到了，Snell 仍有带完整 TCP 语义的多路复用等长处，所以他们用 Go 重写了一份，除了 v5 的 QUIC 代理，功能都有。Hysteria2 多了 Chrome QUIC 指纹模仿、BBR 配置、跳端口间隔随机化和 gecko 混淆，另外加了 OpenVPN 和 OpenConnect。配置文件方面加了 JSON Schema，顶上写一行 $schema，支持它的编辑器就能补全和校验字段。文档首页列的 sing-box check 命令更直接，拿到一份配置先跑一遍，能不能加载当场就知道。

同一版还把 Linux 软件包和 Docker 镜像分成了四条线，正式版、beta、testing，外加一个 oldstable，对应上一个正式版分支。服务器上跑 sing-box、暂时不想跨小版本的人，oldstable 是条退路。

官方客户端，从下不了架到换了门面

sing-box 和 mihomo、Xray 最不一样的地方，是开发者自己维护各平台的图形客户端，和内核同一个仓库发版。这几个客户端过去一年并不顺。

2025 年 8 月的 1.12.0 更新说明里写着，App Store 和 Play Store 上的 sing-box 应用一直更新不了，在重写并重新提交之前，官方把它们视为无法恢复，之后不再重复这条通知。一年以后的 1.14.0 带来了转机，苹果平台客户端迁到新的开发者账号，iOS 和 tvOS 版以 sing-box MT 的名字重新上架，原来 sing-box VT 的用户要装新应用。

我 9 月 20 日查 App Store 的接口，sing-box MT 的开发者是 Metamerism LLC，2026 年 8 月 31 日首次上架，当前版本 1.14.5，9 月 15 日更新，要求 iOS 15.0 以上。App Store 上的版本号是应用自己的编号，和 GitHub 上的内核版本对不齐，别拿来互相比。旧的 VT 页面在美区 App Store 已经打不开，官网的苹果客户端页在我核对时却还挂着它的链接，以更新说明为准。

Mac 版 SFM 走了另一条路。更新说明说，由于权限限制，它不再通过 Mac App Store 提供，改用独立版，可以用 Homebrew 装，也可以从 GitHub Releases 下载，旧应用里的配置和设置不会继承，迁移指南为此专门写了一节。

Windows 和 Linux 在 1.14.0 第一次有了官方图形客户端，叫 sing-box for Desktop，支持 Windows 10 及以上的 x64、x86、arm64，Linux 支持 x64、arm64 和 armv7l，只在 GitHub Releases 上发。安卓版仍然有 Google Play、F-Droid 和 GitHub Releases 三个渠道。老手机要留意，1.13.0 的说明写明那是最后一个支持安卓 5.0 的版本，而且只有带 legacy-android-5 后缀的单独构建。官网安卓页上写的还是 5.0 以上，同样以更新说明为准。各平台怎么下载、导入订阅，见 sing-box 客户端页。

第三方客户端各自带着一份内核

本站客户端资料库里，内核标 sing-box 的有 32 款，官方客户端之外，Hiddify、Karing、NekoBox for Android、Husi 都在其中，停更的 NekoRay 和接替它的 Throne 也在。官网的客户端页只收官方那三个，还特意交代了不收的理由，这类项目图的多半是用户数，客户端功能再顺手，代码质量往往一般，还夹着广告。这是 sing-box 官方的看法，本站没有逐个审过这些客户端的代码。

对用户来说，更实际的一点在版本上。第三方客户端打包进去的 sing-box 是哪一版，由客户端作者决定。同一份机场订阅，在官方客户端里能跑，在某个第三方客户端里报错，很可能就是两边的内核隔着一两个小版本，前面那张删除时间表可以拿来对照。sing-box 和 Xray、V2Ray 之间的来龙去脉，放在 V2Ray、Xray 与 sing-box 分化纪事里。