sing-box是什么？先分清内核、客户端、订阅和节点
简答：sing-box是一个通用代理平台和代理内核，不是节点、订阅或服务商。它按JSON配置处理入站、出站、DNS与路由，能否连接取决于配置、节点、协议和网络。
定义：sing-box是一套以JSON配置为基础、负责流量接入、DNS处理、规则路由和协议转发的通用代理平台。
先看结论：sing-box到底是什么
sing-box更接近“代理内核加配置系统”，不是自动提供节点的服务，也不是购买后即可使用的订阅。它接收设备或应用的流量，依据JSON配置处理DNS、路由和出站连接。本文为第三方使用指南，不代表任何软件项目或服务商官方说明。
| 概念 | 定义 | 它不是什么 | 使用前要准备什么 |
|---|---|---|---|
| sing-box内核 | 执行连接、DNS、规则和协议处理的程序 | 不是节点，也不自动提供订阅 | JSON配置或图形客户端 |
| 图形客户端 | 负责安装、导入、启动、权限和系统接管的界面程序 | 不等于服务器或服务商 | 对应系统的客户端 |
| 订阅 | 远程地址、文件或文本形式的节点与配置集合 | 不一定兼容所有内核 | 确认格式是否支持sing-box |
| 节点 | 实际用于连接远端的服务器配置 | 不是sing-box自带资源 | 来源可信且可用的配置 |
所以，安装sing-box并不等于已经拥有可用线路。没有出站配置、订阅格式不兼容、DNS规则错误、TUN权限不足或远端配置不可达，都可能导致无法连接。
它能做什么：入站、出站、DNS和路由
官方配置结构使用JSON，并把功能拆成多个字段。普通用户首先需要理解inbounds、outbounds、dns和route。
| 字段 | 作用 | 可以怎样理解 | 出问题时先查什么 |
|---|---|---|---|
inbounds | 定义流量如何进入sing-box | 本地代理接入、TUN或其他入口 | 应用或系统是否把流量交给它 |
outbounds | 定义流量如何离开sing-box | 直连或通过指定协议连接远端 | 服务器、认证、TLS和协议是否匹配 |
dns | 定义DNS服务器和解析规则 | 决定域名由哪个DNS处理 | DNS服务器是否可达、规则是否命中 |
route | 根据规则选择出口或执行动作 | 决定流量走哪个outbound | 规则顺序、标签和最终出口 |
官方配置文档列出了JSON的顶层结构，包括dns、inbounds、outbounds和route等字段，具体字段应以官方配置结构文档为准。
direct表示直接发送请求，不代表自动选择最快线路。阻断连接也不应简单理解为旧式特殊出站；当前文档通过route规则动作处理，包括reject等动作，实际写法应以官方 Rule Action 文档为准。
最小配置示例：看懂sing-box的基本骨架
下面只是帮助理解字段关系的示例，不是可直接连接远端的完整配置。示例中的端口、服务器地址、认证信息和协议字段都必须替换，实际设置以客户端和当前文档为准。
{
"log": {
"level": "info"
},
"inbounds": [
{
"type": "mixed",
"tag": "mixed-in",
"listen": "127.0.0.1",
"listen_port": <端口>
}
],
"outbounds": [
{
"type": "direct",
"tag": "direct"
}
],
"route": {
"rules": [],
"final": "direct"
}
}inbounds中的mixed表示一个本地混合代理入口，端口必须替换为客户端实际设置。outbounds中的direct只表示直连示例，不代表已经配置远端节点。route.final定义没有其他规则命中时使用的出口。- 真正连接远端时，需要在
outbounds中加入与服务端匹配的协议和参数，并让路由规则引用正确的标签。
官方配置页面提供了配置检查、格式化和合并命令。命令行环境可以先执行：
sing-box check -c config.json这里的config.json是示例文件名，实际路径必须替换。配置检查通过只表示文件能够被解析，不代表节点可达、DNS正常或系统已经接管流量。
sing-box是客户端吗？官方客户端与第三方客户端怎么区分
“sing-box”在实际讨论中既可能指核心程序，也可能指图形客户端。核心程序负责执行配置，图形客户端负责安装、编辑、启动、停止、权限申请和系统代理或TUN接管。
官方图形客户端页面当前按平台列出Android、iOS/macOS/Apple tvOS、Windows和Linux对应的客户端入口。平台名称和客户端状态可能变化，下载前应查看官方图形客户端列表。
| 使用方式 | 主要负责什么 | 适合怎样的用户 |
|---|---|---|
| 官方图形客户端 | 提供平台界面、权限管理、配置导入和连接控制 | 希望少用命令行、需要系统接管的人 |
| 核心程序 | 读取JSON并执行入站、出站、DNS和路由 | 需要命令行、服务器或自动化管理的人 |
| 第三方客户端 | 可能集成sing-box内核并提供额外界面 | 愿意独立核对来源、权限和维护状态的人 |
官方页面明确提示，声称使用sing-box或把sing-box作为卖点的第三方项目不一定列在官方客户端列表中。因此，不能仅凭应用名称、图标或截图判断来源。
sing-box与Clash、Mihomo、Xray有什么区别
这些名称经常被并列比较，但比较时要区分“内核”“配置格式”和“客户端生态”。它们不是简单的不同皮肤。
| 对象 | 主要定位 | 配置或生态特点 | 选择时先看什么 |
|---|---|---|---|
| sing-box | 通用代理平台和代理内核 | 以JSON配置为核心，组织入站、出站、DNS和路由 | 是否需要细分规则、DNS或多平台配置 |
| Clash | 配置格式与客户端生态的统称性用法 | 不同客户端和内核可能存在格式差异 | 订阅格式是否与当前客户端匹配 |
| Mihomo | Clash配置生态中常用的一种内核 | 通常配合支持该生态的客户端使用 | 现有配置是否面向Mihomo或兼容格式 |
| Xray | 另一套代理核心和协议实现 | 配置结构、字段和客户端生态不同 | 已有配置或指定协议是否要求Xray |
不能仅凭内核名称判断速度、稳定性或隐私效果。实际表现还受到节点、协议、网络路径、DNS、MTU、系统权限和规则写法影响。Clash格式订阅也不能默认直接作为sing-box原生JSON使用，导入前必须确认客户端支持的格式。
普通用户第一次使用sing-box，按这几步核对
- 先确定用途：你是要接管整台设备、只给应用提供本地代理，还是在命令行环境运行核心程序？用途不同，所需入口和权限不同。
- 核对下载来源：从官方客户端列表进入对应平台项目，无法确认来源的安装包标记为“未核实”。
- 确认配置格式：订阅可能是Clash、sing-box JSON、WireGuard或其他格式。先看服务提供方说明和文件结构，不要因为链接能复制就判断为兼容。
- 检查出站和标签：确认至少存在一个出站，并检查路由规则引用的标签是否与
outbounds中的标签完全一致。 - 执行配置检查：使用官方配置文档中的检查命令，确认文件能被当前程序解析。
- 分开排查网络：配置通过后，再检查DNS、远端出站可达性、TLS参数、系统代理或TUN权限、路由命中和MTU。一次只改一个因素。
- 核对版本变化：字段可能新增、迁移或弃用。版本和变更应查看官方变更记录，不要直接照搬旧配置。
sing-box连不上时的5步自查
| 顺序 | 检查项 | 判定标准 | 下一步 |
|---|---|---|---|
| 1 | 配置检查 | 程序能够解析JSON，没有字段或格式错误 | 若失败，先修正配置结构 |
| 2 | DNS解析 | 域名能够按预期解析，DNS服务器可达 | 检查DNS字段和DNS规则 |
| 3 | 出站可达 | 服务器地址、协议、认证和TLS参数匹配 | 对照服务端配置逐项核对 |
| 4 | 路由命中 | 请求被分配到预期的outbound | 检查规则顺序、标签和final |
| 5 | 系统接管 | 系统代理或TUN权限已开启，应用流量确实进入sing-box | 检查系统权限、VPN权限和客户端状态 |
如果配置检查通过但仍无法连接，不要立即更换内核。先判断问题属于配置、DNS、远端出站、路由还是系统权限，才能缩小范围。
哪些人适合使用sing-box
需要跨平台配置、细致控制DNS和路由、使用TUN接管，或希望拆分入站与出站的人，通常更容易理解sing-box的价值。它的重点是可配置性和模块化，不是自动提供节点。
如果你只想通过图形界面完成连接，不想编辑JSON，也没有现成的兼容配置，那么带有清晰导入流程的图形客户端可能更容易上手。即使使用图形客户端，也建议先确认订阅格式、出站标签、DNS和系统权限。
下载文件、应用或配置前，应核对来源和项目页面；不要把订阅链接随意提交给不可信的在线转换服务。涉及办公账号或单位网络时，还应遵守组织的网络政策和服务使用规则。
常见问题
sing-box是VPN吗？
严格来说，sing-box是通用代理平台和代理内核，不是VPN服务商。它可以通过TUN等方式接管设备流量，但最终使用方式取决于客户端、系统权限、配置和出站协议。
sing-box需要订阅吗？
不一定。你可以手动编写JSON配置，也可以导入兼容的订阅或配置文件。sing-box本身不提供节点，是否需要订阅取决于你的使用场景和配置来源。
Clash订阅能直接导入sing-box吗？
不能默认认为可以。Clash格式、sing-box原生JSON和其他协议配置可能不同，导入前要确认客户端支持的格式，或确认配置提供方明确提供了sing-box格式。
sing-box和Mihomo有什么区别？
sing-box是独立的通用代理平台和内核；Mihomo是Clash配置生态中常用的一种内核。两者的配置结构、字段和客户端生态不同，不能直接混用配置。
sing-box配置检查通过但还是连不上怎么办？
继续检查DNS、出站服务器、认证与TLS、路由规则、系统代理或TUN权限以及MTU。配置检查通过只说明文件可解析，不代表远端链路或系统接管已经正常。
sing-box在哪里下载？
优先从官方图形客户端列表进入对应平台项目，再核对项目发布页面。客户端名称、平台支持和版本状态可能变化，无法确认来源的文件应视为未核实。