需要按一段端口分流时,port_range 比逐个列出端口更容易维护。它匹配目标端口范围,官方示例使用 1000:2000、:3000 和 4000: 这类写法。端口规则只负责匹配条件,最终是否能连通还取决于入站、出站和上游服务,不能把“规则命中”当作连接成功。
先确认匹配对象
port_range 是目标端口条件,source_port_range 则是来源端口条件。先从日志或目标服务说明确认你要限制的是哪一个。端口范围还会和域名、IP、网络类型等条件一起参与匹配;官方文档说明,默认规则会把域名条件、端口或端口范围以及其他条件按逻辑组合,而不是看到其中一项就直接放行。
不要把应用界面显示的服务名称当成端口,也不要把一个范围写成逗号分隔的字符串。区间两端的含义应以当前文档和配置解析结果为准,迁移旧配置时先用最小范围做验证。
用窄范围做一次对照
- 复制当前配置并记录核心版本、目标地址、目标端口和预期出站。
- 只在原有目标条件上增加一个窄的
port_range,例如官方示例中的1000:2000;示例用于说明格式,实际范围必须来自你的服务需求。 - 运行现有配置检查命令,确认 JSON 类型为数组且范围字符串没有被转义或截断。
- 新建一条能明确区分端口的请求,观察日志中命中的规则和出站标签;旧连接可能复用已有会话,不能作为新规则的证据。
- 再测试范围外的端口,确认它仍按原规则处理。若两类请求都命中同一条,回到规则顺序和更早的宽泛条件检查。
如果配置无法解析,先恢复备份再修正格式;如果规则命中但请求失败,继续检查出站能力、认证和远端服务。回滚时删除新增条件并重新加载原文件,确认范围外请求恢复原结果。
继续排查路由链
想按 TCP、UDP 区分时,可参考 sing-box network 规则。需要确认域名规则使用哪个解析器时,查看 route domain_resolver 检查。这两层与端口匹配相互独立,排查时应逐层记录观察结果。
官方来源
来源核验日期:2026-10-26。本文只采用官方文档明确说明的范围语法和匹配关系,不提供特定服务的端口结论。