sing-box 是什么？内核、官方客户端与各平台入口

梯子岛编辑部 · 更新于

客户端sing-box 系难度：进阶约 8 分钟读完

先说结论

sing-box 是用 JSON 配置的通用代理内核，官方另有 Android、Apple、桌面三类图形客户端。下载认 SagerNet 名下的仓库和官方文档站列出的渠道，Apple 版需要非中国大陆区的 Apple 账户。

sing-boxv1.14.3仍在更新

通用代理平台内核，配置为 JSON；官方另有 Android、Apple、桌面图形客户端。

类型
代理内核
内核
sing-box（自身）
支持系统
Windows、macOS、Linux、安卓、iPhone / iPad、路由器
许可证
GPL-3.0-or-later，附加条款：衍生作品不得使用该名称或暗示与其关联
TUN 模式
支持
订阅与配置格式
sing-box JSON 配置（本地文件、iCloud、或以 URL 为更新源的远程配置）
最新版本发布于
2026-10-09（核验时已发布 0 天）
版本核验时间
2026-10-09 09:07 UTC（来源：GitHub 官方接口）
项目状态依据
GitHub 仓库未归档，v1.14.3 于 2026-10-09 发布，同日还有 1.15.0-alpha.11 预发布。

协议支持（以官方文档为准；↗ 表示客户端没有单列、随它内置的内核；没写的标“待核实”）

  • VMess
  • VLESS
  • Reality
  • Trojan
  • Shadowsocks
  • SSR
  • Hysteria2
  • TUIC
  • WireGuard
  • AnyTLS

官方发布页GitHub 仓库官方文档官方主页

官方文档里写明的注意事项

  • Apple 版需要非中国大陆区的 Apple 账户；TestFlight 测试版名额只给赞助者。
  • Apple 版的 TUN 由 NetworkExtension 提供，auto_route、stack 等 tun 选项未实现；按进程名分流仅 macOS 独立版和 iOS 越狱版可用。
  • WireGuard 出站自 1.11.0 起弃用，应改用 endpoint 写法；ShadowsocksR 已在 1.6.0 移除。
这张卡片的资料来源（20 条，核验于 2026-10-09）
  1. 官方图形客户端列表：Android 为 sing-box for Android，iOS/macOS/tvOS 为 sing-box for Apple platforms，Windows 与 Linux 为 sing-box for Desktop。（sing-box.sagernet.org）
  2. SFA：Android 5.0+，渠道为 Play Store、Play Store 测试版、GitHub Releases、F-Droid（可复现构建、统一签名）。（sing-box.sagernet.org）
  3. SFI/SFM/SFT：iOS 15.0+/macOS 13.0+/tvOS 17.0+，需非中国大陆区 Apple 账户；App Store（iOS/tvOS）、TestFlight（仅赞助者）、iOS 越狱版 deb（GitHub Releases）、macOS 独立版（Homebrew Cask 与 GitHub Releases）。（sing-box.sagernet.org）
  4. Apple 客户端特性：TUN 经 NetworkExtension 实现，多项 tun 入站选项未实现，进程匹配仅 macOS 独立版与 iOS 越狱版支持。（sing-box.sagernet.org）
  5. sing-box for Desktop：Windows 10+（x64/x86/arm64）、Linux（x64/arm64/armv7l），从 GitHub Releases 下载。（sing-box.sagernet.org）
  6. 图形客户端通用规范：远程配置以 URL 为更新源，并须支持 sing-box://import-remote-profile 导入。（sing-box.sagernet.org）
  7. App Store 页面：官方文档链接的上架名称为 sing-box MT，开发者 Metamerism LLC，版权 nekohasekai，支持 iPhone、iPad、Apple TV（tvOS 17.0+）。（apps.apple.com）
  8. sing-box-for-android 仓库 README：SFA，实验性 Android 客户端，GPL-3.0。（github.com）
  9. sing-box-for-apple 仓库 README：实验性 iOS/macOS/tvOS 客户端。（github.com）
  10. sing-box-for-desktop 仓库 README：写“实验性 Windows 客户端，Linux 支持在路上”，与文档页的 Linux 说法不一致。（github.com）
  11. v1.14.3 发布资产含 SFA APK、SFI 越狱 deb、SFM pkg、SFW exe、SFL 的 deb/rpm 包，以及 Windows、macOS、Linux、Android 内核压缩包。（github.com）
  12. 出站类型列表含 vmess、vless、trojan、shadowsocks、hysteria2、tuic、wireguard、anytls 等。（sing-box.sagernet.org）
  13. WireGuard 出站自 1.11.0 起弃用。（sing-box.sagernet.org）
  14. WireGuard 作为 endpoint 自 1.11.0 提供。（sing-box.sagernet.org）
  15. TLS 共享配置含 reality 字段（public_key、short_id 等）。（sing-box.sagernet.org）
  16. 弃用列表：ShadowsocksR 自 1.5.0 起弃用，1.6.0 完全移除。（sing-box.sagernet.org）
  17. TUN 入站配置页。（sing-box.sagernet.org）
  18. 安装脚本支持 deb/rpm 系发行版、ArchLinux 与 OpenWrt；另有 Homebrew、Scoop 等包管理器。（sing-box.sagernet.org）
  19. LICENSE：GPL-3.0-or-later 并附加名称使用条款；README 指向官方文档。（github.com）
  20. GitHub API 显示仓库 archived=false。（api.github.com）
