进阶手册 · 配置与排查

V2Ray 进阶配置手册

从订阅管理到流量接管,按章节定位设置、验证结果,再决定是否保留改动。

第一次安装或还没完成连接,请先走快速上手教程,把导入、连接和验证跑通。本页是系统查阅手册,不要求按顺序启用功能。桌面端以 v2rayN 为首选,安卓端以 v2rayNG 为主,v2flyNG 可作为使用 V2Fly 内核的备选。安装包按系统和芯片类型从客户端页面选择。

订阅分组与服务器过滤

先确认服务器属于哪个分组

订阅是一个定期获取服务器配置的来源,分组是客户端用于组织这些配置的列表视图。v2rayN 打开「订阅分组 → 订阅分组设置」,先核对别名和订阅地址,再回主界面切到对应分组。v2rayNG 从侧栏进入「订阅分组设置」,添加或编辑条目,返回列表后再使用「更新订阅」。不同界面可能把更新入口放在溢出菜单,或区分当前分组与全部分组;执行前读一遍命令名称,不要仅凭当前屏幕显示了一个分组,就假定更新范围也只有这个分组。

分组不是出站,也不是自动切换策略。选中一个分组只是改变列表范围,正在运行的配置可能仍来自另一个分组。更新之后,先找出原来使用的服务器,再检查地址、协议和传输参数有没有变化。若原条目已被替换,重新选中适合的条目并按客户端要求应用或重连,然后验证实际请求。列表上的高亮、服务运行图标和日志中的出站标签分别说明不同的事,不能只看其中一个就断定切换成功。

区分列表搜索和导入过滤

搜索适合临时找服务器:输入短关键词,选中目标后清空搜索框,其他条目就会重新显示。导入过滤作用在更新流程上,可能决定哪些条目被保留。排查条目缺失时,先切到全部视图并清空搜索条件,再检查该订阅是不是配置了过滤。如果不确定旧版与新版界面的过滤行为是否一致,不要拿正在使用的主分组直接试;优先使用临时分组和少量可辨认的测试条目。

只有在设置项明确支持正则表达式时,才使用下面的写法。这个示例匹配以 办公- 或 测试- 开头的名称,首尾约束只在需要时加。若字段说明针对的是地址或整条配置,而不是备注,匹配结果就会不同。还要看字段表示「仅保留匹配」还是「排除匹配」:规则语法一样,导入结果可能正好相反。如果界面没有说明匹配字段或方向,先用一个能确定命中的短词做对照,不要预设它与列表搜索共用同一种语法。

^(办公|测试)-

过滤最好基于稳定前缀,而不是宣传文字或服务商临时附加的状态。括号、方括号和竖线在正则里有语法含义;如果只是想找带括号的备注,先用普通搜索核对,再按该字段支持的语法转义。修改规则后,同时验证三类条目:应留下的、应排除的、名称相似但不应受影响的。只检查能否找到一个目标,容易漏掉误收或误删。

更新后为空时的排查顺序

先判断更新是否成功,再判断数据是否被过滤。地址请求失败时,可能仍显示上一次的列表,也可能出现空结果,具体取决于客户端处理方式。检查错误提示属于连接超时、权限拒绝还是内容解析失败;如果返回的是登录页或其他文本,增加过滤条件解决不了问题。地址本身可能携带访问凭据,保存或分享日志时不要贴出完整链接。

如果提示更新成功却没有条目,先保存过滤文本,只在测试组临时清除过滤并再次更新。恢复条目说明来源可用,接下来应逐条缩小匹配范围;仍无结果则核对订阅返回格式与客户端支持范围。单个服务器可以导入,并不意味着包含该服务器的订阅容器也能解析。把「地址能访问」「内容能解析」「条目能启动」分成三项检查,能避免把更新故障误当成服务器质量问题。

路由规则实战

从一条明确的规则开始

