Sing-box 使用指南：安装、配置文件结构与常见问题排查

Sing-box 是一个开源的通用代理平台，定位是用一套统一的配置格式和内核，支持 Shadowsocks、VMess、VLESS、Trojan、Hysteria2、TUIC 等几乎所有主流代理协议。它既可以作为独立命令行程序在服务器、路由器上运行，也常被其他图形客户端（包括部分 v2rayN 版本、移动端应用）内置作为底层核心。本文面向希望了解 Sing-box 配置逻辑，或需要在无图形界面环境中部署它的用户。

Sing-box 是什么，适合谁用

与 Clash 系客户端主打图形界面不同，Sing-box 官方发行版本身更偏向命令行工具与配置文件驱动，学习门槛相对更高，但换来的是更强的协议兼容性和更灵活的部署方式（例如在软路由、NAS、云服务器上长期运行）。如果你只是希望在个人电脑或手机上简单使用代理，通常不需要直接接触 Sing-box 本身，选择一款内置了 Sing-box 核心的图形客户端即可获得同样的协议支持能力，操作会简单得多。

下载与安装

Sing-box 是开源项目，代码托管在 GitHub 上，可以通过搜索项目名称找到 Releases 页面，根据操作系统与硬件架构（如 Windows amd64、macOS arm64、Linux 各类发行版）选择对应安装包下载。部分 Linux 发行版也可以通过其官方软件源或包管理器安装。下载获得可执行文件后，配合一份 JSON 格式的配置文件即可通过命令行启动核心；不熟悉命令行操作的用户，建议改为使用内置该核心的图形客户端（如支持切换核心的 v2rayN），配置流程与本文所述原理一致，但操作界面更友好。

订阅导入与节点配置

如果使用的是支持 Sing-box 核心的图形客户端，导入订阅的方式与其他客户端基本一致：

从机场服务商后台复制订阅链接。
在客户端的订阅管理界面新建订阅并粘贴链接，更新后节点自动写入配置。
选择合适节点启用代理即可。

如果是直接使用命令行版本的 Sing-box，则通常需要将订阅内容转换为 Sing-box 所要求的 JSON 格式配置文件（不少机场后台会直接提供“Sing-box格式”的订阅链接或配置文件下载入口），下载后通过命令行指定该配置文件启动核心，相对图形客户端更适合有一定技术基础的用户。

常用设置解读

配置文件结构（JSON）：Sing-box 使用 JSON 格式配置文件，主要包含 inbounds（入站，即本地监听端口与接管方式）、outbounds（出站，即代理节点列表与直连/拦截策略）、route（路由规则，决定流量走向）三大部分，逻辑上与 Clash 的 YAML 配置类似，只是语法不同。
TUN 模式：Sing-box 对 TUN 模式的实现效率较高，可在 inbounds 中配置 tun 类型入站接管全局流量，在 Windows/macOS 上运行时同样需要相应的系统权限（管理员或 root）。
规则集（Rule-Set）：支持引用远程或本地的规则集文件进行分流判断，规则集可以独立更新，无需改动主配置文件本身，适合需要频繁调整分流策略的场景。
多协议混合出站：由于协议支持全面，同一份配置文件中可以混合配置多种协议的节点，方便对比不同协议在当前网络环境下的表现。

常见故障排查

配置文件校验失败无法启动：JSON 格式对括号、逗号等符号要求严格，手动编辑后如果出现语法错误，核心会在启动时直接报错并拒绝运行，建议使用支持 JSON 校验的文本编辑器编写配置，或通过图形客户端生成后再检查。
TUN 模式启动后无法上网：除了权限不足外，也可能是路由表或 DNS 劫持相关字段配置不当，导致流量被错误地送入了没有出口的路径，需要检查 route 部分的规则是否存在遗漏或冲突。
协议节点连接超时：需要先排除节点本身是否可用，再检查配置文件中该协议所需的加密方式、传输层参数（如是否需要 TLS、是否需要特定的 SNI）是否与机场提供的信息完全一致，任何一个字段的偏差都可能导致协商失败。
命令行运行时权限不足报错：TUN 相关功能在 Linux/macOS 下通常需要 root 权限运行，Windows 下需要管理员权限，未以相应权限启动时会直接报权限错误，需要调整启动方式。
图形客户端切换到 Sing-box 核心后部分设置项消失：不同核心支持的功能集合存在差异，从 Clash 系核心切换到 Sing-box 核心时，客户端界面上一些依赖特定核心功能的选项可能不再可用，属于正常现象，并非配置错误。

Sing-box 使用指南：安装、配置文件结构与常见问题排查 ​

Sing-box 是什么，适合谁用 ​

下载与安装 ​

订阅导入与节点配置 ​

常用设置解读 ​

常见故障排查 ​

仍然存在网络连接问题？

延伸阅读 ​