本文要点
  1. sing-box 是什么：同一个名字下的三样东西
  2. 按平台找官方入口：SFA、SFI、SFM、SFT、SFW、SFL
  3. Apple 平台要留意的三件事
  4. sing-box下载页与 sing-box github 仓库：各放什么
  5. singbox客户端怎么选：官方原版还是第三方
  6. 几个常见的误会
  7. 下载之后怎么核对来源
  8. 下一步：先决定要内核还是要客户端

sing-box 这个名字下其实有三样东西：一个用 JSON 配置的代理内核、官方做的几款图形客户端，以及一批基于它开发的第三方客户端。找安装包之前先分清你要的是哪一样，否则很容易下错。这一页按平台列出官方入口，说明几个 GitHub 仓库各放什么，再讲 JSON 配置意味着什么门槛。

sing-box 是什么：同一个名字下的三样东西

你说的这个名字 实际指什么 去哪里拿
内核 一个命令行程序，读取 JSON 配置 主仓库发布页里的内核压缩包
官方图形客户端 官方另做的 Android、Apple 和桌面版 见下一节的平台表
第三方客户端 别的团队基于它开发的软件，如 Hiddify、Karing 各自的档案页和官方渠道

主仓库发布页的资产里，既有各系统的内核压缩包，也有官方客户端的安装文件，所以“下载”不是一个动作，要先决定是哪一样。许可证在 GPL 之上加了一条：衍生作品不得使用该名称，也不得暗示与其有关联。名字里带这个词的第三方软件，请先核对来源。

按平台找官方入口：SFA、SFI、SFM、SFT、SFW、SFL

官方文档把图形客户端分成三组，这是梯子岛登记的情况：

平台 官方客户端 官方文档列出的获取渠道
Android SFA，源码仓库 Google Play、Play 测试版、GitHub 发布页、F-Droid
iOS SFI，源码仓库 App Store（官方链接的上架名为 sing-box MT）；TestFlight 仅限赞助者；越狱版安装包放在 GitHub 发布页
macOS SFM，与 iOS 同一个仓库 Homebrew Cask（名称为 sfm）、GitHub 发布页；文档没有提 Mac App Store
tvOS SFT，与 iOS 同一个仓库 App Store
Windows、Linux 官方桌面客户端，发布资产名为 SFW 和 SFL 文档的桌面客户端页指向 GitHub 发布页

官方文档写明的系统下限大致是：安卓 5.0、iOS 15、macOS 13、tvOS 17、Windows 10，实际以各客户端文档页的当前内容为准。三类官方客户端的仓库 README 里都有“实验性”的字样，别按成熟商业软件的预期去用它们。