路由决定进入内核的连接交给哪个出站。桌面端 v2rayN 从「设置 → 路由设置」检查当前启用的路由方案;v2rayNG 从「设置 → 路由设置」核对预定义规则或可用的自定义入口。看到规则已编辑不等于新方案已生效,保存后还要检查活动方案,并在界面要求时重启服务。有些界面按类别生成规则,有些允许逐条编辑;原始规则的顺序能否按预期保留,以实际运行配置为准。

按通常的内核匹配方式,规则从上到下检查,先匹配到的规则决定走向。具体例外放在宽泛规则之前。比如要让 example.org 及其子域直连,可以把下面的规则加入已有的原始内核配置。例子同时把私网地址交给直连出站,前提是出站中确实存在 direct 标签。此处给的是 routing 对象及其外层键,不是可单独启动的完整配置,也不是所有客户端规则编辑框都能接受的粘贴格式。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["domain:example.org"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

domain: 按域名边界匹配,适合涵盖主域及子域;full: 只匹配写出的完整域名,适合单个服务。示例中的 geoip:private 依赖运行环境提供相应规则数据。规则数据缺失时,可能在启动阶段就出错;若只是验证一台授权测试设备,可改成该设备所在的明确地址段。没有命中任何规则时,不应假定会自动直连:原始内核配置通常使用首个出站作为默认出站,图形客户端也可能另外生成兜底规则。

辨别域名目标和地址目标

同一个站点既可由客户端把域名交给代理,也可先在应用侧解析成地址再发起连接。如果内核只收到地址,就没有原始域名可供普通域名规则匹配。此时查入站传入的目标及可用的嗅探信息,而不是反复改域名拼写。嗅探是否有效取决于入站设置、协议和连接内容,不要把它当成恢复所有原始域名的机制。验证时分别访问域名和一个已知直连的地址,更容易分开这个问题。

AsIs 不为路由判断主动把域名转换为地址。若确实需要在域名规则未匹配时,再根据解析出的地址尝试 IP 规则,可评估 IPIfNonMatch;若规则判断开始前就需要解析域名,再了解 IPOnDemand 的匹配行为。后两类策略会把解析结果和耗时引入路由流程,不能当成通用的提速选项。先用 AsIs 验证域名条件,再决定是否加入地址判断。

用对照请求验证命中顺序

准备一个应直连的目标、一个应走默认出站的目标,再准备一个边界相近但不应命中的域名。保持同一服务器、同一网络、同一接管模式,只改一条规则。关闭旧连接或重新启动测试应用后发起新请求,在可用的连接日志中对照目标和出站标签。旧连接继续沿用原来的路径很常见,刷新页面也不一定会重建连接。

若两类请求都落在同一出站,先查更靠前的宽泛规则,再查标签、活动方案和实际入站。某些客户端界面提供域名列表和地址列表,却未必把它们生成一条同时满足的规则;在原始配置中,一条 field 规则里的多类条件通常要同时满足。要实现「域名匹配或地址匹配」,像示例一样拆成两条规则更清楚。运行状态正常但网页不通时,可结合已连接却打不开网页的排查清单,从入站到解析逐环检查。

DNS 配置优化

先确定谁发起了解析

DNS 调整容易在错误的层上生效。操作系统有自己的解析路径,浏览器可能使用独立的安全 DNS,内核又可以维护自己的 DNS 配置。v2rayNG 的「设置」中若有「本地 DNS」,应先核对开关状态和当前网络模式;开启此项不意味着每个应用的独立解析都会交给内核。v2rayN 则从「设置」中核对当前的 DNS 配置入口,以及它究竟服务于普通内核配置还是 TUN 所使用的网络配置。

系统代理下,浏览器可能把带域名的请求直接交给代理;终端里的系统查询命令却仍通过操作系统的解析路径。反过来,应用也可能先取得目标地址,再将请求交给代理。因此,命令行解析成功只能证明那条查询路径工作,无法证明客户端内置 DNS 或浏览器独立 DNS 都正常。测试时写下发起请求的应用、接管模式、目标及观察的日志,避免把几种结果放在一起比较。

解析器先选可达,再决定是否分组

办公网络常用内部解析器回答内部域名,公共递归服务未必知道这些记录。先保留能够回答内网域名的路径,再考虑公共域名要不要用单独的解析器。下面是原始内核配置中一个最小的 dns 片段,仅用于验证公共域名的解析路径。它不会自动改写操作系统的 DNS,也不会自动拦截应用发出的查询。示例使用的递归服务应先确认可达,并符合当前网络的使用要求;在受管环境中优先采用管理员提供的地址。

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

UseIP 不把解析结果限制在单一地址族。若现场证据显示某个地址族有路由故障,可以在支持相应取值的内核上暂时以 UseIPv4 或 UseIPv6 做对照,测试完恢复。限制 DNS 返回的地址族不等于关闭整个系统的另一地址族,也不会修复已经写死在应用配置中的目标地址。双栈环境里网页偶尔慢,更应分别看查询耗时、首次连接耗时和失败后的重试。

加密 DNS 可以保护到解析服务这一段的查询传输,但它仍需要一条可用的连接路径。如果解析器写的是主机名,就要考虑解析这个主机名依赖谁;如果前往解析器的连接又依赖正在初始化的代理,则可能形成循环。排查时先用一条已知可达且符合网络要求的解析路径建立基线,再增加加密传输或按域名分组。每增加一层,都要重新验证内网和公网两类目标。

区分缓存、应答与连接失败

在使用系统解析的测试中,可先查域名是否返回预期类型的记录,再用同一个应用访问相应服务。旧应答可能留在浏览器、系统或内核缓存里;重启其中一个并不能清空其他两层。用另一个已知应由同一解析器回答的测试域名,可以帮助判断是不是缓存造成的表象。若解析结果正常但访问失败,继续查路由、目标端口和实际出站,不要仅因为报错涉及域名就继续更换 DNS。

看错误时区分三种情况:查询超时表示未及时取得应答;域名不存在表示解析器返回了明确结果,但结果未必来自正确的视图;能得到地址却连不上,则要检查地址所属网络和连接路径。如果只有公司内部域名出问题,先检查是否把内部查询送给了公共递归服务,而不是让所有流量都走同一个解析出口。浏览器启用了独立解析时,要保留原设置记录,再按组织策略做可恢复的对照。

TUN 模式

选择系统代理还是 TUN

系统代理主要告诉愿意遵循系统设置的应用去哪里提交请求,通常不必修改整台设备的流量路由。TUN 则使用虚拟网络接口接收由系统路由送来的 IP 数据包,再由客户端处理连接。只给浏览器或支持代理的桌面工具使用时,先用系统代理;某个应用明确不读取系统代理,且运行环境允许建立虚拟接口时,再评估 TUN。接管范围更大,并不代表所有流量类型或连接方式都会自动按同一规则处理。

平台入口与首要检查
平台查看位置优先确认
Windowsv2rayN 的 TUN 开关及系统网络设置应用是否取得建立接口和设置路由所需的权限
macOSv2rayN 的 TUN 设置及系统网络界面当前构建是否提供入口,系统是否允许接管
Linuxv2rayN 的 TUN 设置及系统路由运行环境是否允许使用 TUN 设备及修改路由
Androidv2rayNG 的 VPN 模式、分应用代理系统 VPN 授权和应用是否进入选定范围

桌面端的 TUN 与安卓端通过 VPN 服务接管流量有相似的观察点,但两者的界面、系统权限和配置不能直接互抄。安卓第一次启动通常由系统确认授权;已有其他 VPN 服务时,先确认切换会不会中断工作连接。桌面端如果看不到 TUN 开关,先核对当前客户端、构建和系统提供的入口,不要从别的平台照搬权限命令,也不要为了排查关闭系统安全策略。

开启前记录原网络状态

先在关闭 TUN 的状态下验通当前服务器,再记录系统代理是关闭、手工配置还是由客户端设置。需要验证局域网打印机、文件共享或内网系统时,记下一个已知能打开的目标,附上域名和直接地址各自的结果。然后只打开 TUN,不同时换服务器、不同时改 DNS、不导入新的路由方案。这样如果一个应用恢复而另一个服务中断,能直接判断和这次接管变化有关。

打开后先看虚拟接口和运行日志是否正常,再检查本机路由。以下两条分别用于在 Linux 与 macOS 查询去往某个地址时系统选择的路由,命令本身只读取状态。按当前系统选择一条执行。目标使用的是示例公共地址;排查内网时换成经授权测试的具体地址。这个结果反映系统路由选择,不等于内核最终选中的出站,两层要分别看。

# Linux
ip route get 1.1.1.1

# macOS
route -n get 1.1.1.1

局域网中断和重复接管怎么查

开启后若只有内网访问异常,分别测试直接地址和主机名。两者都失败,先查目标是否进入虚拟接口,以及客户端是否保留了到该网段的可用路径;只有主机名失败,优先看 DNS 或本地服务发现是否仍沿原路径工作。若目标网段和另一个虚拟网络重叠,笼统加「绕过局域网」可能仍不足以判明哪条系统路由获胜。记录实际使用的网段和接口,再按目标做小范围调整。内核里的直连规则不能补回系统中已经失效的接口。

服务器自身的连接也需要可用的底层路径。开启后所有连接一起失败时,查客户端连接到服务器的请求有没有被再次送入 TUN,以及系统中是否还存在其他接管工具。尽量使用客户端提供的接口选择和路由管理功能,不要叠加来源不明的全局路由脚本。安卓只有部分应用不工作时,可在「分应用代理」中核对名单和模式,再重启目标应用测试,不要把后台进程保留的旧连接误看成配置无效。

回退时先关闭接管,确认虚拟接口与路由恢复;再把系统代理恢复到开启前的状态。若关闭客户端后浏览器仍访问本地代理端口,检查是否残留手动代理配置。切换 Wi-Fi 或从休眠恢复后才出现的故障,最好按同样的网络切换动作复现。安卓若只在熄屏后掉线,可参考电池优化与后台运行指南,先处理后台服务被系统终止的可能性。

FakeDNS

先理解合成地址为什么能工作

FakeDNS 为域名返回一个从地址池分配的合成地址,并记录两者的对应关系。应用随后向合成地址发起连接;如果连接也进入认识这张映射表的处理路径,内核就能还原域名并继续路由。合成地址是内部标记,不是目标服务器真正对外提供服务的地址。直接拿它做连通性探测,或者交给另一台机器访问,都不能证明原站点是否可达。

它适合确实由应用先解析、随后只传地址给接管层,而又需要保留域名判断的场景。只开启一个 DNS 设置并不能独立达成目的:负责合成应答的一侧、接收后续连接的一侧和域名还原机制需要配套。若后续数据包从物理接口发走,或交给另一个不共享映射的进程,看到一个合成地址却打不开服务就是合理结果。没有实际需求时,普通 DNS 配合域名路由更容易验证。

核对地址池、查询路径和入站

先确认当前客户端与运行内核确实提供 FakeDNS 的配置能力。使用图形界面时,优先按它提供的设置入口核对生成结果;使用原始 Xray 配置时,可以为 fakedns 定义地址池。下面只演示这个字段,不包含负责发放合成应答的 DNS 设置,也没有负责还原的入站。单独加入此片段,不会把设备上所有正常 DNS 应答改成合成地址。

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

ipPool 是分配范围,poolSize 是映射池容量。它不是带宽、并发连接上限或可访问的域名配额。选池时先检查当前网络、其他虚拟接口和实验环境是否占用了重叠网段。使用双栈时还要核对所选客户端对 IPv6 池的支持,以及查询路径对 A 与 AAAA 记录的处理;不要只凭一次 IPv4 测试就认定双栈流量都会按同样的方式经过映射。

原始 Xray 配置还要在内置 DNS 的服务器选择中安排 fakedns,并在接收后续连接的入站检查 sniffing.enabled 与 sniffing.destOverride 中的相应处理选项。若依赖的是桌面客户端 TUN 的网络引擎,则还要查该引擎自己的配置;两者即使使用相同的功能名称,也不表示字段兼容。用于内部服务的真实解析要另行保留,尤其是打印机、本地域名和其他不经过接管路径的设备。

按应答、接管、还原顺序验证

先用一个可控的测试域名确认应用收到的是普通地址还是池内地址,再看发往该地址的新连接是否真的进入预期接口。最后检查能否在连接日志中看到还原后的目标或预期出站。收到真实地址时,优先看应用是否使用另一套解析器、是否命中缓存;收到合成地址却无连接日志时,先查接口和路由;收到连接但未还原时,再查入站配置和映射是否来自同一次运行。三种现象不应使用同一套修复步骤。

如果问题在重启后出现、过一段时间又消失,常见的检查方向是应用仍持有旧合成应答,而内核的映射已经重建。先结束测试应用的旧连接,按环境允许的方式处理对应缓存,再用新请求复查。回退时既要停止返回合成地址,也要确认旧缓存不再把应用引向地址池;只关闭接收合成地址的路径,很容易把短时间故障留给仍缓存旧应答的应用。

多订阅管理

让名称反映用途,而不是临时状态

订阅超过一个,应先约定分组名称,再导入。名称最好能同时说明来源和用途,例如「办公主用」「测试备用」,不要只写「一组」「二组」或者一个速度描述。服务器备注可以重复,外部来源也可能在更新后改备注。判断两个条目是否等价时,至少比较地址、端口、协议、传输和安全设置;地址相同也不代表认证参数、域名设置或传输路径就相同。

在 v2rayN 的「订阅分组 → 订阅分组设置」中为不同来源建立独立条目;安卓端则从所用客户端的「订阅分组设置」核对来源与别名。已有手工配置建议单独保管,不要寄希望于订阅更新后仍保留对导入条目的本地修改。如果需要留一个已验证的对照配置,应按客户端支持的方式另存,并独立维护,避免下一轮更新把测试基准和待测试对象同时替换。

把刷新安排成可验证的流程

初次接入一个新来源时,先更新该组,再检查条目数量是否符合来源说明、协议是否受支持,最后选一个条目验证。日常更新则尽量先刷新备用组,确认可用后再刷新主用组。若客户端只提供全部更新,记录当前使用的条目,并保留一份在订阅更新范围以外的可用配置。自动更新选项存在时,按来源变化频率和实际工作时段设置,不要把缩短间隔当成解决间歇失败的办法。

有些界面区分「通过代理」和「不通过代理」更新。两者改变的是取得订阅内容的请求路径,并不决定更新后的服务器走哪个出站。一个来源刷新失败,先看订阅入口是否可达,以及当前路径能否完成解析和连接。不要在同一次排查里同时改更新方式、活动服务器和 DNS;一旦恢复,就分不清究竟是哪一项起作用。如果仅在主用配置失效时无法走原更新路径,还要确认是否能按网络权限要求使用另一条已验证的更新路径。

更新成功也可能只代表下载与解析完成,不能替代可用性测试。先检查活动条目有没有变化,再用同一个应用发起新请求。延迟测试适合做初筛,但其测试方法、目标地址和线路都可能与实际使用不同,不能用一次最低数值决定长期切换。若所见问题是高峰期速度不稳,可按网速慢的分层排查方法对照节点、线路和本地设置,而不是清空所有订阅重来。

区分来源失效、条目失效和本地设置问题

只有一个订阅更新失败,其他订阅能刷新且旧条目还能连接时,优先检查该来源的地址与权限。如果多个来源都无法刷新,但已导入配置依旧可用,检查共同的更新路径和解析配置。如果更新成功、所有新条目都无法启动,先看解析后实际生成了什么协议与传输设置,再核对当前内核是否支持。若不同来源的条目都能启动但业务应用同时失败,更应回到本地接管、路由和 DNS 检查。

整理旧分组时,先切换到已验证的新配置,观察一轮实际使用,再删除不再维护的来源。删除之前要区分界面命令是在移除订阅定义、当前条目,还是两者一起处理。迁移设备时也按这个思路:先在新设备上重建最小可用的一组,再逐步加入其他分组和本地规则。桌面端已经能连接不代表同一份高级配置可以在手机上原样运行;协议能解析、出站能启动和系统能接管是三道独立的验证。

订阅地址中的访问参数与普通备注不同,应按凭据处理。排查时共享分组名称、更新时间和已脱敏的错误类型就够了;导出的配置、二维码和截图同样可能包含敏感字段。下次接手时,只要能从记录中还原「哪个分组、何时更新、如何验证、如何退回」,就不必保存完整订阅地址在日常排查文档中。

自定义出站

先判定是否需要原始配置

普通服务器条目由客户端按界面字段生成出站,适合常规导入、切换和更新。只有需要单独命名一个出口、让明确的规则指向它,或实现界面未提供的配置组合时,再考虑自定义出站。先在 v2rayN 中确认使用的是能导入或运行原始配置的入口,别把整个 JSON 粘到普通服务器的地址字段。v2rayNG 与 v2flyNG 使用不同的内核,字段支持范围不能仅凭菜单名称推断。

自定义配置至少涉及三件事:入站负责接收本地请求,路由负责按条件选出站,出站定义如何与目标通信。它们靠标签关联。标签没有协议语义,叫 direct 的出站也要检查其实际协议;路由写了一个不存在的标签则不能按预期工作。命名应突出用途,并避免和客户端生成的标签重名。动手前另存已验证的配置,记录客户端接管模式和本地监听端口,便于回到原环境。

用两个简单出站验证标签及默认路径

下面是可单独运行的最小测试配置,适用于支持这些原始字段的内核。它不设置系统代理,不接管整台设备,只在本机回环地址开启一个 SOCKS 入站。默认出站为 freedom,对 example.org 的匹配请求则交给 blackhole。它的用途是验证出站选择,而不是替换日常使用配置。启动前先确认示例端口未被占用。

{
  "inbounds": [
    {
      "tag": "check-in",
      "listen": "127.0.0.1",
      "port": 10880,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": false
      }
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom",
      "settings": {}
    },
    {
      "tag": "blocked",
      "protocol": "blackhole",
      "settings": {}
    }
  ],
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["full:example.org"],
        "outboundTag": "blocked"
      }
    ]
  }
}

