参考手册 / 07 章

V2Ray 进阶配置手册

订阅管理、路由分流与解析路径,从配置条件到验证方法。

首次配置请先走快速上手教程的主线:导入订阅、选择节点、连接并验证。本页适合在基础连接已验证后按问题查阅。若尚未安装,桌面端首选 v2rayN,可从客户端下载页按系统和架构选包。涉及内核字段的示例以 Xray 为准;当客户端界面与内核配置使用不同术语时,以当前生效的配置和日志为判断依据。

01 / 订阅编目

订阅分组与服务器过滤

先区分订阅来源、节点和列表筛选

订阅是配置来源,节点是从该来源读出的一条连接记录。分组便于辨认来源,筛选则缩小当前要看的范围。两者都不等于路由:把某个节点归进工作组,并不会让办公应用自动走这个节点。客户端的节点列表也不是流量清单;一个条目出现在列表中,只能说明记录已导入,不能证明远端可达、认证通过或业务请求成功。

在 v2rayN 的订阅分组管理界面,为每个来源建立独立分组,再填写订阅地址和本地备注。备注宜写用途和来源,如「测试线路·甲组」,而不是复制远端列表标题。下次源端修改节点名称时,本地仍能按来源查找。手工录入且需要长期保留的节点,不要放进会被订阅刷新覆盖的分组;刷新之前先确认客户端如何处理同组内的手工记录。

完成首次更新后,先切到对应分组,查看其中是否有预期的协议、地区或用途标记,再选一个熟悉的节点做连接测试。已有连接时不要把「更新当前组」和「切换当前节点」当成同一个动作:不同客户端可能保留旧的活动选择,也可能在原条目失效后重新选择。更新完成后要再核对实际活动节点,尤其不能只凭高亮行或上一次测出的延迟来判断。

用窄条件建立可复核的筛选

先使用能在原始列表中逐条核对的关键词,例如来源明确约定的线路标记;等命名规律稳定后,再考虑当前版本是否支持正则或订阅导入时过滤。单纯搜索通常只改变列表显示,导入过滤却可能阻止匹配或不匹配的条目进入列表。启用后者之前,要在界面说明里确认「匹配后保留」还是「匹配后排除」,否则同一条表达式会得到完全相反的结果。

如果界面确认支持正则,而且节点名采用固定的前缀和分隔符,可以用 ^(HK|SG)- 查找以这两种前缀开头的备注。这个例子只切分字符串,不判断实际机房位置,也不会匹配括号或空格开头的记录。先拿应匹配和不应匹配的样本各试几条;若源端更新后把前缀改为全角符号,不要马上扩大到任意匹配,应先定位命名变化再调整条件。

如果目标只是排除通知条目,优先在视图里搜索出真实节点进行对照,不要见到「到期」或「流量」就批量删除。某些来源会用这些词标记真实套餐的线路,也会把说明信息写成不可用的占位节点。判断依据应是来源的命名约定和条目字段,而不是一个未经核对的词。筛选列表变短后,再检查有没有把当前使用的节点一并排除。

从空列表和重复备注定位问题

更新后分组为空,先暂时取消列表搜索或筛选,确认是界面没有显示,还是订阅没有成功导入。随后分别检查更新结果、响应能否被客户端识别,以及来源是否更换了订阅格式。若只有个别条目不见,比较该条目与同组可见记录的名称和类型;若整组不见,优先查共同条件和连接状态,不要逐条改节点参数。

重复备注也不能直接当成重复节点。不同来源可能用了同样的地区标记,地址、端口、传输或认证信息却并不相同。反过来,同一条连接也可能在两次刷新间改名。对照时查看来源分组以及连接字段,只在本地记录必要差异,不把订阅地址或完整节点配置粘贴到公开记录中。分组与服务器过滤案例补充了多来源列表的命名和维护方法。

把视图搜索、订阅导入过滤和批量删除分开试验。前者可以随时清除,后两者会改变可用记录,调整前应保留恢复途径。

