FlyClash · 独立中文下载与配置指南独立中文指南 · 原始开源来源
FlyClash 中文指南
首页 / sing-box port_range 端口范围规则:区间、边界与命中检查

sing-box port_range 端口范围规则:区间、边界与命中检查

按 sing-box 官方路由规则文档检查 port_range 的区间写法、与端口条件的组合关系和实际命中结果,改动前保留可回退配置。

FlyClash 中文指南编辑部 · 发布 2026-10-26 · 更新 2026-10-26 · 3 分钟阅读

需要按一段端口分流时,port_range 比逐个列出端口更容易维护。它匹配目标端口范围,官方示例使用 1000:2000、:3000 和 4000: 这类写法。端口规则只负责匹配条件,最终是否能连通还取决于入站、出站和上游服务,不能把“规则命中”当作连接成功。

先确认匹配对象

port_range 是目标端口条件,source_port_range 则是来源端口条件。先从日志或目标服务说明确认你要限制的是哪一个。端口范围还会和域名、IP、网络类型等条件一起参与匹配;官方文档说明,默认规则会把域名条件、端口或端口范围以及其他条件按逻辑组合,而不是看到其中一项就直接放行。

不要把应用界面显示的服务名称当成端口,也不要把一个范围写成逗号分隔的字符串。区间两端的含义应以当前文档和配置解析结果为准,迁移旧配置时先用最小范围做验证。

用窄范围做一次对照

  1. 复制当前配置并记录核心版本、目标地址、目标端口和预期出站。
  2. 只在原有目标条件上增加一个窄的 port_range,例如官方示例中的 1000:2000;示例用于说明格式,实际范围必须来自你的服务需求。
  3. 运行现有配置检查命令,确认 JSON 类型为数组且范围字符串没有被转义或截断。
  4. 新建一条能明确区分端口的请求,观察日志中命中的规则和出站标签;旧连接可能复用已有会话,不能作为新规则的证据。
  5. 再测试范围外的端口,确认它仍按原规则处理。若两类请求都命中同一条,回到规则顺序和更早的宽泛条件检查。

如果配置无法解析,先恢复备份再修正格式;如果规则命中但请求失败,继续检查出站能力、认证和远端服务。回滚时删除新增条件并重新加载原文件,确认范围外请求恢复原结果。

继续排查路由链

想按 TCP、UDP 区分时,可参考 sing-box network 规则。需要确认域名规则使用哪个解析器时,查看 route domain_resolver 检查。这两层与端口匹配相互独立,排查时应逐层记录观察结果。

官方来源

sing-box Route Rule 官方文档

来源核验日期:2026-10-26。本文只采用官方文档明确说明的范围语法和匹配关系,不提供特定服务的端口结论。