Apple 平台要留意的三件事

  1. 账户：官方文档写明需要非中国大陆区的 Apple 账户。换区的官方做法见 Apple 的说明页 更改 Apple 账户的国家或地区，整体思路见 苹果梯子怎么选。梯子岛不提供、也不引导任何共享账号，风险见 共享账号靠谱吗。
  2. 测试版：TestFlight 渠道的名额只给赞助者，普通用户不要在这里花时间。
  3. 配置字段：Apple 版的 TUN 由系统的 NetworkExtension 提供，桌面教程里常见的 auto_route、stack 等选项在 Apple 版里没有实现，照抄不会生效。按进程名分流，也只有 macOS 独立版和 iOS 越狱版能用。具体哪些选项没有实现，以官方文档里的 Apple 客户端特性页为准，遇到“配置没报错但就是不起作用”的情况，先查这一页。

sing-box下载页与 sing-box github 仓库：各放什么

地址 放什么 备注
主仓库 内核源码 先确认组织名是 SagerNet
发布页 内核压缩包与官方客户端安装文件 除正式版外还会出现 alpha 预发布，日常使用选正式版
官方文档站 配置说明和客户端页 客户端的渠道清单以这里为准

读发布页文件名有个简单办法：名字里带 SFA、SFI、SFM、SFW、SFL 字样的，是官方客户端的安装文件，格式有 APK、deb、pkg、exe、rpm 等；按系统与架构命名的压缩包，则是内核本身。

桌面客户端的仓库名带有 for-desktop 的后缀，它的 README 仍写着“实验性 Windows 客户端、Linux 支持在路上”，与文档页和发布资产里已有的 Windows、Linux 安装文件对不上。碰到这种冲突，以文档页和发布资产为准。想把各款客户端的仓库入口放在一起看，用 GitHub 入口页。

singbox客户端怎么选：官方原版还是第三方

你想要的 更合适的选择 原因
官方原版，愿意读文档 上面的官方客户端 跟着官方内核走，远程配置以 URL 为更新源
界面省心，订阅又是 Clash 格式 第三方的 Hiddify、Karing 各自对订阅格式做了兼容，细节看档案页
命令行、路由器等无界面环境 直接用内核 配置要自己写、自己更新
习惯 Clash 的配置思路 先看 Mihomo 一路 两种内核的对比

官方对图形客户端定了统一规范：远程配置以 URL 为更新源，并要求支持一种专门的导入链接。配置本身是 JSON，字段多、层级深，少一个逗号整份配置就读不出来，所以上手门槛高于点几下就能用的客户端。配置读入失败时，先检查括号、引号是否成对、逗号有没有多余，再去怀疑节点本身；改一处、试一次，比一口气改很多处更容易找到出错的位置。从最小配置开始练习，读 JSON 配置文件入门；只想让官方客户端跑起来，读 官方客户端怎么用。

几个常见的误会

常见的说法 实际情况
它是一个 App 它首先是内核，App 是官方另做的
装上就有节点 内核和官方客户端都不提供节点，订阅要自备
Clash 订阅可以直接粘进官方客户端 档案登记的是 JSON 配置，Clash 格式要先转换，见 本地订阅转换
旧教程里的 WireGuard 写法照抄就行 该出站在较新的版本里被弃用，要改用 endpoint 写法
ShadowsocksR 节点也能用 ShadowsocksR 早已被移除，先读 SSR 的来历与现状
教程截图里的菜单永远不变 菜单名会随版本变化，截图只能当参考，操作时以你当前看到的界面为准
苹果商店里搜名字就能装 官方文档要求从它给出的渠道进入，并且需要非中国大陆区的账户

