MKMihomo 与 sing-box 内核手册TECHNICAL REFERENCE · mihomo / sing-box
文档号
YYK-1.2
修订 · 页
2026-10-18 · 03/10
§ 1.2sing-box第 03 / 10 页

sing-box 是什么

Mihomo 与 sing-box 内核手册编辑部 · 更新于 2026-10-18

sing-box 是命令行形式的通用代理平台,配置采用 JSON。Project S 还维护 Android、Apple 平台以及 Windows 和 Linux 桌面客户端,官方文档对未列出的部分第三方项目有明确批评。

sing-box 是命令行内核,官方用“The universal proxy platform”描述项目,配置文件使用 JSON。它与图形客户端不是同一个程序;Project S 也维护自己的 Android、Apple 平台和桌面客户端,具体平台对应关系见下表。

官方客户端平台

客户端名称官方列出的平台发布页里的文件
sing-box for AndroidAndroidSFA-*.apk
sing-box for Apple platformsiOS、macOS、Apple tvOSSFM-*.pkg(macOS);SFI-*.deb(iOS 越狱版,rootless iOS 15.0+)
sing-box for DesktopWindows、Linux见下载与版本

1.14.0 起,iOS 与 tvOS 客户端回到 App Store,名称为 sing-box MT;旧版 sing-box VT 用户需安装新应用。SFM 不再上架 macOS App Store,改为独立版。桌面客户端是 1.14.0 新增的,支持 Windows 10 及以上(x64、x86、arm64)和 Linux(x64、arm64、armv7l),通过 GitHub Releases 分发。

配置和许可证

配置使用 JSON,顶层结构包括 log、dns、ntp、certificate、endpoints、inbounds、outbounds、route、services 和 experimental 等。结构中分别容纳日志、DNS、入站、出站与路由等配置,详细字段以配置结构页为准。

许可证是 GPL-3.0 或更高版本,并附有名称限制:未经同意,衍生作品不得使用该应用名称或暗示关联。GitHub API 的许可证字段为 NOASSERTION;项目 README 和 LICENSE 文本提供了具体条款。仓库以 Go 开发,默认分支名为 testing。

官方对第三方客户端的说明

官方客户端页指出,部分声称使用 sing-box 或以 sing-box 为卖点、但未列在官方客户端列表中的项目,其维护者核心动机是获取用户,代码通常质量差且含广告。官方页面不列任何第三方客户端;某个第三方客户端是否使用 sing-box,官方没有说明。

和 Clash 的关系

sing-box 不是 Clash 的分支,官方文本里也没有「源自 Clash」之类的说法;文档记录的是它提供 Clash API 兼容接口。1.14.0 起另有自有 gRPC API 服务,可供图形客户端远程控制。两种内核的对照见两种内核的差别。

常见问题

sing-box 使用什么配置格式?

官方配置文档说明 sing-box 使用 JSON。配置顶层包含日志、DNS、入站、出站、路由等部分;部分字段只在 1.15.0 alpha 文档里出现,阅读时要对应版本。

sing-box 有官方图形客户端吗?

有。官方列出 Android、Apple 平台以及 Windows 和 Linux 桌面客户端,各平台名称和分发方式见官方客户端页。