sing-box 全平台通用订阅转换与规则配置指南

sing-box 是近年来备受瞩目的下一代通用网络代理框架。它由 Go 语言编写，主打极致性能、低内存占用以及对最新代理协议（如 VLESS REALITY、TUIC v5、Hysteria2）的原生支持。

sing-box 是什么与优势

sing-box 既是一个代理核心（Executable Core），也拥有覆盖 iOS、Android、Windows、macOS 和 Linux 的官方客户端。

核心优势

1. 高性能与低延迟：优化了网络栈与路由匹配树，在大流量吞吐和多规则匹配时 CPU 占用更低。
2. 新协议支持快：对 REALITY、Hysteria2、TUIC 等新兴抗封锁与高吞吐协议支持非常迅速。
3. 架构模块化：采用结构清晰的 JSON 配置文件，解耦入站（Inbound）、出站（Outbound）与路由（Route）。

sing-box 配置文件的四大基本模块

sing-box 的核心 JSON 配置文件主要由以下四个模块构成：

订阅转换概念与操作流程

由于目前许多代理服务商原生仅提供 Clash 或 V2Ray 格式的订阅，因此使用 sing-box 时常需要进行订阅格式转换。

订阅转换逻辑

1. 在线/本地转换：使用第三方的开源订阅转换工具（如 Subconverter）将 Clash / V2Ray 订阅链接转换为 sing-box 兼容的 JSON 配置结构。
2. 客户端内置转换：许多第三方 sing-box 图形客户端（如 GUI.for.sing-box、Sing-Box GUI 等）已内置自动转换引擎，粘贴 Clash 订阅网址即可自动完成解析。

注意：请选择信誉良好的知名开源转换工具，切勿在未经确认的公共未知转换节点提交包含个人敏感信息的订阅。

客户端与核心的区别

在使用 sing-box 时，需要明确“核心”与“客户端”的区别：

• sing-box 核心 (Core)：命令行可执行程序，适合运行在路由器（OpenWrt）、Linux 服务器或高级用户手动运行。
• sing-box 客户端 (GUI App)：带图形界面的应用程序，内部封装了核心，并提供直观的开关、节点选择列表和系统代理集成。

常见错误与排查

1. JSON 语法解析报错 (JSON parse error)

sing-box 对 JSON 格式语法非常严格。多花一个逗号或缺失括号均会导致报错。修改配置时建议使用带有 JSON 校验功能的编辑器（如 VS Code）。

2. 规则文件缺少 (geosite / geoip not found)

sing-box 依赖规则数据库文件。若客户端未自动下载 geosite.db 或 geoip.db，会导致路由匹配失效。请确保客户端中包含了规则库更新机制。

FAQ

Q: sing-box 能完全替代 Clash 吗？
A: 在协议支持和底层性能上，sing-box 表现非常出色；但在图形界面生态的丰富程度上，Clash 社区积累的工具链依然十分庞大。用户可根据实际需求选择。

声明：软件版本、操作系统和界面可能更新，实际设置请以对应项目官方说明和当前版本为准。