Sing 入门：sing-box 定位与配置说明

sing-box 将自身定位为通用代理平台，使用 JSON 配置文件，文档分别列出入站、出站与端点类型。v2rayN 的官方说明也明确支持 sing-box，但具体功能仍有内核差异，不能把平台的协议目录直接当作客户端内所有功能的支持清单。

sing-box 的定位和许可证分别说明什么？

通用代理平台是项目给出的定位

README 与文档首页都将 sing-box 定位为通用代理平台。理解这一定位，可以从文档的分类入手：入站、出站、端点，以及 DNS、路由等配置各有对应内容。

这些分类呈现的是平台的配置范围。阅读时需要保留分类之间的区别，同一个名称出现在某一目录里，不能据此补出它在其他目录中的配置方式或支持情况。

许可证还包含名称使用限制

README 的许可证说明采用 GNU GPL 第 3 版或更高版本条款，并附有名称限制：衍生作品未经同意，不得使用该应用的名称，也不得暗示与其存在关联。

因此，许可证说明包含授权条款与衍生作品名称使用两部分。涉及改动后再发布的情形，不能只摘取 GPL 的名称而省去 README 同时列出的附加限制。

协议名称需要放回各自的目录里理解

入站目录列出了哪些类型？

入站目录列有 Direct、Mixed、SOCKS、HTTP、Shadowsocks、VMess、Trojan、Naive、Hysteria、ShadowTLS、VLESS、TUIC、Hysteria2、AnyTLS 与 Snell。

同一目录还列有 Tun、Redirect、TProxy、Cloudflared 和 Tailcat。这里保留的是文档中的入站分类，不能仅凭名称，把这些条目全部解释为同一种用途或相同的配置方法。

出站目录中有哪些已明确列出的名称？

出站目录列有 Direct、Bridge、Block、SOCKS、HTTP、Shadowsocks、VMess、Trojan、Naive、WireGuard、Hysteria、ShadowTLS、VLESS、TUIC、Hysteria2、AnyTLS、Snell、Tailcat 与 Tor。

这部分名称只能作为已列出条目的说明，不能视为完整出站清单。入站与出站目录也并非逐项相同，例如上述出站条目中有 Bridge、Block、WireGuard 和 Tor。

端点是另列的一类配置

端点目录列有 WireGuard、Tailscale、OpenConnect Client、OpenVPN Client/Server，以及 MASQUE Client/Server。文档将它们放在 Endpoint 分类下，与入站和出站分别列示。

WireGuard 同时出现在出站与端点目录中。查阅相关配置时，需要连同所属分类一起辨认；只看到名称相同，并不足以把两个目录下的内容合并理解。

JSON 配置里有哪些明确的结构？

顶层字段覆盖多个配置部分

sing-box 使用 JSON 配置文件，顶层字段包括 log、dns、ntp、certificate、endpoints、inbounds、outbounds、route、services 与 experimental 等。

这份字段列表说明了配置的组织范围，并没有给出一份可直接使用的配置。字段名称可以用于辨认对应部分，具体填写内容不能从名称本身推导出来。

入站、出站与端点各有对应字段

配置顶层同时列出 inbounds、outbounds 与 endpoints，文档目录也分别列出对应类型。阅读配置说明时，可以保留这种对应关系，避免将不同分类的条目混在一起。

此外，log、dns、ntp、certificate、route 和 services 也属于顶层字段。协议类型目录与这些配置部分共同构成文档结构，协议名称本身并不等于全部配置内容。

实验性配置有单独的文档范围

文档在实验性配置中列有 V2Ray 传输、Clash API 和 V2Ray API 的对应页面。能够确认的是这些文档条目的存在，以及它们所属的配置分类。

其中，Clash API 的具体能力与限制，官方没有说明。不能仅凭目录中的 API 名称，就认定它与 Clash 客户端兼容，或补写具体可用功能。

v2rayN 对 sing-box 的支持体现在哪里？

官方说明明确列有 sing-box

v2rayN 的 README 明确写有对 Xray、sing-box 及其他核心的支持；支持的核心列表也在 sing_box 系列下列出 sing_box core。

这足以确认 v2rayN 与 sing-box 存在支持关系。不过，各协议具体由哪个内核处理的完整对照，官方没有说明，不能把 sing-box 的目录直接套成 v2rayN 的逐项支持表。

DNS 与策略组有对应说明

v2rayN 的界面功能说明将 DNS 按 Xray 和 sing-box 分成两大部分。策略组也支持这两个内核，其中 sing-box 支持一种策略组类型。

同一说明还要求，策略组中的全部配置文件都必须被所选内核支持。因此，确认策略组支持 sing-box，与确认组内每份配置都能由它处理，是需要分别核对的事情。

部分功能有明确的内核边界

v2rayN 的说明写明，ICMP 路由策略仅由 sing-box 支持，部分 TUN 选项也只对 sing-box 有效。这些属于具体功能的支持范围。

证书指纹验证则仅支持 Xray，sing-box 会直接忽略该项。理解这类差异时，应以对应功能说明为依据，不能把某个选项的存在等同于所有内核都会执行它。

常见问题

sing-box 的配置文件是什么格式？

sing-box 使用 JSON 配置文件。顶层字段涉及日志、DNS、入站、出站、端点、路由等部分，阅读具体配置时需要区分这些部分各自所属的字段。

有 Clash API 文档就代表兼容 Clash 客户端吗？

文档目录确实列有 Clash API 页面，位置在实验性配置中。它的具体能力与限制，官方没有说明，因此不能据此确认与 Clash 客户端的兼容关系。

v2rayN 支持 sing-box，是否代表目录里的类型都能直接使用？

v2rayN 官方明确列有 sing-box 支持，但每种协议与内核的完整对应关系，官方没有说明。策略组还要求全部配置文件都受所选内核支持，具体可选项应以应用内界面为准。

第三方整理,与相关软件及服务的开发者无隶属关系。

Sing 是什么：读懂 sing-box 与 v2rayN 的关系