NekoBox · Android 中文资料站独立中文指南 · 原始开源来源
NekoBox 中文指南
首页 / Xray-core port 路由:目标端口、来源端口与范围写法

Xray-core port 路由:目标端口、来源端口与范围写法

根据 Xray-core 官方路由文档核对 port、sourcePort、localPort,说明闭合端口区间、组合条件和规则顺序,给出命中验证与配置回退流程。

NekoBox 中文指南编辑部 · 发布日期: · 更新日期: · 5 分钟阅读

Xray-core 按端口分流不生效时,先确认写的是目标端口、来源端口,还是本地入站端口。官方路由文档分别用 port、sourcePort 和 localPort 表示这三种条件。把网站服务端口写到 sourcePort,可能导致规则始终不命中;改动前应记录请求实际使用的端口和入站标签。

三个字段各看哪个位置

port 匹配目标端口,例如应用要连接的 HTTPS 服务端口。sourcePort 匹配连接来源端口;它通常不能代替目标服务端口。localPort 匹配本地入站使用的端口,官方特别提到入站监听一个端口范围时的用途。三个位置即使偶尔出现相同数字,也仍是不同条件。

端口支持单个正整数、以连字符连接的闭合区间,以及逗号分隔的组合;取值须小于 65536。例如 "443,8000-8100" 表示 443,加上包含 8000 和 8100 在内的区间。它不是从 443 一直匹配到 8100,也不是给核心新增监听端口。

下面是加入已有路由规则的目标端口属性片段。保留该规则原有的入站限制和有效出站标签;这不是可独立使用的完整规则:

{
  "port": "443,8000-8100"
}

如果需求只是匹配目标服务,不必同时增加 sourcePort 和 localPort。附加条件越多,越需要确认每个条件都满足;不要为了让配置看起来完整而把三个字段填成同一个值。

组合条件为什么容易漏匹配

官方说明,同一条规则指定多个属性时,这些属性必须同时满足。例如规则已有 inboundTag 与 network,增加端口后,请求还要来自指定入站、使用指定网络,并落在目标端口范围内,才会命中。TCP 的 443 与 UDP 的 443 不能仅凭端口号相同就当成同一条测试连接。

同样,协议字段与传输层网络字段也不是一回事。网页显示 HTTPS,并不足以说明当前连接一定是 TCP。先看实际连接记录,再检查 network,不要凭应用名称猜测连接方式。

从一条明确请求开始验证

  1. 备份当前配置,记录规则所在位置、出站标签与运行核心版本。
  2. 选一条已知入站、目标地址和目标端口的测试连接,先用原配置保存访问结果。
  3. 仅修改目标端口条件,保留其余规则,执行核心配置校验后重载。
  4. 新建连接,核对访问日志与实际出站;不要复用修改前已经建立的长连接。
  5. 再测一个范围外端口,以及范围两端的请求。目标服务必须确实在相应端口提供服务,否则连接失败无法单独证明规则问题。

没有测试服务器时,可以从现有正常业务的端口着手,不必随意开启本地监听或扩大入站访问范围。端口条件只决定路由匹配,不会自动配置目标防火墙,也不保证出站协议支持对应流量。

未命中时按顺序缩小范围

先查看前面是否已有较宽的规则处理了请求,再确认请求实际进入的入站标签。随后比较目标端口、来源端口和本地端口,排除记错位置。最后检查组合条件是否太严,以及使用的出站标签是否真实存在。

如需暂时去掉端口条件作对照,只在原本就有限定目标或入站的规则上操作,避免把范围意外扩大到全局。若改动导致其他请求出站异常,恢复备份中的完整规则及位置,校验重载后复测正常业务。

基础规则顺序可参考 Xray-core 路由规则检查;修改前的语法检查见 Xray-core 配置校验。核心来源见 Xray-core 独立页面。

官方来源

来源核验日期:2026-10-21。示例只解释字段格式,不代表已在读者业务上完成连接测试。