百科

sing-box：开源代理内核百科

翻墙应用商店 · 2026-11-13 · 更新于 2026-11-14

开源内核GPL-3.0

条目导读

sing-box 是 SagerNet 独立实现的通用代理平台：同一份 JSON 配置可以组织入站、出站、DNS、规则路由、TUN 与 Endpoint。它适合需要在多种协议之间组合规则、统一透明接管和跨平台交付的场景；核心版本、官方客户端与第三方封装仍是不同发布物。

阅读路径：按“概览 → 核心能力/技术贡献 → 时间线或版本 → 生态与来源”阅读；事实、版本与判断均以正文标注的公开来源为准。

01 · 词条概览

名称：sing-box
公开别名：SagerNet sing-box
许可证：GPL-3.0
官方仓库：https://github.com/SagerNet/sing-box
文档：官方文档
最近核验版本：v1.14.4（2026-10-24，发行说明）

sing-box 是 SagerNet 独立实现的通用代理平台：同一份 JSON 配置可以组织入站、出站、DNS、规则路由、TUN 与 Endpoint。它适合需要在多种协议之间组合规则、统一透明接管和跨平台交付的场景；核心版本、官方客户端与第三方封装仍是不同发布物。

02 · 核心架构与能力

入站、出站与路由是同一套配置对象

sing-box 将 HTTP、SOCKS、Mixed、TUN 等入站与 VLESS、VMess、Trojan、Shadowsocks、Hysteria 2、TUIC、WireGuard 等出站分别定义，再由 route.rules 按域名、IP、端口、进程或规则集把连接交给指定出站。一个入站不等于一个固定节点：规则先决定连接使用哪个出站，selector 或 urltest 再在策略组中完成人工选择或延迟测试。

来源：https://github.com/SagerNet/sing-box/blob/c005f35300ce76427dc285481ec5695f5b179cd2/docs/configuration/index.md

Rule Set 把规则内容与运行配置分开

route.rule_set 可以引用远程或本地的二进制 .srs、JSON 或源文件规则集，规则动作再把命中结果交给出站、DNS 或拒绝动作。这样，订阅节点、域名分类和本地策略可以分别更新；规则集格式、下载缓存与更新策略需要按固定版本的 Rule Set 文档配置，不能把某个客户端支持的订阅格式当成核心本身的能力。

来源：https://github.com/SagerNet/sing-box/blob/c005f35300ce76427dc285481ec5695f5b179cd2/docs/configuration/rule-set/index.md

DNS 查询也参与路由

DNS 配置包含 server、独立的 DNS rule 与 fakeip server。DNS 规则可以按域名、查询类型或来源选择上游；fake-ip 为域名分配虚拟地址并保留映射，透明接管的连接随后可以恢复域名再匹配路由。DNS 的上游连接、业务连接和节点域名解析是三个需要分别核对的路径，不能只看到“支持 DoH”就断定所有查询都走同一出口。

来源：https://github.com/SagerNet/sing-box/blob/c005f35300ce76427dc285481ec5695f5b179cd2/docs/configuration/dns/index.md

TUN 与 Endpoint 改变接管边界

TUN 入站把系统 IP 流量交给路由器，auto_route、strict_route、route_address_set 和 route_exclude_address_set 会影响系统路由与绕过范围；WireGuard、Tailscale 等 Endpoint 则是独立的底层网络接口，不等同于普通代理出站。运行权限、平台网络扩展和客户端是否暴露这些选项由集成方决定。

来源：https://github.com/SagerNet/sing-box/blob/c005f35300ce76427dc285481ec5695f5b179cd2/docs/configuration/inbound/tun.md