核心结论：Sing-box 的灵魂在于“解耦的管道化配置”，吃透四大顶级字段即可构建工业级网络代理拓扑
对于习惯了传统代理工具图形界面或简单 YAML 语法的用户而言，初次面对 Sing-box（星盒） 的 config.json 往往会产生一种面对纯粹代码工程的敬畏感与陌生感。然而，正是这种严格遵循工业标准的声明式 JSON 架构，赋予了 Sing-box 跨越个人设备、云端服务器与边缘软路由的超强适应力。
在 Sing-box 的配置宇宙中，没有模糊的隐式规则，所有网络行为均被抽象为互联互通的四大顶级实体管道：
inbounds（流量的入口捕获）：定义客户端如何从本地操作系统或局域网中截获原始数据包。不管是通过混合代理端口（mixed），还是通过底层虚拟网络适配器（tun），入站模块负责为每一个网络连接打上特征标签（Tag）；dns（独立而精准的域名解析中枢）：不同于其他工具将 DNS 混在路由里，Sing-box 拥有完整的独立 DNS 调度机制。它能够根据域名特征分别指定国内直连 DNS（如阿里公共 DNS）或境外加密 DoH，彻底消灭 DNS 污染；outbounds（出口节点与策略调度）：声明所有可用的物理出口与虚拟策略组。无论是直接放行（direct）、广告丢弃（block）、自动测速优选（urltest），还是搭载先进加密协议（trojan、vless、hysteria2）的节点，都在此统一注册；route（全局流量分流裁决引擎）：充当整个网络中枢的“交通交警”。通过比对目标 IP、域名、进程名与二进制规则集（SRS），将入站流量按照短路求值原则分流至对应的出站管道；- 底层物理专线是释放配置潜力的基石：配置写得再严密，若后端代理节点遭遇公网抖动与拥塞，数据依然会卡死在出站队列中。搭配全二层 IEPL 物理专线与纯正原生双 ISP 住宅 IP，才能确保复杂规则下的每个分流通道均跑满 2.5Gbps 极致吞吐。
【Sing-box config.json 四大顶级模块协同工作数据流向拓扑】
================================ config.json 全景架构 ================================
| |
| [ inbounds: 流量输入端 ] |
| * mixed (127.0.0.1:7890 端口) |
| * tun (Wintun/utun 虚拟网卡全流量接管) |
| | |
| v (截获原始未解析的数据包) |
| +----------------------------------------------------------------------------+ |
| | dns: 独立 DNS 路由引擎 | |
| | * 判定规则: 境内域名 -> direct-dns (223.5.5.5) 本地直连解析 | |
| | * 判定规则: 境外域名 -> remote-dns (https://1.1.1.1/dns-query) 经专线代理解析| |
| +----------------------------------------------------------------------------+ |
| | |
| v (获取解析后的 IP 或明文域名特征) |
| +----------------------------------------------------------------------------+ |
| | route: 路由分流裁决模块 | |
| | * 规则 1: 协议为 dns -> 出站转发至 dns-out (闭环处理) | |
| | * 规则 2: 命中广告规则集 -> 出站转发至 block (静默丢弃) | |
| | * 规则 3: 命中 geosite:cn / geoip:cn -> 出站转发至 direct (国内直连) | |
| | * 终极规则 (final) -> 出站转发至 proxy-out (默认节点代理组) | |
| +----------------------------------------------------------------------------+ |
| | |
| +--------------------------+--------------------------+ |
| | | |
| v v |
| [ outbounds: direct (国内直连) ] [ outbounds: proxy-out (专线代理) ] |
========================================== | ======================== | ==============
| |
v v
[ 百度 / 淘宝 / 微信 (0延迟直连) ] [ 光速云企业级 IEPL 专线 ]
| (丢包率 < 0.04%)
v
[ 4K YouTube / AI / 影视 ]核心机制拆解：四大核心模块语法规范与高阶参数详析
深入掌握 config.json 的编写，必须对各大模块的核心属性与参数边界有透彻理解。
1. inbounds（入站模块）高阶参数详解
在 inbounds 数组中，通常定义两种主流入站方式：
mixed入站：{ "type": "mixed", "tag": "mixed-in", "listen": "127.0.0.1", "listen_port": 7890 }tun虚拟网卡入站（推荐主力）：{ "type": "tun", "tag": "tun-in", "interface_name": "singtun", "inet4_address": "172.19.0.1/30", "auto_route": true, // 自动接管系统默认网关路由 "strict_route": true, // 严格路由保护，防止 DNS 泄漏 "stack": "gvisor", // 协议栈选型: gvisor (稳定) / system (高性能) "sniff": true // 开启域名嗅探，用于精确分流 }
2. dns（独立 DNS 模块）架构解耦逻辑
Sing-box 将 DNS 视为一等公民，采用“服务器池 + 规则链”设计：
servers（DNS 服务器定义）：声明各个上游解析器。通过detour参数，可以指定该 DNS 请求必须通过哪一个出站节点发出（例如查询境外域名时，指定detour: "proxy-out"走代理专线，彻底避开本地运营商 GFW 投毒）；rules（DNS 分流规则）：针对域名进行预分流，决定该域名应交由国内 DNS 还是境外 DoH 解析；final：未命中任何规则时的默认上游 DNS。
3. outbounds（出站模块）节点与策略组定义
outbounds 定义了流量最终流向的物理或虚拟目的地：
- 基础内置出站：
direct（直接出站）、block（静默黑洞丢弃）、dns（内部 DNS 劫持响应）； - 虚拟策略组：
selector（手动选择）：在图形界面上供用户手动指定生效节点；urltest（自动优选）：定时发送探测包，自动漂移至当前延迟最低的专线节点；
- 加密节点出站：定义具体的协议连接，包含
server、server_port、tls以及utls指纹伪装参数。
4. route（路由规则模块）短路求值流水线
route 模块负责按照由上至下的顺序执行规则扫描：
rules匹配项：支持geosite、geoip、domain、domain_suffix、ip_cidr、port、process_name等多种维度；rule_set（规则集）：支持引用本地或远程预编译好的二进制.srs规则文件；final：所有规则均未命中时的终极兜底出站（通常指向默认代理策略组）。
现代配置文件格式 10 维度横向综合对比基准大表
| 评估维度 | Sing-box 标准 JSON | Clash 经典 YAML | Xray 嵌套式 JSON | Surge 类 INI 配置 | Quantumult X 格式 |
|---|---|---|---|---|---|
| 语法严谨与排错度 | 强类型，支持 Schema 校验 | 极易因缩进/制表符崩溃 | 嵌套层级过深，语法较繁琐 | 扁平直观，易于阅读 | 专有语法，略显紧凑 |
| 独立 DNS 路由解耦 | 原生模块化解耦架构 | 依赖 Fake-IP 模式 | 基础分流，易泄漏 | 顶级企业级自研实现 | 基础分流 |
| 规则集加载速度 | 编译型二进制 SRS (极速) | 纯文本逐行解析 (较慢) | 预编译 dat 路由包 | 文本规则集 | 文本规则集 |
| 高并发内存开销 | 极致轻量 (20MB - 40MB) | 优异 (40MB - 70MB) | 良好 (50MB - 80MB) | 极佳 (极度调优) | 极佳 (极度调优) |
| 前沿协议完整度 | 全网首发全协议支持 | 紧跟前沿迭代 | 聚焦于 VLESS 体系 | 仅限商业规范协议 | 专注于经典协议 |
| 自动化生成难度 | 极易程序化生成与模板化 | 文本拼接容易格式错乱 | 程序化生成良好 | 较难自动化 | 需专有转换器 |
| TUN 模式配置度 | 极高 (gVisor/System自由选) | 一键开关，参数相对固化 | 需依赖外部辅助服务 | 顶级系统集成 | 系统级扩展 |
| 学习与上手曲线 | 较陡峭 (需理解网络层级) | 平缓 (直观易读) | 较陡峭 | 适中 | 陡峭 |
| 跨系统全场景适应 | 从工控机到数据中心通吃 | 偏向桌面端与软路由 | 偏向服务端与客户端 | 仅限 Apple 生态 | 仅限 iOS 生态 |
| 综合极客推荐度 | ⭐⭐⭐⭐⭐ (未来工业级答案) | ⭐⭐⭐⭐⭐ (桌面端体验王者) | ⭐⭐⭐⭐ (特定协议中坚) | ⭐⭐⭐⭐⭐ (果粉工程天花板) | ⭐⭐⭐⭐ (脚本党神器) |
终极落地标杆：光速云（Guangsu Cloud）与 Sing-box 生产级配置的完美融合
再规范优雅的 config.json，若填入的是频繁超时、甚至遭到 GFW 探测干扰的劣质公网节点，整套代理架构依然会频繁断流。光速云（Guangsu Cloud） 凭借高标准构建的全二层 IEPL 物理专线集群与纯正原生双 ISP 住宅出口，为 Sing-box 的标准化配置提供了坚固的硬件基石。
【光速云专线与 Sing-box 生产级配置架构映射拓扑】
[ Sing-box config.json 路由调度中枢 ]
|
+---> 命中 AI 规则 (geosite:openai) ===> [ 光速云-美西/新加坡-01-双ISP ] (原生合规，0 欺诈分)
|
+---> 命中动漫追番 (geosite:bahamut) ==> [ 光速云-台湾-01-HiNet原生 ] (动画疯/繁体片源秒开)
|
+---> 命中常规代理 (final: proxy-out) ==> [ 光速云-香港-01-IEPL ] (15ms 极限低延迟直达)
|
v (底层统一物理承载)
[ 国内核心三大运营商 Multi-BGP 入口机房 ]
| (电信/联通/移动毫秒级汇聚)
v
======================= 企业级 IEPL 物理跨国内网光缆 =======================
| |
| * 物理级点对点光纤隔离传输，不走公网 GFW 出口网关 |
| * 晚高峰丢包率恒定保持在 < 0.04%，拒绝任何拥塞排队 |
| * 2.5Gbps 满血大带宽储备，完美承接 Sing-box 零拷贝吞吐 |
| |
================================== | =====================================
v
[ 全球 50+ 节点落地机房 (纯正双 ISP 原生住宅 IP 出口) ]
* 完美突破 ChatGPT/Claude/TikTok 本土化严格风控为什么光速云专线是 Sing-box 玩家的最佳搭档？
- 协议特性全量原生满血对齐：光速云深度支持 Trojan 与 VLess 协议，完美适配 Sing-box 的 uTLS 指纹伪装与多路复用（Mux），连接建立开销降低 40%。
- 真正的全二层物理 IEPL 专线（丢包率 < 0.04%）：拒绝普通公网的晚高峰 QoS 限速与海缆丢包，数据在受保护的内网专线中穿透，全天候 24 小时延迟绝无波动。
- 纯正原生双 ISP 住宅级 IP 资源：全面覆盖美西、日本、香港、韩国与欧洲，彻底解决 OpenAI（ChatGPT）、Claude、Netflix 的 403 地区阻断与频繁人机验证。
- 2.5Gbps 满血冗余大带宽实测：拒绝超售，即使多台设备同时大文件下载，依然保持极低的排队时延。
- 极具震撼的质价比与专属读者福利：
- 年付轻量套餐：年付 ￥99，折合每月仅需 ￥7.5/月，每月独享 100GB 满血物理专线高速流量；
- 极速大流量套餐：每月仅需 ￥23/月，提供高达 148GB 满血专线流量；
- 专属读者 8 折立减码：结账时输入专属优惠码
AMM，立享全场折上 8 折优惠。
👉 立即直达光速云官方控制台（免费注册体验）
👉 深入阅读：光速云 2026 深度实测与全网节点横评报告
👉 探索光速云全系产品与多平台配置指南
生产级完整代码范本：Sing-box 全功能生产级 config.json 模板
以下是一份完整的、经过语法验证的 生产级 config.json 模板，涵盖入站、出站、独立 DNS 路由与规则集集成，可直接作为母版使用：
{
"$schema": "https://sing-box.sagernet.org/schema.json",
"log": {
"disabled": false,
"level": "warn",
"timestamp": true
},
"dns": {
"servers": [
{
"tag": "remote-dns",
"address": "https://1.1.1.1/dns-query",
"address_resolver": "direct-dns",
"strategy": "ipv4_only",
"detour": "proxy-out"
},
{
"tag": "direct-dns",
"address": "223.5.5.5",
"strategy": "ipv4_only",
"detour": "direct"
},
{
"tag": "block-dns",
"address": "rcode://success"
}
],
"rules": [
{
"outbound": "any",
"server": "direct-dns"
},
{
"rule_set": "geosite-category-ads-all",
"server": "block-dns"
},
{
"rule_set": "geosite-cn",
"server": "direct-dns"
}
],
"final": "remote-dns",
"strategy": "ipv4_only"
},
"inbounds": [
{
"type": "mixed",
"tag": "mixed-in",
"listen": "127.0.0.1",
"listen_port": 7890
},
{
"type": "tun",
"tag": "tun-in",
"interface_name": "singtun",
"inet4_address": "172.19.0.1/30",
"auto_route": true,
"strict_route": true,
"stack": "gvisor",
"sniff": true
}
],
"outbounds": [
{
"type": "selector",
"tag": "proxy-out",
"outbounds": [
"auto-best",
"光速云-香港-01-IEPL",
"光速云-日本-01-IEPL",
"光速云-美西-01-IEPL"
],
"default": "auto-best"
},
{
"type": "urltest",
"tag": "auto-best",
"outbounds": [
"光速云-香港-01-IEPL",
"光速云-日本-01-IEPL",
"光速云-美西-01-IEPL"
],
"url": "http://cp.cloudflare.com/generate_204",
"interval": "3m",
"tolerance": 20
},
{
"type": "trojan",
"tag": "光速云-香港-01-IEPL",
"server": "hk-iepl.gsy-node.net",
"server_port": 443,
"password": "AMM_SECURE_AUTH_TOKEN",
"tls": {
"enabled": true,
"server_name": "hk-iepl.gsy-node.net",
"utls": {
"enabled": true,
"fingerprint": "chrome"
}
}
},
{
"type": "direct",
"tag": "direct"
},
{
"type": "block",
"tag": "block"
},
{
"type": "dns",
"tag": "dns-out"
}
],
"route": {
"rule_set": [
{
"tag": "geosite-category-ads-all",
"type": "remote",
"format": "binary",
"url": "https://raw.githubusercontent.com/SagerNet/sing-geosite/rule-set/geosite-category-ads-all.srs",
"download_detour": "proxy-out"
},
{
"tag": "geosite-cn",
"type": "remote",
"format": "binary",
"url": "https://raw.githubusercontent.com/SagerNet/sing-geosite/rule-set/geosite-cn.srs",
"download_detour": "proxy-out"
},
{
"tag": "geoip-cn",
"type": "remote",
"format": "binary",
"url": "https://raw.githubusercontent.com/SagerNet/sing-geoip/rule-set/geoip-cn.srs",
"download_detour": "proxy-out"
}
],
"rules": [
{
"protocol": "dns",
"outbound": "dns-out"
},
{
"rule_set": "geosite-category-ads-all",
"outbound": "block"
},
{
"rule_set": "geosite-cn",
"outbound": "direct"
},
{
"rule_set": "geoip-cn",
"outbound": "direct"
}
],
"final": "proxy-out",
"auto_detect_interface": true
}
}常见 JSON 语法报错排查自愈决策树
[ Sing-box 提示配置解析报错无法启动 ]
|
v
[ 检查具体的控制台报错输出信息 ]
|
+-----------------------------+-----------------------------+
| |
v v
[ 提示 invalid character ... looking for beginning of object ] [ 提示 missing type in outbound / unknown field ]
| |
v v
[ 检查 JSON 语法基本格式 (逗号、花括号、引号) ] [ 检查字段命名是否符合 Sing-box 当前版本规范 ]
| |
+------+------+ +------+------+
| | | |
v v v v
[逗号遗漏/多余] [使用了中文引号] [旧版字段过时] [属性层级错位]
(列表末尾多了,) (使用了“”号) (如v1.8升v1.9) (把route写进dns里)
| | | |
v v v v
[使用 VS Code [全局替换为标准 [查阅官方文档 [严格按照本文
格式化插件修复] 英文半角引号] 修正新版属性] 四大顶级模块排布]矩阵深度内链与延伸研读
- Sing-box 零基础新手保姆级教程：2026 Sing-box 完整新手教程：从零开始配置跨平台现代代理中枢
- Sing-box 对比 Clash 架构横评：Sing-box 对比 Clash：架构理念、性能开销与协议生态深度横评
- 进阶二进制 SRS 规则集实战：Sing-box 进阶规则集实战：二进制 SRS 编译、Headless 规则库与动态更新
- 分流路由与独立 DNS 完全指南：Sing-box 分流路由完全指南：Geosite/Geoip、DNS 独立路由与出站分流
- 衍生客户端全景横评：2026 Sing-box 衍生客户端全景横评：GUI.for.SingBox / NekoBox / Karing
- 常见报错排障 FAQ：Sing-box 常见报错与排障 FAQ 全景速查：语法错误、TUN 启动失败与 DNS 循环
- Clash Verge Rev 核心教程：Clash Verge Rev 终极配置教程：从内核切换到扩展脚本编写