# sing-box 内核是什么，为何换个版本配置就报错 > 来源 https://jichangtuijianweb.co/kepu/sing-box-neihe/，更新于 2026 年 9 月 20 日。机场推荐网（https://jichangtuijianweb.co/）原创内容。 > 分类 协议与内核。 sing-box 出自 SagerNet，是开源的代理内核，配置用 JSON 写，官方自己出各平台客户端。它改格式很果断，旧写法先标弃用，多数隔两个小版本就删，订阅得跟着版本走。 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 格式的订阅，两种格式的对照在[代理内核是什么](https://jichangtuijianweb.co/kepu/daili-neihe-shi-shenme/)那篇的表里。 ## 弃用清单就是一张删除时间表 清单很长，挑几条和普通用户关系最大的列出来，括号里是那个版本在 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 的老客户端，老内核不认识新字段。机场订阅和客户端两边的版本对不上，报错可能出在任何一边，[订阅更新失败](https://jichangtuijianweb.co/kepu/dingyue-gengxin-shibai/)那篇把几种常见原因分开讲了。 迁移指南和弃用清单是配套的，按版本列了 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 客户端页](https://jichangtuijianweb.co/kehuduan/sing-box/)。 ## 第三方客户端各自带着一份内核 本站客户端资料库里，内核标 sing-box 的有 32 款，官方客户端之外，[Hiddify](https://jichangtuijianweb.co/kehuduan/hiddify/)、[Karing](https://jichangtuijianweb.co/kehuduan/karing/)、NekoBox for Android、Husi 都在其中，停更的 NekoRay 和接替它的 Throne 也在。官网的客户端页只收官方那三个，还特意交代了不收的理由，这类项目图的多半是用户数，客户端功能再顺手，代码质量往往一般，还夹着广告。这是 sing-box 官方的看法，本站没有逐个审过这些客户端的代码。 对用户来说，更实际的一点在版本上。第三方客户端打包进去的 sing-box 是哪一版，由客户端作者决定。同一份机场订阅，在官方客户端里能跑，在某个第三方客户端里报错，很可能就是两边的内核隔着一两个小版本，前面那张删除时间表可以拿来对照。sing-box 和 Xray、V2Ray 之间的来龙去脉，放在 [V2Ray、Xray 与 sing-box 分化纪事](https://jichangtuijianweb.co/kepu/v2ray-xray-singbox-jishi/)里。 ## 常见问题 ### sing-box 升到 1.14 以后配置报错，问题可能出在哪 先查是不是用了已删除的旧写法。1.14.0 的更新说明写明按约定移除了弃用功能，其中最常碰到的是 1.12.0 就标了弃用的旧 DNS 服务器格式。官网的迁移指南按版本列了改法。配置来自机场订阅的话，把报错和客户端版本发给机场，让他们更新 sing-box 格式的订阅。 ### iPhone 上的 sing-box VT 不见了，现在该装哪个 装 sing-box MT。1.14.0 的更新说明写着苹果平台客户端迁到了新的开发者账号，iOS 和 tvOS 版以 sing-box MT 的名字重新上架，旧版 VT 的用户要装新应用。App Store 显示它的开发者是 Metamerism LLC，要求 iOS 15.0 以上。换装前把订阅链接备好，装好后重新导入。 ### Windows 上有 sing-box 官方的图形客户端吗 有，从 1.14.0 开始。更新说明介绍了 sing-box for Desktop，支持 Windows 10 及以上的 x64、x86 和 arm64，Linux 支持 x64、arm64 和 armv7l，安装包只在 GitHub Releases 上发。在这之前，官方的图形客户端只覆盖安卓和苹果平台。 ### sing-box 的 alpha 版、beta 版和正式版该用哪个 日常用正式版，写这篇时是 2026 年 9 月 15 日的 v1.14.1。v1.15.0-alpha.6 这类带 alpha 的是预发布，新功能先在里面试。1.14.0 起 Linux 软件包和 Docker 镜像分成正式、beta、testing、oldstable 四条线，oldstable 对应上一个正式版分支，适合暂时不想升级的人。 ### sing-box 为什么读不了 geoip.dat 和 geosite.dat 这两种数据文件已经被 sing-box 淘汰。弃用清单写着 GeoIP 和 Geosite 在 1.8.0 标记弃用，1.12.0 删除，替代品是 rule-set。rule-set 从 1.8.0 起写在 route 里，可以引用本地文件，也可以填一个远程地址让内核自己下载。 ## 参考来源 - [sing-box 仓库 README 与许可证](https://github.com/SagerNet/sing-box) - [sing-box 仓库信息，默认分支 testing](https://api.github.com/repos/SagerNet/sing-box) - [sing-box 文档，配置文件结构与 check 命令](https://sing-box.sagernet.org/configuration/) - [sing-box 文档，route](https://sing-box.sagernet.org/configuration/route/) - [sing-box 文档，弃用功能清单](https://sing-box.sagernet.org/deprecated/) - [sing-box 文档，迁移指南](https://sing-box.sagernet.org/migration/) - [sing-box 文档，官方图形客户端](https://sing-box.sagernet.org/clients/) - [sing-box 文档，苹果平台客户端](https://sing-box.sagernet.org/clients/apple/) - [sing-box 文档，安卓客户端](https://sing-box.sagernet.org/clients/android/) - [sing-box v1.14.0 更新说明](https://github.com/SagerNet/sing-box/releases/tag/v1.14.0) - [sing-box v1.14.1 发布页](https://github.com/SagerNet/sing-box/releases/tag/v1.14.1) - [sing-box v1.13.0 更新说明](https://github.com/SagerNet/sing-box/releases/tag/v1.13.0) - [sing-box v1.12.0 更新说明](https://github.com/SagerNet/sing-box/releases/tag/v1.12.0) - [sing-box v1.11.0 更新说明](https://github.com/SagerNet/sing-box/releases/tag/v1.11.0) - [sing-box v1.10.0 发布页](https://github.com/SagerNet/sing-box/releases/tag/v1.10.0) - [sing-box v1.8.0 发布页](https://github.com/SagerNet/sing-box/releases/tag/v1.8.0) - [sing-box 发布页](https://github.com/SagerNet/sing-box/releases) - [App Store 查询接口，sing-box MT](https://itunes.apple.com/lookup?id=6785326793&country=us) - [App Store，sing-box MT](https://apps.apple.com/us/app/sing-box-mt/id6785326793) - 本站客户端资料库，内核标注为 sing-box 的 32 款