配置启动后,使用支持 SOCKS 的测试工具,把域名交给入站而不是在工具端先解析。下面两条请求在已安装 curl 的终端中分别执行;失败与成功要结合当地网络基线和内核日志判断。在网络可达的前提下,前一条应命中阻断出站,后一条应走默认出站。若客户端接管工具已经设置了环境变量或免代理名单,也要确认实际请求确实经过示例端口。

curl --noproxy "" --proxy socks5h://127.0.0.1:10880 --max-time 10 https://example.org/
curl --noproxy "" --proxy socks5h://127.0.0.1:10880 --max-time 10 https://example.net/

按启动、入站、出站三层定位

配置无法启动,先检查 JSON 结构、字段兼容性和端口占用;如果日志提示某个标签找不到,核对大小写及它是否真的出现在运行配置中。配置能启动但两条请求都立刻报本地连接失败,先查监听地址与端口,不要调整远端传输。只有默认出站请求失败时,再验证测试目标在不使用本地代理时是否能访问,并检查内核解析和连接错误。回环监听是这个示例的边界,不要为了从另一台设备方便测试,就把无认证的入站改成对整个网络开放。

把实验规则并回日常配置时,保留原有出站顺序,先加明确的小范围规则,再看是否确实要改变默认路径。自定义配置在客户端里有时作为独立条目运行,并不会与当前订阅节点自动合并;反过来,某些界面也可能重新生成路由或入站。判断依据应是当前运行配置和请求结果,而不是导入前文件的样子。遇到和原配置冲突的端口或标签,优先在实验配置里改一处,不要同时重命名所有关联项。

结束实验后停止测试配置,恢复原活动条目,按原来的系统代理或 VPN 模式发起一条新请求。若需要向同事说明变更,只提供已脱敏的最小配置和预期路径,并写清示例是不是完整配置、适用于哪个内核。日常遇到术语或字段含义不确定,可查术语表;回到基础连接流程时,按快速上手教程重新验证导入、选择和连接三步。