02 / 流量判定

V2Ray 路由规则实战

按域名、地址和规则顺序推导结果

路由判断的是一条进入内核的连接应交给哪个出站。应用若没把流量交给客户端,路由规则就没有机会生效;应用若只提交了目标地址,内核也不一定知道它最初访问的域名。因此,写规则前要先确定流量从哪个入站进入,以及当时可用的是域名、地址、端口还是其他条件。系统代理、显式代理和 TUN 入口,在这一步观察到的输入可能不同。

Xray 依书写顺序检查路由规则,先满足的规则决定出站。例外要放在通用规则之前,否则后面的精确条件不会被执行。一个规则对象中同时写域名和端口,是要求两类条件都满足;若目的是匹配某个域名或某个独立地址段,应写成两条,而不是把两种条件塞进同一对象。对缺乏命中日志的场景,可以临时把测试规则缩小到单个目标,排除其他规则的干扰。

匹配具体主机时用 full:。例如 full:example.com 不覆盖它的子域,而 domain:example.com 同时覆盖该域和子域。地址段使用 CIDR 表示,注意区分两种地址族;只列出 IPv4 私网段不能自动覆盖 IPv6。geosite 和 geoip 是依赖数据文件的集合写法,标签存在与成员范围取决于实际加载的数据。首次测试用明示条件更容易复核,再改用集合维护大量目标。

先验证精确例外,再接入默认出站

下面是一个可并入 Xray 根配置的路由片段,要求 outbounds 中已定义 direct 和 proxy。首条规则将演示域交给直连,第二条兜住 TCP 和 UDP。替换配置前先查看原路由中是否存在必须保留的入站分流或 DNS 专用规则,不要把示例作为整份配置导入客户端。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:example.com"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "network": "tcp,udp",
        "outboundTag": "proxy"
      }
    ]
  }
}

验证时,让支持按域名提交目标的应用通过客户端入站发起请求,并对照内核访问日志中的入站和出站标签。测试一条命中精确规则的连接,再选一个自己可访问但不在规则内的域名,验证兜底。两次请求都要新建连接:浏览器复用已有连接时,即使刚保存了规则,也可能看不到一条新的路由判定。清理测试连接比反复重启整台设备更容易缩小变量。

拆分匹配失败和出站连接失败

AsIs 不为路由匹配额外解析域名,不表示后续连接不需要解析。使用 IPIfNonMatch 时,只有初次规则扫描没有命中,才会为域名解析并尝试以地址匹配;若末尾有总是命中的兜底规则,首次扫描已经结束,就不能指望触发这次补充解析。确实需要根据解析结果判定时,应重新设计规则顺序和解析策略,再观察设计是否带来了额外查询或延迟。

看不到访问记录,先排查流量有没有经过入站;有记录但出站标签不符,回头查目标形态、前序规则和当前配置;标签正确但访问失败,则检查出站连通性、上游解析及其传输条件。不要因为连接超时就给同一目标再加一条宽泛规则,这通常掩盖的是传输问题,而不是修好了匹配。需要对照更多写法时,可查阅路由语法与匹配优先级。

03 / 名称解析

V2Ray DNS 配置优化

区分系统、应用和内核的查询

系统 DNS 为调用系统解析接口的程序服务,浏览器等应用还可能有独立的加密解析设置。内核的 DNS 配置则服务于它自身发起的查询,以及被显式送入相应处理路径的流量。修改客户端的上游,并不会自动替换所有应用的解析器。排查时先确定是谁发起查询、谁返回应答、拿到地址后由谁建立连接;这三步可能不在同一个组件中。

例如系统代理模式下,一部分软件可以把域名直接交给代理,另一部分会在本地先解析。两个应用访问同一域名结果不同,并不能直接证明上游返回错误。先用系统解析工具了解系统视角,再用实际应用复现,并比较内核日志是否出现域名。若系统查询成功但实际程序失败,检查该程序是否绕开系统设置,以及能否在本地网络访问它选择的解析端点。

