拿到客户端生成的 JSON,先认清哪一段接收请求、哪一段选择路径、哪一段建立连接。本文用本机 SOCKS 和 HTTP 入站演示标签如何串起规则,再区分路由阶段解析、出站解析与应用自行解析。示例端口仅用于说明,不是客户端默认值。
log:日志与配置骨架
顶层是一个 JSON 对象。log、routing、dns 在本文用法中都是对象;inbounds 和 outbounds 是数组,即使只有一项也保留方括号。顶层键的书写顺序不决定请求路径,但数组内的顺序可能有意义:规则按排列顺序匹配,没有命中规则时通常交给第一个出站。
{
"log": {
"loglevel": "warning"
}
}
这只是日志片段。排错时可临时把 loglevel 改为 info,重载配置后用同一个应用复现一次;记录足够后恢复 warning。access 和 error 可指定对应日志的输出文件,但配置能被读取不意味着日志目录可写。若故障发生在启动阶段,先看客户端或启动进程提示,不要只等访问日志出现。分享日志前,遮盖订阅地址、认证字段和不宜公开的连接记录。
inbounds:监听地址、本地端口与标签
入站的 listen 和 port 指定监听地址与端口,protocol 决定应用必须使用哪种代理协议,settings 则由该协议解释。把应用的 HTTP 代理填到 SOCKS 端口,即使端口正在监听,也不能完成预期的协议握手。下面两项都只监听本机回环地址,不向局域网开放。
SOCKS 入站
- listen
127.0.0.1- port
10808- protocol
socks- tag
local-socks
在应用的 SOCKS 代理设置中填写此端口。
HTTP 入站
- listen
127.0.0.1- port
10809- protocol
http- tag
local-http
在应用的 HTTP 代理设置中填写此端口。
先核对监听,再改路由
如果连接本机端口时就被拒绝,先确认内核已启动、端口未被其他进程占用,且应用填写的地址与实际监听地址一致。请求还没进内核,调高路由规则优先级也不会生效。
outbounds:出站协议与默认路径
出站的 protocol 决定如何处理已经接收的目标连接。freedom 用于直连,blackhole 用于阻断。tag 是配置内的引用名,不是协议名:把标签叫作 direct 不会自动开启直连,真正决定行为的是同一项里的 protocol。
{
"outbounds": [
{"tag": "direct", "protocol": "freedom", "settings": {}},
{"tag": "blocked", "protocol": "blackhole", "settings": {}}
]
}
- 这组出站用于验证直连与阻断,不需要远端账号。试验前确认允许默认直连,因为这里把
direct放在第一位。 - 配置 VMess 等远端出站时,服务端地址、远端端口和用户参数属于出站协议设置;它们不是应用代理设置中填写的本机地址和端口。传输方式及适用的安全配置还需与服务端一致。
- 订阅链接是客户端获取配置数据的入口,不是核心出站的服务端地址。订阅更新或切换节点后,客户端可能重新生成运行配置;临时改动生成文件不一定会保留。
routing:标签关联与匹配顺序
routing.rules 自上而下检查,第一条命中的规则决定去向。规则中的 inboundTag 是入站标签数组,outboundTag 是一个出站标签字符串。不同匹配字段同时出现时,请求必须同时满足这些字段。下面第一条只阻断从 SOCKS 入站进入、且目标域名恰为 example.org 的请求;第二条让其余 SOCKS 请求直连。
{
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-socks"],
"domain": ["full:example.org"],
"outboundTag": "blocked"
},
{
"type": "field",
"inboundTag": ["local-socks"],
"outboundTag": "direct"
}
]
}
}
| 进入方式 | 内核取得的目标 | 预期出站 |
|---|---|---|
| SOCKS | example.org | 第一条:blocked |
| SOCKS | www.example.org | 第二条:direct |
| HTTP | example.org | 无匹配:第一个出站 direct |
如果交换两条规则,旧的第二条会先接住全部 SOCKS 请求,精确域名规则就没有机会命中。若交换两个出站而保留规则顺序,已明确指定标签的请求仍走原路径,但没有匹配规则的 HTTP 请求会改走新的第一个出站。排查误分流时,分别检查这两处数组顺序,不要把默认出站误认为最后一条路由规则。
dns:区分路由解析与应用解析
顶层 dns 配置的是核心内置 DNS,不是操作系统的全局 DNS 设置。仅添加 dns.servers,不会自动接管所有应用的查询。应用若先解析域名,再只把目标 IP 交给代理,路由就不能仅凭这个 IP 还原原始域名;没有其他域名信息时,上面的精确域名条件不会命中。
{
"dns": {
"servers": ["localhost"]
}
}
这里用 localhost 调用本机解析能力,便于沿用系统已有的解析配置。它不表示在本机端口启动 DNS 服务,也不决定最终连接走哪个出站。若要核对域名规则,先确认测试请求是把域名交给入站,还是在应用侧已经换成了 IP。
AsIs:路由阶段不为了匹配规则主动解析域名。已有的 IP 目标仍可匹配 IP 规则。IPIfNonMatch:域名目标在首轮未命中时,可解析后再尝试 IP 匹配。若前面的宽规则已经命中,不会因后面还有 IP 规则而再解析一次。IPOnDemand:匹配过程遇到需要 IP 的规则时,可按需解析域名。调整策略前,先确认规则确实要比较目标地址,而不是只比较入站标签。
配置排错:按启动、入站、路由、出站检查
- 先查实际加载的文件。 严格 JSON 使用双引号,最后一项不带尾逗号。上面的代码块分别展示不同顶层字段,不能直接拼接多个根对象。报错若指向某个字段,即使文件是合法 JSON,也仍要检查该字段的类型与核心支持情况。
- 确认核心与客户端设置的边界。 v2rayN 桌面端可从「设置」→「参数设置」核对本地监听配置,具体分组以当前版本为准。安卓 v2rayNG 使用 Xray 内核,v2flyNG 使用 V2Fly 内核;基础字段相似不代表扩展字段通用。安卓通过 VPN 接管流量的范围也不能用桌面系统代理设置来推断。
- 让同一个测试应用只改一项。 先通过正确的端口验证普通请求,再验证阻断目标。若应用切换到 HTTP 代理后结果不同,先对照入站标签;若同一入站下域名与 IP 请求结果不同,再检查应用把哪种目标形式交给了核心。
- 最后检查出站连接。 命中预期标签只说明选对路径,不代表目标一定可达。直连失败时检查本机解析和目标可达性;远端出站失败时,再核对远端端口、协议参数和传输设置。一次只修改一处,重载后重复同一测试,才能定位是哪项变化影响了结果。