配置进阶 / 查阅手册
V2Ray 进阶配置手册
从订阅更新到出站选择,按流量经过的环节定位问题。
首次使用请先走一遍快速上手教程,完成导入、连接与验证,再回本页调整进阶选项。本页按主题查阅,不要求依次开启所有功能。桌面端首推 v2rayN;安卓端可按所需内核选择 v2rayNG 或 v2flyNG,入口见客户端页面。下文区分客户端菜单、系统开关和内核字段,界面名称与支持范围以当前客户端为准。
订阅分组与服务器过滤
先区分采集范围和显示范围
订阅分组用来标识配置来源。一组通常对应一个订阅地址,以及该地址更新后导入的一批配置。分组选中状态只是列表范围,不等于切换当前连接,也不改变内核的路由规则。v2rayNG 可在「订阅分组设置」新增分组,填写备注和地址后保存,再回到配置文件列表执行更新。v2rayN 可从订阅分组菜单进入分组设置。支持更新当前组的界面里,先切到目标组,再执行当前分组更新;要更新所有来源时才选全部更新。v2flyNG 的分组和筛选能力以当前界面为准,不要按另一款客户端的菜单名寻找同一开关。
导入后先检查列表中是否出现预期的配置,再明确选中一条记录连接。一次更新可能重建受管理的配置项,旧选中项可能被同名新项替换,也可能已不在列表中。仅看顶部当前分组名称,无法确认实际运行的是哪条配置。以连接时的选中项与日志为准;配置备注相同的情况下,可在本地对照协议、传输类型和端口,不需要把服务器地址或订阅地址复制到外部排错页面。
判断过滤发生在哪一层
先看输入框位于哪里。配置列表的搜索框通常只缩小当前可见范围,清空搜索后记录应重新显示;订阅分组设置里的过滤条件则可能在更新时决定哪些记录进入本地组。后者修改后通常要再更新一次才能验证,且可能影响现有列表。排查时先清空列表搜索,再切回目标组,最后检查该组的导入条件。不要在三个位置同时修改,否则得分不清记录是没有被保存、已经被折叠到别组,还是仅被搜索框隐藏。
仅当设置说明明确接受正则表达式时,才把正则写入过滤框。例如供应方统一用 Lab- 开头标注测试记录时,可用下面的表达式匹配这一前缀。它不是订阅地址,也不是路由规则。先用两条已知备注对照,一条应匹配、一条不应匹配;再核对界面是保留命中项还是排除命中项。区分大小写的实现中,小写开头的备注不会命中。供应方调整备注格式后,规则仍然合法,却可能不再匹配任何记录。
^Lab-
区分拉取失败与过滤后为空
更新失败时,先判断客户端有没有收到可解析的订阅内容。请求超时、证书错误、权限拒绝属于拉取阶段;请求成功却导入零项,还可能是响应返回了登录页、内容格式不符合当前客户端的解析要求,或过滤条件全部排除了记录。优先看更新日志有无请求错误,再临时去掉当前组过滤条件,仅重试这一组。有记录恢复,才回到过滤设置缩小条件;依旧没有记录,则检查地址是否过期以及服务方给出的是订阅地址、单条配置链接还是供另一种工具使用的文件。
某些客户端允许指定订阅请求是直连还是经过当前代理。已有连接可用但仅更新失败时,比较两种请求路径是否能到达订阅服务;完全没有可用配置时,依赖当前代理更新可能形成循环。先恢复一条可用的连接路径,再决定是否把订阅更新固定在该路径上。更新成功只说明下载和解析这一步完成,不说明新导入的每条配置都能建立连接。下一步应挑一条确认支持的记录单独验证,不用批量测速替代基本连通性检查。
保留对照组在现有组上动过滤条件前,记下原设置,保留一条已验证的本地配置。不要把正式组直接改成实验组,也不要把订阅地址作为故障截图的一部分。即使界面隐藏了后半段,链接也应按凭据对待。
路由规则实战
先保证请求进入内核
路由只处理已经到达内核的连接。桌面端仅启用系统代理时,不遵循系统代理的程序可能根本不会进入内核;安卓端启用分应用代理后,被排除的应用也不会由这套规则处理。排查前先选一个确定经过客户端的应用,然后检查日志里是否出现对应访问记录。如果日志里根本没有请求,不要先改域名策略。应检查系统代理、应用自己的代理选项、VPN 授权或应用是否在所选名单内。接入层确认后,再判断是规则没命中还是命中了错误的出站。
记录顺序与默认路径
在 Xray 的有序路由规则中,先匹配到的规则决定该请求的处理结果,不会继续向下寻找更具体的一条。把精确域名、明确的内网网段或某个专用入站的例外放在宽泛规则前。单条规则里同时填写域名和端口等不同字段时,通常要求这些字段都满足,不是任一个字段满足就生效。若目标是「属于这个域名,或者落在这个地址段」,应分别写两条同指向的规则。没有规则命中时,一般使用出站列表的第一项。图形界面可能自动追加规则或重新组织列表,判断实际优先级应以生效配置为准。
| 条件 | 含义 | 使用边界 |
|---|---|---|
full:example.com | 匹配完整域名 | 不会同时匹配其子域名。 |
domain:example.com | 匹配该域名和子域名 | 适合把同一域名树走同一路径。 |
192.168.50.0/24 | 匹配指定 IPv4 网段 | 以实际网段为准;不要把局域网假设成一个固定前缀。 |
geoip:private | 匹配规则数据中的私有地址集合 | 取决于当前规则资源及其收录范围。 |
选择域名策略再做正反测试
AsIs 不为匹配地址规则而主动解析目标域名。IPIfNonMatch 可在域名形式无法完成路由匹配时解析地址,再按地址尝试匹配;如果提前命中了一条宽泛规则,就不能指望后面的地址规则补救。IPOnDemand 会在匹配过程遇到需要地址的条件时解析域名,相应增加 DNS 参与的机会。三者都不是「强制所有应用使用内核 DNS」的按钮,也不是出站连接时的地址族设定。能用一条明确的域名规则解决的场景,不必为了分流而让所有相关请求提前解析。
下面是 Xray 顶层 routing 对象的示例。它应合并进已有配置,且出站列表须有名为 direct 的出站。如果要仅对测试应用生效,可进一步限定入站标签,不能把该片段当成完整配置启动。把示例中的网段改为手头可以访问的测试网段;如果不使用局域网条件,就移除第二条规则,不要留下匹配范围不明的规则。
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"domain": ["full:example.com"],
"outboundTag": "direct"
},
{
"type": "field",
"ip": ["192.168.50.0/24"],
"outboundTag": "direct"
}
]
}
}
验证时至少测三类请求:应命中的完整域名、同一域名下本不应命中的子域名,以及应命中网段规则的地址。子域名不必真的提供网页,可以用出站记录判断路由结果,不要把访问结果或域名是否存在当成规则结论。若域名请求始终只以 IP 出现在日志中,先确认应用是否提前完成了解析,再检查「启用流量嗅探 Sniffing」是否适用于该入站。嗅探只能从支持且可识别的流量恢复有限的目标信息,无法保证每种连接都提供域名。规则已经命中而页面仍连不上时,转查出站拨号和目标端口,不要继续改规则顺序。
DNS 配置优化
先查是谁在问、谁在答
一次访问可能经过多个解析环节。应用可以调用系统解析器,也可能用自己的加密 DNS;内核可以为路由匹配解析域名,也可能把域名留给远端出站处理。发往代理服务器本身的域名还涉及连接建立前的解析。改动一项 DNS 设置,不会自动覆盖其余环节。先记录故障范围:只有一个浏览器异常、所有进入客户端的应用异常,还是连客户端自身的服务端域名都解析失败。三个范围分别优先检查应用解析、内核解析和连接前的引导解析。
桌面端用 v2rayN 的系统代理模式时,不要假定终端和浏览器采用一致的代理及 DNS 行为。安卓端也要区分系统「私人 DNS」和客户端里的「启用本地 DNS」等选项:名称相似,作用位置不同。启用 VPN 后,是否接管某应用的查询取决于应用是否进入 VPN、系统给出的 DNS 配置以及应用是否另行发起加密查询。诊断时可以在单一测试应用里临时比较自动与自定义解析设置,结束后恢复原值,不需要先永久关闭系统级设置。
把解析器和用途对应起来
需要解析家庭或办公设备时,应优先用确实掌握该区域记录的解析器。全部改用公共解析器,内网域名可能失去结果,即便其对应的私有地址在路由上已经允许直连。反过来,把公共域名一律送给只对内网作答的服务器,也可能引入超时。Xray 的内置 DNS 可用服务器条目的 domains 指定优先匹配的域名范围;还需考虑其他服务器在失败时是否参与回退。仅设置域名范围不等于强制查询隔离。如果必须让内部域名只交给内部解析器,需一起检查回退设置和各客户端所用的内核行为。
使用基于 HTTPS 的解析器时,还要弄清连接解析器本身所需的域名如何解析。如果该域名的初次解析依赖同一个尚未建立的服务,就可能出现启动循环。类似地,如果解析器只能通过某个代理出站访问,而代理服务器的地址又依赖该解析器,代理与 DNS 会互相等待。应先给连接前必须解析的服务准备独立可达的引导路径,再处理一般业务域名。不要靠堆叠多个上游掩盖这个顺序问题;那样可能只在缓存还有效时看似正常。
分别验证地址结果和可达性
在有 nslookup 的桌面环境中,可先查询系统解析路径得到的地址。以下命令分别查看 IPv4 和 IPv6 记录;它们不能证明内核对同一域名也获得了相同结果。对照内核行为,应在确保请求进入内核后触发一次新的连接,并查看相应的 DNS 或出站日志。用同一个测试域名记录返回类型、耗时和异常消息,避免在每次切换配置时换一个目标。
nslookup -type=A example.com
nslookup -type=AAAA example.com
如果双栈环境经常先尝试不可达的 IPv6 地址,可先对照 IPv4 与 IPv6 的实际连接结果,确认问题来自地址族可达性,而非查询超时。内核支持的 queryStrategy 可以限制内置 DNS 查询地址的类型,但不等于修改整个系统的 IPv6 配置,也不会拦截应用直接使用的 IPv6 字面地址。把它当成有边界的配置选择。若同一域名在两个解析位置返回不同地址,也不能立刻认定有故障:缓存、分地域应答和不同网络视角都可能造成差异。以实际连接能否建立、返回结果是否属于预期网络为判断标准。
一次只换一个解析环节先保存原有上游与域名条件,再改一处。用新连接复测;必要时重启测试应用,以区分应用缓存与设置未生效。把解析失败、解析成功后拨号失败分别记录,不要合并成「DNS 不通」。
TUN 模式与系统流量接管
先明确为什么切换模式
系统代理适合愿意读取代理设置的桌面程序。TUN 通过虚拟网络接口与系统路由接收流量,适用于需要覆盖某些不读取代理设置的应用的场景。它改变的是流量怎样进入代理链,不保证每条连接都能被当前出站转发。例如应用产生了 UDP 流量,虚拟接口收到数据只代表接入成功,后续仍取决于接管组件、路由、出站协议及服务端能力。若目标应用已经能通过系统代理工作,保留当前模式更容易判断故障位置。
在 v2rayN 中,先关闭其他会改写系统代理或创建虚拟网卡的工具。确认选中的配置在原模式下可用,再在主界面查找「TUN 模式」开关并按系统要求授权。创建虚拟接口和修改路由可能需要额外权限,具体权限与客户端支持由平台和配置决定。在安卓端,应理解为应用通过 Android VpnService 接管指定流量,不要照搬桌面网卡设置。首次连接需系统授权;仅某个应用无法被接管时,优先检查「分应用代理」的名单与绕过模式,再参考授权与分应用代理说明。
| 平台与客户端 | 先检查 | 再验证 |
|---|---|---|
| Windows · v2rayN | 权限提示、虚拟接口状态以及已有 VPN | 比较开关前后的路由与目标应用记录。 |
| macOS / Linux · v2rayN | 当前发行包是否提供该入口,以及系统权限 | 查看接管是否建立,测试本地与外部目标。 |
| Android · v2rayNG / v2flyNG | 系统 VPN 授权与允许接管的应用范围 | 区分名单内和名单外的应用进行访问测试。 |
分辨路由回环和范围冲突
切换后立即断网时,先关闭 TUN 验证原模式是否恢复。如果关闭便恢复,而打开时日志反复尝试连接同一服务端,应检查出站连接是否又被送回虚拟接口。许多客户端会为自己的连接安排绕行,但多网卡、正在运行的另一个 VPN 或手工配置默认路由都可能打破这一前提。不要直接删除系统默认路由。先停用互相竞争的接管工具,恢复一套自动设置,再用接管组件提供的选项检查应从物理接口发出的那条连接。
如果外部网页正常,只有同网段设备不可用,先对照设备自带的本地地址与实际子网。需要区分两种「绕过」:系统路由让特定网段根本不进入虚拟接口;内核路由让已经进入虚拟接口的请求从直连出站发出。内核的直连规则只有在请求已进入内核时才有意义,不能修复应用被系统提前送走或误分配的问题。反过来,在系统层把一个范围全部排除后,内核日志里本来就不会出现这些请求。不要只凭某个界面显示「已绕过」判断是哪一层。
做三条相互独立的回归测试
第一条测试外部网页的新连接,确认普通访问和解析可用。第二条访问已知存在的局域网服务,确认接管没有改变预期的内部路径。第三条使用原先不读取系统代理的目标应用,确认切换确实解决最初问题。有 UDP 需求时,再用目标应用本身验证相关功能,不以浏览器能打开普通网页作为替代。网络从有线换到无线、从无线换到移动网络后,应重新跑必要的测试,因为默认网关和地址族可能改变,原本正确的排除范围未必仍适用。
如果需要回退,先用客户端开关停止接管,再确认原先的系统代理状态和本地访问都已恢复。退出前保留首个错误的简短记录,尤其区分权限拒绝、接口创建失败、路由设置失败和运行后转发失败。安卓端若系统设置仍要求始终启用某个 VPN,停止客户端不一定恢复直连;应按自己的网络策略检查系统 VPN 设置,不能简单视作客户端没有关闭。其余常见连接问题见疑难解答。
FakeDNS 的地址映射与使用边界
理解地址怎样还原成域名
FakeDNS 会从配置的地址池中分配一个合成地址给某个查询到的域名,并保存对应关系。应用随后连接该地址;负责接收连接的组件再根据映射恢复域名,内核便能以域名作路由判断,或把域名作为后续出站目标。这不是为目标服务器分配新的真实地址,也不是给所有 DNS 请求加密。关键是前后的查询与连接属于同一套互相理解映射的链路。应用如果直接使用已知 IP,或用自己的解析通道拿到真实地址,就不会自然进入这条映射流程。
最容易误配的情况是只有查询被修改,后续连接却未接管。例如应用从被接管的解析器收到合成地址,实际连接又因为分应用名单或地址排除项走向系统直连。这时日志里可能看到合成地址连接超时,或者内核根本没有这次请求。另一个方向是接管组件确实收到连接,但缺少映射或 FakeDNS 目标识别,仍把合成地址交给某个出站拨号。两者表现相似,却应分别在接入范围和内核识别上修正,不能靠换普通 DNS 上游解决。
地址池大小与作用范围
下面是 Xray 顶层 fakedns 地址池片段,使用基准测试保留范围中的一段 IPv4 地址。它只描述地址池及映射容量,不会单独开启完整功能。poolSize 不是并发连接数,也不是订阅节点数;它限制该池保留的地址与域名映射规模。容量要与网段可提供的地址数量匹配,并考虑常用应用同时访问的域名数量。不要照搬该网段到已有内部测试网使用同一范围的环境,先检查系统、虚拟接口和其他工具是否已经占用它。
{
"fakedns": [
{
"ipPool": "198.18.0.0/16",
"poolSize": 4096
}
]
}
手工组合 Xray 配置时,还需让选定的 DNS 查询能够使用 fakedns,并让接收入站启用对应的目标识别,例如在适用入站的嗅探设置中使用 fakedns。图形客户端或 TUN 组件可能自行维护一套合成地址机制,入口和参数不一定与 Xray 的顶层对象相同。尤其不能混用一层生成的映射与另一层独立生成的地址池,然后假定两者可互相还原。应由一套明确的配置负责生成与消费映射,再核对实际进入哪条出站。
从小范围试用并安排回退
试用时只安排一个可控应用和一个测试域名。先用普通解析建立对照,记录能否解析、内核见到的是域名还是地址、最后选择的出站。启用后让应用建立新连接,检查它是否拿到池内地址以及接管日志能否恢复预期域名。不要只用终端读取 DNS 结果作结论:终端及目标应用可能使用不同的解析与接入方式。若使用地址策略的规则突然不再命中,确认它匹配的是合成地址、恢复后的域名,还是后续解析出的真实地址。
局域网设备发现、企业内部解析、直接依据真实地址作判断的应用,更适合保留其所需的真实解析结果。服务本身位于同网段时,应检查本地域名及相应访问是否同时走正确路径,不能只把域名从合成范围移除就视为完成。地址池被占用、映射被淘汰或组件重启后,应用缓存里可能还留有旧合成地址。此时如果同一个应用的新页面可用而旧页面故障,应先关闭旧连接并重启测试应用,再考虑改变池大小。
关闭设置后复查缓存回退时先恢复普通解析与原接管配置,再让测试应用重新解析。已经被应用记住的合成地址不会因关掉开关立即消失。确认新查询返回真实地址、连接不再指向合成网段后,再判断问题是否解决。
多订阅管理与变更回退
按更新责任分组,而不是按当前延迟分组
多个订阅应保留各自来源边界。可以按供应方、用途或负责更新的人命名,例如区分常用来源、临时实验来源与本地手工配置。备注只写能识别范围的信息,不复制链接或账户字段。不要把测速结果当分组制度:网络一变,记录的排序就会变,而配置来源和更新责任没有变化。常用与实验用途如果来自同一来源,可优先用客户端支持的标签、筛选或独立测试环境组织,避免无必要地重复拉取同一个地址。
手工导入、需要保留备注或用于短时排错的配置,应尽可能与自动更新的条目分开。订阅刷新时,客户端可能按照来源重建条目,直接在订阅生成的条目上改本地备注,未必能跨更新保留。确实要保留一份快照时,可用客户端支持的复制功能复制到独立位置,并标明它不会跟随来源变更;之后也要定期决定是否仍然需要该副本。不能只为了防丢而持续积累旧条目,否则切换时更容易选到已经失效的配置。
以一组为单位更新和验证
维护时先确认当前正常工作的条目及所在组,然后更新一个待变更来源。刷新结束后,对照该组是否整体为空、记录是否仍可识别、常用协议和传输字段是否符合预期。如果记录数骤变,不必立即更新其他组求证。先用该组更新日志区分来源响应变化、解析差异和过滤条件的影响,再选一条代表性的配置进行连接验证。确认单组表现符合预期后再更新下一组,这样能在不中断其余来源的情况下定位变更。
如果更新策略允许定时刷新,应避开确实需要连接稳定的时间段。不要使用多个设备同时对同一来源高频刷新,也不要用短间隔重试替代故障诊断。遇到请求被限制时,应按来源规则减少刷新频率,而不是把刷新失败视为节点失效。对于依赖当前代理访问的订阅,先验证正常连接仍然可用,再发起刷新;一个来源无法更新时,独立正常的组应保持不变。将自动更新、自动选择条目和自动启用系统代理分开考虑,因为这三件事的失败表象可能相同。
处理重复项、迁移与设备差异
不要仅凭备注相同就删除其中一条。相同名称可能对应不同来源和传输参数,不同名称也可能是同一服务端的不同配置。需要清理时,在本地对照归属组、协议类别、地址与端口、传输以及安全设置。先确定是来源真的重叠,还是客户端把常用记录跨组重复展示。若由两个有效来源维护,删除其中一个分组通常比逐条删除更符合更新模型,但应先确认没有应用规则或启动选项依赖该组中的配置。
从 v2rayN 迁移到安卓端时,不要把整个桌面配置目录当成可通用的导入文件。分组备注和订阅来源可以重新建立,平台专属的系统代理、TUN 或分应用设置则应单独复设。v2rayNG 与 v2flyNG 对同一订阅的结果也可能不同,因为两者采用的内核不同,并非所有协议和字段都具备对应实现。迁移时先检查一条有代表性的配置,再逐步恢复自定义路由和 DNS。不兼容的记录应按目标客户端与内核能力判断,而不是把它们混入网络故障统计。
把回退准备放在更新之前
更新前记下可用条目、客户端模式与相关规则。如果有必要保存备份,应存放在受控位置,因为导出可能包含订阅地址和连接参数。需要向他人说明问题时,只提供已脱敏的错误类型、发生环节和可复现步骤。订阅地址已暴露时,应向来源方申请更换,而不是只删本地记录。若更新造成整组异常,先切回已验证的对照配置,确认客户端基本连接仍正常。回退成功后,再判断需要恢复本地配置、修改过滤条件,还是等待来源修复响应。
自定义出站
先决定改由谁维护完整配置
出站定义内核收到连接之后怎样建立下一段连接。可以是直连、拒绝,也可以是具体代理协议。出站的 tag 是供路由引用的标识,不是用户看见的服务器备注。规则里的 outboundTag 必须指向实际存在的标签,并与大小写一致。配置中只添加出站,不增加路由引用,它通常不会产生预期效果;如果插在出站列表的首位,还可能意外改变所有未命中规则的连接路径。因此应先画清入站、规则与出站之间的对应关系,再决定在哪一层修改。
图形客户端从单条配置启动时,通常会根据界面设置生成一份运行配置。手改生成文件可能在切换节点或重启后被覆盖。如果客户端支持导入完整自定义配置,应在该模式中维护可重复导入的副本。使用完整配置时,不应假定界面的路由编辑器、DNS 开关或系统代理端口会与自定义内容自动合并。先核对客户端如何使用这份配置,包括预期的入站类型、监听端口、内核与运行模式。桌面和安卓的系统接入能力不同,不可仅凭配置能解析就判断能无改动迁移。
用最小配置验证标签和匹配顺序
下面是完整的 Xray 本地测试配置。只在环回地址监听 SOCKS 请求,用两条出站分别完成直连和拒绝。保留直连为第一项,精确匹配的目标才会交给拒绝出站。这个例子不会使用远端代理服务,适合把出站标签与系统接管问题分开。运行前确认未占用监听端口;如果改端口,测试命令也要同步修改。优先在独立测试环境试用,不要直接覆盖客户端当前使用的配置。
{
"log": {"loglevel": "info"},
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"tag": "local-test",
"settings": {"auth": "noauth", "udp": false}
}
],
"outbounds": [
{"protocol": "freedom", "tag": "direct", "settings": {}},
{"protocol": "blackhole", "tag": "reject-test", "settings": {}}
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-test"],
"domain": ["full:example.net"],
"outboundTag": "reject-test"
}
]
}
}
配置已由兼容的 Xray 内核运行后,可在装有 curl 的同一台桌面设备使用以下命令。两条命令都把目标以域名形式交给 SOCKS 入站。第一条应选择直连,第二条应选择拒绝。由于本地网络也可能无法访问测试域名,重点是比较日志里的出站选择,不是期待两个固定的响应码。如果两条命令都无法连接本地端口,先检查配置是否运行、端口是否正确以及是否被其他进程占用,还没到排查路由的阶段。
curl --max-time 10 --socks5-hostname 127.0.0.1:10808 https://example.com/
curl --max-time 10 --socks5-hostname 127.0.0.1:10808 https://example.net/
扩展时逐层核对内核、拨号和目标
迁入实际出站时,保留可以复现的本地入站和已知正常的默认路径,先只改动一条目标规则。内核启动失败,优先检查配置语法、协议是否支持和标签是否有效;内核成功启动却没有请求记录,检查应用接入;请求指向预期出站但拨号失败,检查服务端地址解析、网络可达性及协议字段是否与提供方一致。常见误判是见到一个 TLS 错误就修改路由,实际上路由可能已经正确选择了出站。此时应该对照握手所需参数和目标端点,而不是移动规则位置。
准备把配置交给另一款客户端时,先阅读Xray 与 V2Fly 内核差异,区分通用配置概念与各内核特有字段。部署完毕后撤掉测试入站和不再使用的例外规则,把日志级别恢复到日常所需。保留发布前可运行的副本,在正常接入方式下重新测试应用、DNS 和局域网路径。如果只有桌面的显式代理测试通过,而系统接管后的应用失败,应回到接入层排查,不必重写已经验证过的出站。