从单一可达上游开始对比

下例假定当前网络的可信递归解析器位于 192.168.1.1,且对本机开放常规 DNS 查询;只有满足这个条件才可原样使用,否则换为当前网络实际提供的解析地址。将 dns 对象并入支持该字段的 Xray 根配置,再确认相关的内核功能会调用它。片段不接管系统查询,也不把其他应用的查询强制转给该地址。

{
  "dns": {
    "servers": ["192.168.1.1"],
    "queryStrategy": "UseIP"
  }
}

UseIP 允许解析两种地址族。只有在确认某个地址族缺乏可用网络路径,且需要缩小故障范围时,才适合暂时用 UseIPv4 或 UseIPv6 做对照。只查询一种地址不是通用提速办法:如果目标仅有另一种地址记录,就可能变成没有可用答案。对比时把解析耗时和连接耗时分开记录;解析很快但建连拖延,未必值得继续更换上游。

配置多个解析器之前,先明确分工。内网名称通常需要能看到内部区域的解析器;公共名称可以走另一个可信上游。若在支持按域指定服务器的配置中,为内部域名设置专用上游,仍要核对匹配失败或上游超时时是否会回退。内部域名在另一台解析器上得到不存在的结论,并不等于内部服务已下线;常见原因是这次查询走错了视图。

检查加密解析的引导和缓存

加密 DNS 首先要求客户端能连接上游。使用带域名的上游地址时,建立加密连接之前可能还需解析该域名。如果这次初始解析只能依靠尚未建立的连接,就出现引导循环。检查启动阶段日志,区分地址解析超时、连接不可达和证书验证失败。用可信且独立可达的解析路径解决引导问题;不要为了消除报错,关闭正常的证书验证。

还要区分 DNS 查询的出站与被查询目标的出站:网站走某条线路,不表示用于查询网站地址的请求也走同一条线路。换上游后,先确认内核确实发起了新查询,再记录返回的地址和随后实际连接的地址。系统、应用和内核各自可能持有缓存,只清其中一层未必改变结果。若旧地址只在一个应用中出现,优先重开该应用或清理它自己的缓存,而不是同步重置所有网络设置。

优化完成应验证四类结果:已有公共域名是否可解析、预期不存在的名称是否得到正确响应、内部名称是否仍走对应的解析路径、变更后实际连接是否正常。出现时好时坏时,记录问题只出现在启动期、切换网络后还是持续发生;这样才能区分引导、缓存残留与上游本身不稳定。连接速度的分层排查提供了将解析与线路问题分开的测试顺序。

04 / 系统接管

TUN 模式与接管范围

先确认为何需要虚拟网卡

系统代理把代理地址交给愿意读取它的应用;TUN 则通过虚拟网卡,把命中系统路由的流量交给客户端处理。适合用来覆盖不读取代理设置的程序,但不是接入后自动接管所有网络流量。哪些目标经过虚拟网卡,取决于地址族、路由表、接口优先级和客户端配置。排查时首先问流量有没有进入虚拟接口,而不是直接修改内核的远端节点。

桌面可先在 v2rayN 上确认同一节点通过系统代理可用,再检查当前构建是否提供 TUN 和所需的权限。移动端可按客户端提供的系统 VPN 授权流程使用;没有出现授权提示或系统显示连接被另一服务接管时,先确认系统状态。不要把桌面上的字段名照抄到移动端,两者可能使用不同的入口实现及排除方式。

接管前后的平台检查项
平台接管前异常时优先核对
Windows确认虚拟接口建立权限和现有 VPN 状态。对照接口与目标路由,检查其他虚拟网卡是否抢占路径。
macOS确认当前客户端构建支持该模式,并完成必要授权。对照生效路由和系统中的并行连接。
Android确认系统 VPN 授权,以及应用允许或排除列表。检查目标应用是否在接管范围内,是否发生后台断开。
Linux确认客户端具有创建接口和安装路由的权限。检查策略路由、当前网络环境和客户端日志。

分阶段启用并识别自回环

