sing-box 路由动作 route、reject、hijack-dns 分别做什么
sing-box 1.11 起路由规则改用 action 字段。route 把连接送到指定出站,reject 拒绝连接,hijack-dns 把 DNS 请求交给内置 DNS 模块。讲清三者区别、旧 block 和 dns 出站怎么改写。
本文目录(7 节 · 约 2 分钟) +
- 01 规则动作是怎么来的
- 02 两类动作:终结和非终结
- 03 route:把连接送到哪个出站
- 04 reject:拒绝这条连接
- 05 hijack-dns:让 sing-box 接管 DNS
- 06 旧配置改写对照
- 07 常见问题
sing-box 的每条路由规则匹配成功后,要执行一个动作。route 把连接交给你指定的出站,reject 直接拒绝这条连接,hijack-dns 把 DNS 请求交给 sing-box 自己的 DNS 模块处理。这套写法从 1.11.0 开始引入,用来取代以前的 block 和 dns 两种特殊出站。
规则动作是怎么来的
在 1.11.0 之前,规则只有一个 outbound 字段:想拦截就指向一个 block 类型的出站,想处理 DNS 就指向一个 dns 类型的出站。路由规则文档的 1.11.0 变更里新增了 action 字段,outbound 被挪进了 route 动作。
弃用列表写得很清楚:1.11.0 起旧的 block、dns 特殊出站弃用,相关旧字段在 1.13.0 已经移除。所以照着 1.11 之前的老教程写配置,放到新版本里会因为这些字段报错。
两类动作:终结和非终结
文档把动作分成两组:
| 类型 | 动作 | 含义 |
|---|---|---|
| 终结动作 | route、bypass、reject、hijack-dns | 执行后这条连接的去向就定了 |
| 非终结动作 | route-options、sniff、resolve | 只做准备或改参数,之后继续往下匹配规则 |
理解这一点很重要。sniff 放在规则列表最前面,作用是先识别协议和域名,后面的规则才能按域名或协议去匹配;它本身不决定连接去哪。
bypass 是 1.13.0 新增的终结动作,只在 Linux 开启 auto_redirect 时可用,普通桌面和手机用户可以先忽略。
route:把连接送到哪个出站
route 是默认动作。规则里不写 action 时,就当作 route 处理,它唯一的必填项是 outbound,填目标出站的 tag。
想让某些流量直连,没有单独的 direct 动作,而是用 route 指向一个 direct 类型的出站。手册里的示例就是把 ip_is_private 为真的私有地址 route 到 direct。代理流量也一样,route 到你的代理出站或分组即可。
route 还可以带 route-options 的字段,比如覆盖目标地址、端口等,这些是进阶用法。
reject:拒绝这条连接
reject 用来拦截,例如广告域名、你不想让它联网的程序。它有两个参数:
method:默认 default,TCP 回一个 RST,UDP 回 ICMP 端口不可达;设成 drop 就是直接丢包、不回任何东西。no_drop:不开启时,30 秒内触发 50 次后会临时改成 drop。
这个回复方式只对还没做过 sniff 的 tun 连接生效;非 tun 连接和已经建立的连接,会被直接关闭。
hijack-dns:让 sing-box 接管 DNS
hijack-dns 没有任何参数,作用是把 DNS 请求劫持到 sing-box 的 DNS 模块,由 dns 部分的服务器和规则来解析。
它常和 sniff 搭配。迁移文档给的新写法是两条规则:
- 第一条
{"action": "sniff"},先识别协议。 - 第二条匹配
"protocol": "dns",动作写hijack-dns。
以前的等价写法是入站开 sniff: true,再把 dns 协议的流量指向 dns 出站。开着 TUN 模式时,这两条规则决定了 DNS 会不会被 sing-box 接住。还在挑能导入 sing-box 的订阅,可以看 sing-box 机场订阅怎么选。
旧配置改写对照
| 旧写法(1.11 之前) | 新写法 |
|---|---|
block 出站 + 规则 outbound: block | 规则 action: reject |
dns 出站 + 规则 protocol: dns, outbound: dns | 先 action: sniff,再 protocol: dns, action: hijack-dns |
规则 outbound: proxy | 不变,等同 action: route, outbound: proxy |
改完重新加载配置,如果节点仍然一片超时,问题多半不在规则,按 节点 timeout 先查本机还是机场 排查。自己手写规则时,再对照这张表逐条检查。
常见问题
规则里不写 action 会怎样
会按 route 处理,route 是默认动作,这时 outbound 必须填。所以老配置里只写 outbound 的普通规则,在新版本里依然能用。
想让某个网站直连,用哪个动作
用 route,把 outbound 指向一个 direct 类型的出站。规则动作里没有名为 direct 的动作,直连是靠出站类型实现的。
sniff 和 hijack-dns 顺序能反过来吗
不建议。sniff 是非终结动作,要放在前面先识别出 DNS 协议,后面那条按 protocol: dns 匹配的 hijack-dns 规则才能命中。迁移文档的示例也是 sniff 在前。
相关文章
sing-box 苹果越狱版有什么额外功能
sing-box 的 iOS 客户端除了 App Store 版,还有一个给越狱设备用的版本。官方写明它多出两项能力:在设备上运行 Tailscale SSH 服务,以及在路由和 DNS 规则里按进程匹配。这篇讲清这两项是什么、安装包怎么区分、和常规版怎么选。
ChatGPT 机场推荐:用 AI 工具到底该选什么样的节点
AI 工具的风控比流媒体严得多,关键不在速度而在落地 IP 的类型和稳定性。本文讲清原生 IP、机房 IP、住宅 IP 的区别,为什么频繁切节点反而更容易触发风控,以及 ChatGPT 机场推荐里真正该看的指标。
Clash Meta 与 mihomo 内核管哪些事
看到 Clash Meta、mihomo、客户端和订阅这些名字,你可能想知道它们各管什么。这页按内核、界面和配置来源拆开讲,列出项目写明的协议、路由与远程列表能力,也把没有官方说明的更名历史留空。