跳到主内容
机场YYDS
✦ 专栏深度解析 概念科普 文 / jichangyyds

sing-box 路由动作 route、reject、hijack-dns 分别做什么

sing-box 1.11 起路由规则改用 action 字段。route 把连接送到指定出站,reject 拒绝连接,hijack-dns 把 DNS 请求交给内置 DNS 模块。讲清三者区别、旧 block 和 dns 出站怎么改写。

发布:2026 年 11 月 13 日 ⏱ 约 2 分钟读完
本文目录(7 节 · 约 2 分钟) +
  1. 01 规则动作是怎么来的
  2. 02 两类动作:终结和非终结
  3. 03 route:把连接送到哪个出站
  4. 04 reject:拒绝这条连接
  5. 05 hijack-dns:让 sing-box 接管 DNS
  6. 06 旧配置改写对照
  7. 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 搭配。迁移文档给的新写法是两条规则:

  1. 第一条 {"action": "sniff"},先识别协议。
  2. 第二条匹配 "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 在前。

相关文章

📣 你也在运营网站、频道或自媒体?

我们开放内容创作者长期合作,提供专属推广链接、独立业绩统计与推广素材支持。

还没想好买哪家?先看排行榜再看避坑名单

先用榜单把候选缩到 2–3 家,再去避坑名单确认没踩雷,最后用优惠码下单月付试一个晚高峰。这个顺序能帮你省掉大部分冤枉钱。