适合已经用 v2rayN 导入订阅、开始阅读核心配置的用户。本文用一份只有本地入口和两个出站的 JSON,说明端口填在哪里、规则如何引用出站,以及未命中规则时请求会走哪条路径。示例不需要远端节点,也不应直接覆盖日常配置。
顶层结构:把一条请求从入口读到出口
读配置时先找应用实际连接的地址和端口,而不是先找订阅里的服务器地址。应用把请求交给入站后,核心才拿请求携带的目标信息匹配路由。规则选出出站,出站再决定直连目标、经远端代理转发,还是终止请求。
log是对象,用于设置日志级别等选项。它帮助定位请求走到哪一步,不参与路由选择。inbounds是数组。每个元素描述一个接收入口,包括监听地址、端口和应用需要使用的协议。outbounds是数组。每个元素定义一种出站行为;数组首项还承担未命中路由时的默认出站。routing是对象。其中的rules是有顺序的数组,通过outboundTag引用出站的tag。
最小 JSON:两个本地入口与两个出站
下面使用 V2Ray v4 风格的 JSON 字段。示例把 SOCKS 和 HTTP 入口分开,便于在应用里分别验证。端口是本文为演示选用的值,不代表 v2rayN 的默认设置;若端口已被占用,应同时修改配置和应用端填写的端口。
{
"log": { "loglevel": "warning" },
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"tag": "local-socks",
"settings": { "auth": "noauth", "udp": false }
},
{
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http",
"tag": "local-http",
"settings": {}
}
],
"outbounds": [
{ "protocol": "freedom", "tag": "direct", "settings": {} },
{ "protocol": "blackhole", "tag": "block", "settings": {} }
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["full:example.org"],
"outboundTag": "block"
}
]
}
}
这份配置只有一条规则:核心收到的目标域名恰好是 example.org 时选中 block,其余请求落到首个出站 direct。示例不包含 DNS 分流、远端节点或流量嗅探。保存为 JSON 时,不要给最后一个数组元素加尾逗号,也不要在代码中插入说明性注释。
inbounds 和 log:先确认应用接入了核心
listen 决定核心在哪个本地地址接收连接。这里使用回环地址 127.0.0.1,只供本机应用访问。不要为了排查连接失败就改成 0.0.0.0:那会扩大入口的监听范围,而示例并未配置代理认证。
- 核对入口协议。 应用选择 HTTP 代理时填
127.0.0.1:10809;选择 SOCKS5 时填127.0.0.1:10808。本地入口用 HTTP 不代表只能访问 HTTP 网页,支持 CONNECT 的应用也可经该入口访问 HTTPS 目标。示例的 SOCKS 入口关闭了 UDP。 - 核对测试应用是否遵循代理设置。 系统代理只是向遵循该设置的应用提供入口,不能保证所有流量都会进入核心。验证时优先用能单独指定代理的应用,以免把绕过代理的访问结果当成路由结果。
- 核对核心日志。
warning用于日常记录警告及更严重的问题。排查时可临时改成debug,重载后重试一次,再恢复原级别。端口绑定失败应先解决监听冲突;日志中没有请求记录也不能单凭这一点判定入站失败,要结合日志级别和应用设置。
outbounds:协议定义行为,标签供规则引用
freedom 让核心直接连接目标,仍受本机网络和解析结果影响。它不是让应用绕过本地代理:应用已经把请求交给核心,只是核心没有再把请求转交给远端代理。blackhole 则用于终止匹配的流量;应用可能看到连接关闭或请求失败,不一定会显示一个明确的拦截页面。
protocol- 决定出站实现。订阅生成的远端代理出站可能使用 VMess;远端地址和协议参数属于该出站,不是本地监听参数。协议专用的
settings不能从freedom原样搬过去。 tag- 是配置内的引用名称。
direct和block不是协议关键字。若把block改名,必须同步修改引用它的outboundTag,并保持出站标签唯一。 - 数组顺序
- 当没有规则命中时,首个出站接收请求。把
blackhole移到本例首位,会让原本应直连的未匹配请求也被终止。
routing:按顺序匹配,不按规则精确度排名
核心从上到下检查 routing.rules,使用第一条满足条件的规则。若同一条规则同时配置了 inboundTag 和 domain,两项都要匹配。比如给示例规则增加 "inboundTag": ["local-http"] 后,从 SOCKS 入口进入的相同域名就不会命中该规则。
| 核心收到的目标 | 是否命中 | 示例出站 |
|---|---|---|
example.org | 命中完整域名 | block |
www.example.org | 未命中,子域名不等于完整域名 | direct |
example.com | 未命中 | direct |
| 字面 IP 地址 | 未命中,示例不恢复目标域名 | direct |
结论:先确认核心收到的是域名还是 IP
如果用 SOCKS 测试域名规则,选择能把目标域名交给 SOCKS5 代理的客户端选项。若应用已在本地解析并只提交 IP,先修正测试入口,再调整规则。AsIs 不为路由匹配主动解析域名,也不负责从 IP 反推出原域名。
若要覆盖根域和子域,可改用 domain:example.org。如果前面已经存在一条涵盖同一目标的宽规则,例如把该域及所有子域送往直连,后面的 full:example.org 拦截规则不会得到执行。要保留这个例外,就把完整域名规则放在宽规则之前。
v2rayN 配置常见问题
为什么手改 JSON 后,切换节点就恢复了?
先确认编辑的是独立配置还是 v2rayN 生成的运行文件。对于生成的文件,切换节点或重新启动核心时可能被重建。要长期修改普通节点的路由,使用客户端的路由设置;要单独验证整份 JSON,保留独立副本并用对应核心加载。
能把这段 JSON 直接填进订阅地址吗?
不能。订阅地址用于获取节点列表,本例是供核心读取的配置对象。先核对当前节点类型和内核,再决定是在 v2rayN 中调整路由,还是独立加载配置。不要把不同内核的字段名视为可互换。
改完以后两个测试域名都打不开,先查哪里?
先检查核心是否成功加载,再用同一应用、同一代理入口测试 example.com。它应选中 direct,但仍要求本机能解析并连接目标。确认这一对照请求后,再测试 example.org;仅凭两个页面都打不开,不能证明拦截生效。