下载之后怎么核对来源

  1. 看仓库：组织名是 SagerNet，仓库名以上面的平台表和下载页表为准。
  2. 对文档：官方文档的客户端页是渠道清单，你拿到的渠道不在清单里，就先别装。
  3. 看上架名：苹果商店里名字相近的应用很多，从文档页给出的链接进去，别凭名字搜索。
  4. 看许可证条款：自称“官方”却换了名字、改了界面的，与许可证的附加条款对不上。
  5. 看发布类型：正式版和 alpha 预发布不是一回事，推荐给别人之前先分清。
  6. 不走野路子：群文件、网盘里的“整合包”，参考 破解版梯子软件能用吗。

下一步：先决定要内核还是要客户端

  1. 想要开箱即用的图形界面，从 客户端选择工具 筛一款，再回来对照官方入口表。
  2. 想用官方客户端，先在 协议矩阵 里确认你的节点协议在支持范围内。
  3. 想弄清术语，读词典里的 代理内核 条目。
  4. 还没有订阅：到 机场导航 对照资料自己挑，梯子岛不替你决定买哪家。

这篇没有覆盖的

  • 官方客户端在鸿蒙上的可用性资料待核实，内核二进制对 iOS 的说明也没有核实到。
  • 界面菜单会随版本变化，本文只讲入口与分工，不逐项教操作。
  • 梯子岛没有 sing-box 与其他内核的速度、占用对比数据，选型请自行验证。

本文引用的官方来源

  1. sing-box 官方文档（sing-box.sagernet.org）
  2. sing-box 官方仓库（github.com）
  3. sing-box 官方下载入口（github.com）
  4. sing-box for Android（SFA）（github.com）
  5. sing-box for Apple（SFI/SFM）（github.com）
  6. Apple 支持：更改 Apple 账户的国家或地区（support.apple.com）

以上链接均为官方页面，梯子岛在 2026-10-10 核对过；个别网站会拦截自动化访问，用浏览器直接打开即可。平台规则可能随时调整，以官方页面当前内容为准。

sing-box常见问题

sing-box 和 Hiddify、Karing 是什么关系？

Hiddify 和 Karing 是由别的团队开发的第三方客户端，内核都来自 sing-box 一系，Karing 用的是修改过的版本。它们不是官方客户端，界面和订阅处理都有自己的做法，选哪个看你是否需要 Clash 订阅兼容和跨平台。

iPhone 上怎么装官方的 sing-box？

官方文档写明需要非中国大陆区的 Apple 账户，App Store 渠道上架名为 sing-box MT，TestFlight 测试版名额只给赞助者。梯子岛不提供、也不引导任何共享账号，换区方法以 Apple 官方说明为准。

Windows 有官方图形客户端吗？

有。官方文档的桌面客户端页列出了 Windows 与 Linux 版，在 GitHub 发布页下载，发布资产里也能看到对应安装文件。桌面客户端仓库的 README 还写着实验性、Linux 在路上，两者不一致时，请以文档页和发布资产为准。

官方客户端能直接导入 Clash 订阅吗？

按档案，官方客户端登记的是 sing-box JSON 配置，包括本地文件、iCloud 和以 URL 为更新源的远程配置。订阅内容是 Clash 格式时，需要先转换，也可以改用兼容 Clash 订阅的第三方客户端。转换时尽量在本地完成。

ShadowsocksR 节点还能在 sing-box 里用吗？

不能。官方文档写明 ShadowsocksR 已在较早的版本里移除，档案里这一项登记为不支持。手头只有 SSR 节点时，可以先读梯子岛的 SSR 来历与现状页面，再决定要不要换协议或换客户端。

sing-box 能用在鸿蒙手机上吗？

这一项资料待核实，官方文档没有给出鸿蒙上的说明。HarmonyOS 4 及更早版本兼容安卓应用，HarmonyOS NEXT 不直接兼容安卓 APK，具体能不能装，要看官方当前的说法，梯子岛不替它下结论。

接着读

文中出现的术语

相关专题

接下来去哪儿？

找官方入口去网址导航，想核对仓库和版本看GitHub 项目导航；需要现成的机场，机场目录收了 28 家的价格与线路资料，性价比机场、便宜机场、VPN 机场分别有专项页。