第一次测试时记录当前节点、系统代理状态和本地网络的必要访问目标。若客户端允许,先关闭原先为同一测试应用设置的显式代理,避免一条请求同时受两层入口设置影响。开启 TUN 后,先试一条普通网页连接,再验证目标应用、本地设备和需要使用的数据报业务。每次新建连接,比较启停前后的记录;能访问网页只证明这条具体路径可用。

需要特别确认客户端连接远端服务器的那条底层连接不会被再次送回虚拟网卡。若它也命中自身接管路由,就可能产生循环,表现为一开 TUN 就连不上节点、日志持续重试,关掉之后恢复。此时要核对客户端是否正确排除了节点上游连接、是否选择了预期物理接口,以及切换网络后接口选择是否仍有效。不要为了排除单个上游把整个大地址段都排除。

局域网能否访问还取决于流量在哪里被分流。系统在虚拟网卡之前排除某个私网路由,与流量进入内核后命中直连出站,不是同一机制。前者不会产生相同的入站日志;后者仍要验证内核使用的解析器和出口。打印机按地址可达但按名称打不开时,先查局域网名称发现或内部解析,再判断是否需要细化接管范围。

按协议拆查,并准备可逆的恢复顺序

若只有某个应用的语音或实时业务失败,把 UDP 与普通 TCP 连接分开检查。虚拟接口接到了报文,不代表所选出站和远端链路能处理对应协议。若小请求正常、大页面或持续传输停滞,再比较不同网络下的表现,核对虚拟接口的 MTU 与实际链路是否配合。没有对照结果时,不宜同时更改 MTU、DNS 和传输参数,否则恢复后也无法定位有效变更。

回退时先停用 TUN,确认客户端已撤销自己添加的接口配置或路由,再按实际需要恢复原系统代理。接着验证本地网关、公共域名和原本可用的连接;若仍异常,先查看残留的代理、路由或 VPN 状态,不要直接清空整张系统路由表。需要从系统代理重新建立基线时,可返回连接与验证教程。

05 / 域名映射

FakeDNS 的映射与故障边界

理解合成地址为何必须回到同一处理链

在合适的接管路径中,FakeDNS 不立即把目标域名解析为服务的实际地址,而是从配置的地址池分配一个合成地址,并保存地址与域名的对应关系。应用随后向该地址发起连接。负责接管的内核须接到这条连接并查回原域名,才有条件执行域名路由和后续连接。合成地址是本地映射索引,不是远端服务的位置。

这一机制在入站主要看到目标地址、但路由仍需要域名时有价值。它不能识别应用直接写死的地址,也不能补救已绕过接管链的流量。若应用自己取得了真实地址,或本机存在另一个处理 DNS 的程序,连接就可能不带这套映射记录。先确认普通解析和 TUN 各自可用,再把 FakeDNS 当作一项独立变更引入。

收到合成地址只是验证了一半。还必须验证发往该地址的新连接被接管,且路由判断使用了正确的原域名。

把地址池与启用条件分开检查

以下片段只定义 Xray 的一个 IPv4 合成地址池,使用实验与基准测试用途地址段中的子网作为示例。实际配置前核对系统路由、虚拟网卡地址、容器网络和其他代理是否已占用这一范围。poolSize 是映射池的容量设置,不是并发连接数量;池过小、短时间访问的不同域名很多时,要考虑旧映射提前被淘汰的可能。

{
  "fakedns": [
    {
      "ipPool": "198.18.0.0/16",
      "poolSize": 4096
    }
  ]
}

仅设置地址池不会启用完整链路。若当前客户端提供整合开关,先确认它生成了相应的 DNS 接管、合成应答和入站恢复设置。手工组合时,Xray 的 DNS 服务器列表可按目标范围选用 fakedns,接收合成地址连接的入站应启用嗅探并支持从 fakedns 恢复域名;系统路由还必须把该地址池交给对应入站。根据实际实现核对每一环,避免以为一个 DNS 开关就能替代虚拟网卡路由。

