sing-box 桌面客户端（Windows / macOS）配置教程
sing-box 是一个通用代理核心，桌面端使用体验取决于搭配的图形客户端。本文讲清核心与图形壳的关系、订阅导入与出站选择、TUN 配置的通用流程，以及和 Clash 系客户端的选择建议。
sing-box 和 Clash（Mihomo）是两个不同的代理核心项目：sing-box 定位是通用性更强的多协议核心，支持范围较广；但它本身只是命令行程序和配置文件，桌面端要有可用的图形界面，需要搭配社区或官方维护的图形客户端（GUI 壳）。理解这层关系，是配置 sing-box 桌面端的第一步。
核心与图形客户端的关系
- sing-box 核心：负责实际的协议解析、流量转发与规则匹配，以 JSON 配置文件驱动；
- 图形客户端：提供订阅管理、节点选择、开关等可视化界面，底层调用 sing-box 核心执行。
选择图形客户端时，优先关注更新频率是否跟得上核心版本、社区活跃度与文档完整度——这类周边生态项目的维护状态直接决定使用体验。
导入订阅
- 在图形客户端的订阅或配置管理页面，粘贴机场提供的订阅链接；
- 确认客户端支持该订阅格式——多数机场提供 Clash 格式订阅，需要客户端具备格式转换能力（内置或手动转换）才能被 sing-box 核心正确识别；
- 保存并触发更新，等待节点列表加载完成。
如果订阅内容无法正常解析，先确认订阅本身有效（可用其他客户端交叉验证），排查方法参考订阅链接无法更新的常见原因。
出站（outbound）选择
sing-box 的配置概念中，节点对应「出站」（outbound），多个出站可以组成选择器（selector）供图形客户端展示为可切换的节点列表。日常使用中，在图形客户端界面里选择延迟较低的出站即可，无需手动编辑 JSON 配置文件——图形客户端会代为处理底层配置生成。
sing-box 支持包括 Shadowsocks、VMess、VLESS、Trojan、Hysteria2 等在内的多种协议，各协议的原理差异可参考Shadowsocks、Trojan 和 VLESS 有什么区别。
配置 TUN 模式
sing-box 核心原生支持 TUN（虚拟网卡）方式接管系统流量，图形客户端通常会把这一功能包装为一个开关：
- 在图形客户端设置中找到 TUN 相关选项并开启；
- 首次开启可能需要管理员权限或安装系统组件，按提示完成授权；
- 开启后验证命令行工具、桌面应用等原本不遵循系统代理的流量是否已被接管。
TUN 与普通系统代理的原理差异是通用概念，各客户端实现思路一致，可参考TUN 模式和系统代理有什么区别加深理解。
该选 sing-box 还是 Clash 系客户端
- 刚接触代理工具：优先选择 Clash Verge Rev、Mihomo Party 等生态更成熟、图形客户端选择更多的方案，参考Clash Verge Rev 安装和订阅导入教程；
- 对特定协议支持有明确需求：如果你的机场只提供 sing-box 独有支持的协议或配置形式，再考虑 sing-box 生态；
- 两者可以并存：在同一台设备上安装多个客户端并不冲突，按需切换即可，但要注意同时只开启一个客户端的 TUN，避免互相冲突。
常见问题处理
- 图形客户端找不到合适的选择：社区维护的图形壳更新可能滞后，选择时优先看近期是否仍在维护；
- 配置文件报错：多为订阅格式与客户端要求不匹配，检查客户端文档中列出的支持格式；
- TUN 开启后网络异常：排查思路与其他客户端一致，确认系统权限已正确授予、无其他 VPN 或代理同时开启 TUN。
常见问题
sing-box 和 Clash 是什么关系？
两者是不同的代理核心项目，各自有生态与图形客户端。sing-box 定位是更通用的多协议核心，支持的协议范围较广；Clash 系（含 Mihomo）生态更成熟、图形客户端选择更多。日常使用体验主要取决于搭配的图形客户端而非核心本身。
桌面端可以直接下载 sing-box 用吗？
官方发布的是命令行核心与配置文件，没有独立的图形安装包。桌面端使用体验依赖第三方或社区维护的图形客户端，选择时优先看更新频率和口碑。
订阅导入失败怎么办？
先确认所用图形客户端明确支持你的订阅格式；部分机场的订阅是 Clash 格式，需要客户端内置转换或手动转换后才能被 sing-box 核心识别，具体以你使用的图形客户端说明为准。