有内部解析需求时,先用预期应返回实际地址的本地服务验证例外。某些内部应用会把解析结果用于地址比较、第二个连接或服务发现,收到合成地址后行为可能改变。若需要保留内网解析,既要确保内部域名查询发向正确的上游,也要核对真实私网地址生成的连接走向。只给 DNS 加例外却没检查对应流量的路由,仍可能访问失败。

按返回地址、映射恢复和连接三个环节复测

先从实际使用的应用发起查询,检查应答是否落在配置地址池。若得到真实地址,查应用私有解析、缓存及 DNS 例外;若得到合成地址但内核没有连接记录,查系统路由和接管范围;若有连接记录但找不到对应域名,关注进程是否刚重启、地址是否来自旧缓存,以及应答与流量是否经过不同实例。最后才检查目标出站和远端连接。

不要用合成地址能否响应探测报文来判断网站是否可达。应使用真实应用发起新连接,并对照该域名预期命中的路由。测试退出时先恢复正常解析,再清理仍记着合成地址的应用或系统缓存,并按客户端流程撤销接管。若先关闭虚拟网卡而应用仍继续使用旧地址,它发往该地址的连接就会短暂失败;此时反复修改节点通常没有帮助。

06 / 更新维护

多订阅管理与更新策略

给每个来源建立独立的更新边界

分组解决如何查看节点,多订阅管理解决何时刷新、刷新失败时保留什么、怎样恢复连接。把长期使用、临时试用和手工维护的配置分开,避免一次全量更新同时改变所有候选。建议在本地维护一份简短索引,记录分组名、用途、最近一次成功刷新和验证结果。公开文档只记录排查过程,不记录订阅链接、凭据信息或整组节点的导出内容。

新增第二个来源时,先在独立分组内执行一次手动更新,保留第一组的活动节点不变。检查条目是否完整后,再显式选择新组中的一个节点测试。这样可以区分「下载订阅成功」与「用其中某条配置连接成功」。若这两个动作同时进行,连接断开后很难判断是原节点被替换、刷新依赖原节点,还是新节点本身不可用。

自动刷新间隔应跟来源实际变更频率和使用情境匹配。更新过密会增加重复请求;过疏则可能错过有效参数变化。对常用组,可先观察一段时间内配置变化和失败情况,再决定是否启用自动更新。对偶尔使用的分组,连接前手动刷新更容易掌握变化。如果界面只能统一安排刷新,重要操作前要留出验证时间,而不是假定整组一定成功。

区分获取、解析和激活三类结果

第一步是获取数据。连接超时可能来自当前网络、订阅端点或代理路径;服务器返回需要登录的响应时,即使请求完成,也未必获得节点内容。第二步是客户端识别内容。订阅地址能在客户端访问,不代表响应格式能被所用客户端解析。第三步才是选中并激活节点:列表已更新仍需确认出站使用了哪一条记录,以及旧的活动连接是否被保留。

如果某个来源只有经现有连接才可获取,不要先把唯一可用的节点删掉再尝试刷新。应先保留一条已验证的恢复路径,再对该组单独刷新;依赖关系没有理清之前,不要同时更换多个来源。若更新后某条节点的备注仍相同,不能据此断定连接参数也相同。必要时在本地比较协议、地址、端口和传输设置,然后启动新连接做验证。

有多个可用节点时,不必按一次延迟测试直接重排长期使用顺序。先选同一测试目标、相近时段和相同入口,重复观察连接成功率和业务表现。探测所测到的阶段可能只是握手或一段应用往返,并不代表长传输稳定性。实际选择还应考虑业务目标和套餐条件,相关取舍见节点选择对照。

跨设备同步的是约定,不是照抄全部状态

桌面和移动端可以沿用分组命名及用途约定,但客户端对导入格式、过滤、连接入口和自动更新的支持未必一致。v2rayNG 使用 Xray 内核,v2flyNG 是使用 V2Fly 内核的备选。桌面的客户端配置文件还可能包含本地端口、路由和界面设置,不能当作跨端通用订阅。先按订阅导入教程在目标客户端验证来源,再逐项迁移需要的设置。

处理失效来源时,先停用该组的自动更新,确认工作节点已切到别组或手工保留项,再清理旧记录。若要更换订阅地址,可先在新分组验证,最后归档旧组,避免覆盖仍可用于恢复的配置。客户端支持本地备份时,应妥善限制访问权限;如果链接意外公开,应通过来源管理功能更换链接,而不是只改本地备注或删除一个设备上的记录。

07 / 连接出口

自定义出站与标签管理

先核对出站的标签、协议和参数

出站描述的是内核接到一条流量以后怎样处理它。标签是配置内部的引用名,不自带语义:写成 direct 并不会自动变成直连,具体行为由协议和设置决定。保持标签唯一、容易在日志中辨认,并与路由引用逐字一致。修改名称之前,先查有哪些规则或其他设置引用它,避免只改声明处,留下已经失效的引用。

常见的直连出站使用 freedom,拒绝类出站可使用 blackhole。代理出站则需要与现有远端服务一致的协议、认证和传输设置。若新增出口只为处理一小类流量,先保留现有主出口并加一条窄范围测试规则;不要把测试标签直接设为全量兜底。远端链路失效时,把原本应该代理的请求默默改成直连,也不是可靠的恢复方案。

用精确的拒绝规则验证标签接线

下面是可嵌入 Xray 根配置的出站和路由示例。example.com 是演示目标;该名字通过这一配置进入内核时命中拒绝,其他没有匹配规则的连接使用第一个出站,即直连。因此这段示例只适合受控测试,不应原样替换已有的代理配置。已有配置如果包含同名标签,也不要重复添加。

{
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    },
    {
      "tag": "block",
      "protocol": "blackhole",
      "settings": {}
    }
  ],
  "routing": {
    "rules": [
      {
        "type": "field",
        "domain": ["full:example.com"],
        "outboundTag": "block"
      }
    ]
  }
}

合并时,在现有的 outbounds 中增加缺少的对象,并在通用规则之前插入精确测试条件。如果已有 routing,应把规则加到已有数组,不能再放一个同名根字段。通过客户端支持的配置入口加载并核对启动日志;先验证原有的可用目标,再验证演示目标。即使页面打不开,也应确认日志显示命中了 block,否则失败可能只是地址解析或远端无响应。

拒绝示例只处理满足精确域名条件的连接,不会自动覆盖子域、直接访问目标地址的连接或已经存在的会话。它也不是对系统所有流量的限制,绕过客户端入站的流量不会受这一条规则影响。若目标应同时匹配多个名称,先列出已知范围,逐个做正例和反例,再决定是否使用更广的域名后缀规则。

检查缺省路径、生成边界和恢复条件

Xray 在路由未命中时使用列表中的第一个出站。因此,即使每条显式规则都没变,挪动出站对象顺序也可能改变未覆盖目标的去向。维护时先确定哪些连接应保持原样、哪些必须交给代理、哪些允许拒绝,再安排显式条件与缺省顺序。建议为每个重要标签留一条预期命中样本和一条不应命中样本,不用主观上「网页能开」来代替路径确认。

图形客户端可能在切换节点或重启内核时重新生成运行配置。直接修改临时文件即使当下有效,也可能在下次启动消失。需要长期保留时,使用客户端支持的自定义配置入口,确认是由客户端管理节点还是由完整配置接管运行。在切换前本地保留可用配置和测试记录;验证时分别检查首次加载、重启和切换节点后的状态,有助于发现被覆盖的设置。

只有启动失败时优先看配置能否解析、协议是否受支持和标签是否存在;已经启动但出口不合预期时,回到路由规则检查命中顺序;标签正确而目标不可达时,再查解析路径、认证和出站连接。恢复时先撤销最后一项改动,确认已有连接重新建立,然后再处理剩余变量。这样留下的每一步观察都能用于下一次变更。