配置参考 · v2rayN
V2Ray 进阶配置手册
已经完成首次连接后,用本页查阅订阅、路由、解析与流量接管的配置边界。尚未验证基本连接,请先走一遍入门指南的导入、连接与验证流程,再回来一次只改一层。
订阅分组与服务器过滤
先划定更新范围,再导入服务器
订阅分组用于区分服务器记录的来源和更新范围,不等于路由策略,也不会自动为某个应用选择出站。以桌面端首选的 v2rayN 为例,在订阅分组管理中新增分组,为来源填写容易识别的备注,再填写订阅地址。保存后先切换到这个分组,使用仅更新该分组的入口,避免首次验证时同时改写其他来源。不同界面可能把更新入口标成「更新当前订阅」或放在分组菜单下;判断依据是动作针对当前组还是全部组,而不是按钮所在位置。
更新完成后,不要只看界面是否提示成功。先看分组内有没有可用记录,再选一条预期出现的服务器,检查协议和传输类型是否与提供方说明相符。随后把它设为当前服务器,使用之前已经验证过的连接模式发起一次实际请求。订阅请求成功、列表解析成功、清单里的服务器能连接,是三个独立的结果。一次更新即使返回正常响应,也可能只拿到登录页、错误说明或客户端不支持的订阅格式。
分清导入过滤与列表搜索
服务器列表上方的搜索通常只影响可见范围;分组配置中的服务器过滤若作用于导入阶段,则可能改变更新后的实际记录集合。修改前先确认筛选依据是备注、协议还是其他字段,以及规则是保留匹配项还是排除匹配项。没有明确说明支持正则表达式时,先用一个确定存在的普通关键词试验,不要直接粘贴带管道符和括号的表达式。关键词尽量选择来源长期使用的稳定前缀,不要选会随维护而改名的临时标记。
有条件时,在可丢弃的测试分组里使用同一来源做对照:先保留未过滤的结果,再加入一个只命中少量记录的条件,最后清空条件重新更新。清空列表搜索后如果仍缺少相应记录,说明问题并不只是搜索框把记录藏了起来。若客户端明确使用正则,还要检查锚点是否限制了字符串开头、括号是否改变了备选条件的作用范围。中文别名中的全角符号和普通连字符往往不同,排查时直接从服务器备注复制一小段,比手打整条名称更可靠。
从更新阶段定位空列表
更新失败时,先确定错误发生在请求前、响应读取中,还是记录解析后。如果连请求都没有发出,检查分组是否保存、是否启用了该组以及选中的更新动作是否正确。如果日志出现证书或时间错误,先校正系统时钟并检查连接路径,不要用放宽证书验证来掩盖问题。若日志显示已取得响应但没有可导入项目,则暂时移除分组过滤,在独立测试组重试。撤掉过滤仍不能导入时,请向来源确认输出格式和链接状态,而不是继续调整业务路由。
有些来源只能通过特定网络路径访问。直连更新与经当前代理更新应当分别验证,不能把可用服务器也删掉再测试后者,否则会失去更新所需的连接。对 Android,可按同样思路检查 v2rayNG 或 v2flyNG 的订阅管理,但不要假定桌面端的分组字段能逐项迁移。安装包和平台入口见获取客户端;更新错误的具体定位见订阅更新失败与自动更新间隔。
路由规则实战:匹配顺序与默认出站
先确认请求进入内核
路由规则只处理已经进入代理内核的流量。系统代理模式下,遵守系统代理设置的应用通常会把请求交给客户端;拥有独立代理设置的应用可能坚持走另一条路径。TUN 模式扩大了接管范围,但系统路由排除项和应用自身行为仍会影响结果。因此,测试某条规则之前,应先用一个确定经过客户端的应用产生请求,检查运行日志是否记录了这次连接。日志完全没有请求时,不能凭目标访问成功或失败来推断路由是否匹配。
在 v2rayN 的路由配置中,先复制当前能用的方案,再编辑副本。记录三个信息:规则按什么顺序运行,命中后指向哪个出站,没有命中时默认走哪里。例外项一般应放在更宽泛的匹配之前,例如只希望一个子域通过指定出站,应把该子域的规则放到覆盖整个父域的规则前面。不要只凭规则名判断范围:精确域名、域名后缀与关键词匹配的对象不同,后缀匹配往往已经包含了符合边界条件的子域。
分别验证域名匹配和地址匹配
内核看到的是域名还是地址,取决于入站方式和应用发来的目标形式。若应用已自行解析并把地址交给客户端,一条只看域名的规则通常不能直接匹配这个地址。某些入站可以借助协议嗅探获得域名,但要服从所用协议和入站设置,不能把嗅探视为所有连接的默认行为。反过来,如果传入的是域名,地址规则能否命中则取决于内核是否为路由判断补做解析。测试时用独立的地址目标验证地址规则,用可控域名验证域名规则,不要把两类结果混在一起。
| 域名策略 | 路由阶段的解析时机 | 排查重点 |
|---|---|---|
AsIs | 不为路由匹配主动解析目标域名。 | 不要期待仅靠地址规则匹配传入的域名。 |
IPIfNonMatch | 第一轮没有命中时,尝试解析域名并重新匹配。 | 提前命中的宽泛规则可能让地址匹配没有机会执行。 |
IPOnDemand | 判断到需要地址信息的规则时,可触发解析。 | 地址类规则的位置会影响解析何时发生。 |
用对照请求定位错误规则
假设要让本机管理网段直连、某个测试域名走代理。先添加明确的私有网段例外,再添加测试域名规则,最后确认默认出站。准备三类请求:一个已知存在的管理地址、一个命名规则目标、一个不受管理且未列入规则的对照域名。每次只发起一个新连接,记录入站、目标形式和出站标记。应用可能复用已经建立的连接,因此切换规则后应关闭旧连接,必要时重启测试应用;仅刷新一个复用连接的页面,不能证明新策略未生效。
若显式例外正确、其他所有目标却走了非预期路径,问题多在兜底项或默认出站。若只有依赖规则库的项目异常,则先用精确域名或明确网段重做一条最小规则,确认顺序和出站本身无误,再核对规则库的标签与加载日志。不要同时更新规则库、切换内核和修改 DNS;这些操作都能改变结果,却会使比较失去意义。需要进一步阅读日志时,参见常见报错含义与逐条定位方法。
DNS 配置优化:解析来源与请求路径
区分应用解析、系统解析和内核解析
排查 DNS 的第一步不是换解析器,而是确定谁在查询。使用系统解析的应用受操作系统网络配置影响;启用了独立加密解析的浏览器可能直接连接自己的上游;代理内核也会在匹配地址规则、解析服务器地址或处理接管到的 DNS 请求时查询域名。这些行为可以同时存在。即使在客户端填写了远程 DNS,也不能断定系统中的每条查询都改走该上游;浏览器请求的网站走代理,同样不能反推出该网站的域名已经由代理内核解析。
建立基线时先保留现有连接模式,选一个普通公开域名和一个必须由局域网解析的名称。核对公开名称能否得到合理结果,局域网名称是否仍返回内部地址。如果普通查询正常而内部名称失败,应先确认内部域有没有被交给仅认识公有记录的解析器。涉及组织内部名称时,用管理员提供的测试目标并遵守网络策略,不要把真实内部域交给外部解析服务做对照。
配置上游和分域规则
在 v2rayN 的 DNS 设置中,先确认当前核心以及当前使用的是普通界面生成配置还是自定义配置。不同核心的 DNS 结构并不通用。在界面支持分配解析器的情况下,一般先配置负责内部名称的上游,再配置普通查询的默认上游。这里的「远程」只能说明上游不在本机,不能说明连往上游的请求一定被代理。对加密 DNS,还要同时确认所用地址格式、连接上游时的路由,以及上游自身使用域名时的首次解析路径。
如果把代理服务器域名和加密 DNS 上游域名都交给只能在代理建立以后使用的解析链,启动时可能形成循环:内核需要先解析服务器才能连通代理,但解析器又要等代理可用才可访问。典型现象是切换设置后首个请求超时,而暂时还保持着旧连接时却看不出问题。验证办法是恢复原先的解析方式,退出客户端并重新启动,确认可以冷启动后再逐项启用。如果原始路径能启动,优先为连接建立阶段提供独立可达的解析路径,而不是加长超时等待。
逐项比较解析结果与访问结果
验证时,先观察日志中的解析错误,再单独检查目标连接。出现没有可用记录、请求超时或返回地址族不符合预期时,先检查上游和查询策略;有记录却连接失败时,再检查出站是否能到达该地址。双栈环境中,某个地址族连接失败不等于解析失效。要把 IPv4 和 IPv6 的查询结果、应用最终选择的地址以及实际连接错误分别记下。不要为了让单个测试通过,就把限制永久套到所有解析器和所有应用。
配置切换后,应用缓存、系统缓存与客户端缓存不一定同时失效。先关闭旧连接,使用一个未测试过的受控名称或重启测试应用,再比较不同路径的结果。必要时在相同连接模式下暂时停用浏览器的独立解析功能,以帮助区分查询来源;测试完再恢复原有设置。如果只在使用浏览器测试时看到不同结果,先查该浏览器的解析选项,不要仅凭一个页面报告断言系统解析路径发生变化。验证口径与具体操作可对照DNS 泄漏检测与防泄漏设置。
TUN 模式:接管范围、排除项与回退
按应用需求选择接管方式
系统代理是提供给应用的连接配置,应用可以采用,也可以忽略。TUN 则通过虚拟网络接口和系统路由把符合条件的流量交给客户端的处理链。它适合需要覆盖不使用系统代理的应用,或要分析应用在不同传输方式下的行为,但并不意味着任意流量都会沿同一出站发送。路由排除、本地接口、地址族支持和应用自身连接方式共同决定实际路径。已经通过系统代理正常工作的场景,不必仅为取得相同结果而引入新的接管层。
启用前,记录当前的网络接口、局域网访问状态、客户端连接模式和 DNS 设置,确认能够关闭功能并恢复原配置。桌面端优先用 v2rayN 验证,并按所选系统确认是否需要相应权限或服务。Android 上的 v2rayNG 与 v2flyNG 使用系统提供的网络接管能力,界面术语不一定与桌面相同。已有其他虚拟网络或工作网络接管时,先核对是否允许并行使用;在组织管理的设备上,应由管理员确认策略,而不是自行移除管理组件。
先验证接口,再验证应用
按客户端界面启用 TUN 后,先检查核心日志是否出现接口创建、路由或权限错误。开关显示开启不等于系统路由已经应用,也不代表 DNS 和 UDP 都已按同一种方式处理。接口稳定后,先测试一个原本能经系统代理访问的目标,再测试一个不依赖系统代理的应用。为了让对照有效,记清测试期间系统代理是开还是关;如果两者同时开启,应用先交给系统代理的请求并不能说明 TUN 成功接管了它。
局域网访问失败时,先用已知有效的管理地址测试,再用相应局域网名称测试。前者失败,检查目标网段是否应保留在直连路径、是否与虚拟地址池重叠,以及系统路由实际选择了哪个接口;前者成功而后者失败,则优先检查内部名称的解析路径。不要随意排除整个大地址段来恢复单一服务;排除范围应与实际的本地子网一致,否则本应被接管的其他连接也会被绕开。
定位回环与切换后断网
如果启用后所有访问都失效,考虑代理服务器自身的连接是否又被导回虚拟接口。先停用 TUN 并验证该服务器仍可连接,再查看客户端是否支持自动选择出口接口,以及多网卡环境中选中的出口是否对应当前活动网络。经有线、无线或已有虚拟网络切换后,先前保存的接口绑定可能不再适用。配置需要人工指定时,只绑定已确认的接口或使用客户端支持的排除机制,并且保留可恢复的原值。
如果只有一类应用异常,不要直接归因于代理服务器。分别测试短连接和持续连接,记录是建立前失败还是传输一段时间后失败。若小请求稳定而较大传输经常停滞,可以在其他条件不变时检查虚拟接口的 MTU 是否适合当前路径;若仅 UDP 业务失败,则检查 TUN 接管、客户端规则和目标出站是否分别支持该流量。恢复时先关闭 TUN,再确认系统代理和 DNS 是否回到预期状态。设备休眠或网络切换后复现的问题,应在相同网络环境下重测;手工重启应用只是恢复手段,不是定位结论。
FakeDNS:域名映射与启用条件
理解虚拟地址的用途
应用在发起连接前通常先解析域名,再把得到的 IP 地址交给网络接口。如果流量接管层只看到这个地址,以域名为条件的路由就缺少直接依据。FakeDNS 的处理思路是给被接管的查询返回一个虚拟地址,在内核中保留该地址到原始域名的映射。应用连接到虚拟地址后,接管链路再根据映射恢复域名,供路由或出站处理。虚拟地址不是目标服务器的真实记录,也不是某个固定的出站标识;同一个地址脱离创建它的映射状态就没有原先的含义。
这个机制依赖两个条件:查询进入提供映射的解析链,后续连接也回到能够识别映射的处理链。只把 DNS 查询交给 FakeDNS,却让连接绕开客户端,应用便可能拿着虚拟地址访问无效路径。反过来,如果应用使用自己的解析器取得真实地址,TUN 即使已经接管连接,也不能从这条连接中得到并不存在的 FakeDNS 映射。这是为什么「启用了 TUN」与「应用正在使用 FakeDNS」需要分别验证。
只在基本链路稳定后启用
先在 FakeDNS 关闭的情况下确认 TUN 能工作、普通域名能解析、局域网服务能访问。记录当前核心和使用的 DNS 方案,再确认客户端是否为这套核心提供完整的 FakeDNS 入口。不要将某个核心的虚拟地址池字段复制到另一个核心,也不要只写入虚拟池参数而不检查 DNS 规则和入站恢复配置。启用之后,应从新启动的测试应用发起一次访问,核对接管到的查询、返回的地址类型、还原后的目标名称和最终路由结果是否能对应起来。
地址池必须避开设备上已使用的网络、组织内部路由以及其他虚拟接口所占范围。即使某个地址段在公网上不用于常规服务,也不能据此认为本机环境一定不会使用它。判断冲突时要比较整段范围,而不是只看两个起始地址是否相同。对同时使用 IPv4 和 IPv6 的环境,也应分别测试两种查询类型;观察到一种地址得到虚拟映射,不代表另一种地址的查询已经进入同一条链路。
为内部服务保留真实地址
某些应用会把解析结果存下来,交给其他进程或设备使用,也有应用直接依赖服务的真实地址进行发现或访问。这些情况不适合只按普通网页的成功结果来判断兼容性。对于需要真实地址的内部域和特定业务,先检查配置是否支持按域名走普通解析,再用一个确知可达的地址作对照。不要以把虚拟地址范围加入直连规则的方式修复问题,因为这样会跳过本应恢复域名的步骤。
启用后若首次访问正常、重启核心后出现一段时间的超时,可能是应用仍缓存旧虚拟地址,而新进程中已经没有相应映射。回退时先关闭 FakeDNS,恢复普通上游,重新建立客户端连接,再清理测试应用的旧连接与相关缓存;不要把未执行清理的测试结果当作策略仍在生效。如果目前只能确认接口接管成功,无法确认域名恢复与内部服务正常,保留普通 DNS 更容易维护。地址池和兼容场景的进一步说明见FakeDNS 原理与开启前的注意事项。
多订阅管理:刷新顺序、切换与回退
用来源管理差异,不用备注合并记录
单个分组解决的是一批服务器如何导入,多订阅管理解决的是某个来源异常时,其余来源能否保持可用。建议为不同来源分别建立分组,用稳定的名称区分主用、备用与测试用途。若同一个来源提供两种不同格式,也宜先分别导入测试,确认差异后再决定保留哪一个。多个组内出现相同备注并不等于它们指向同一个服务器;地址、协议、传输或认证参数不同,都可能让连接行为不同。不要为了清理列表,凭显示名称批量删除同名记录。
在 v2rayN 中更新前,先确认当前连接使用的是哪一组,确认该组更新后是否会替换原有记录。如果当前节点来自即将更新的主用组,先用备用组独立完成连接验证,然后再更新主用组。若测试用途需要保留手动修改的服务器条目,应将其放到不受订阅刷新覆盖的位置,并确认改动符合来源的使用条件。不能把订阅定义和仅在本机生效的手动调整混为一谈;客户端重新导入时往往还是以来源返回的定义为准。
为更新安排明确的网络路径
订阅更新本身是一条访问订阅地址的请求,与列表中的服务器连接不是一回事。某个订阅可直连更新,另一个可能只有通过当前可用连接才能取到。应先单独确定每个来源的更新路径,再使用批量刷新。若客户端只能为整个更新操作选择一种路径,优先手动刷新有特殊条件的分组,不要把某一组的网络条件套到所有来源。出现间歇性失败时,记录失败是否总发生在刚唤醒、刚切换网络或刚换服务器之后,再调整刷新时机。
自动更新间隔应按实际变更频率、提供方限制和客户端支持的粒度设置。设置过密会放大短暂断网、限流和解析故障的影响,也不保证服务器一变动就能立即获得。开启自动更新前应完成至少一次独立的手动刷新,确认更新动作没有移除备用组,能够区分失败、返回空集和正常删除。对客户端没有独立调度选项的场景,保留可预测的手动刷新顺序,比假定后台一定会按时运行更可靠。
建立重复可执行的换组流程
先选定一个普通公开目标作为连接基线,再为需要验证的业务准备第二个目标。服务器切换后先请求基线,确认入站和出站正常,再请求业务目标,以区分服务器不可用和规则只对某个目标不适用。若测试必须覆盖 UDP,则再单独测一种真实使用的 UDP 业务;即便普通网页可打开,也不足以证明所有协议和出站都工作。请记录切换前后使用的分组与备注,但不要把含凭据的订阅网址、完整配置或分享链接贴进公开排错记录。
主用组刷新后突然变空时,先暂停该组自动更新或停止重复刷新,保持其他组不变,再用分组与过滤一章的对照方法判断原因。若备用组仍正常,可先维持工作连接,再单独检查主用来源。备用组也同时失败时,优先排查共享依赖,例如系统网络、解析器、接管模式和证书时间,而非逐条编辑服务器。Android 上迁移设置时,先确认订阅本身支持相应核心,不把桌面路由与自动更新时间当成可直接复用的字段;常见安装和切换问题可查常见问题。
自定义出站:标签、规则与最小配置
确定何时需要自定义
出站定义连接由谁处理,路由定义请求在什么条件下交给该出站。桌面端只是切换当前订阅服务器时,通常使用界面生成的出站即可。只有确实需要为不同目标使用不同处理方式,或要验证内核字段是否按预期生效时,才值得维护自定义配置。首先确认 v2rayN 当前条目的配置模式与所选核心。界面生成的临时配置可能在切换服务器或重启后重建,手改这类文件不是可维护的配置方法;应保留客户端支持导入的独立文件,并记录负责加载它的条目。
使用自定义文件时,不能假定普通订阅条目里的路由、DNS 和入站设置一定会合并进去。应核对当前模式的加载范围:是交由内核独立读取整份文件,还是由客户端生成外层结构。随后检查每个出站的标签是否唯一,规则所指的标签是否真实存在,以及不匹配规则时会交给哪一个出站。标签本身没有网络含义;写成 direct 不会自动建立直连,写成 proxy 也不会自动从订阅提取服务器。
在回环地址上验证直连与拒绝
以下是可独立交给 Xray 核心的完整最小配置。它建立仅本机可访问的 SOCKS 入站,用第一项出站直连未匹配目标,并把精确域名 example.net 交给拒绝出站。示例不依赖远端服务器或凭据,适合验证规则和标签,不是可叠加到任意客户端导出文件中的片段。端口若已被占用,需同时更改配置与测试应用的连接设置。
{
"log": {
"loglevel": "warning"
},
"inbounds": [
{
"tag": "local-test",
"listen": "127.0.0.1",
"port": 11080,
"protocol": "socks",
"settings": {
"auth": "noauth",
"udp": false
}
}
],
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "reject",
"protocol": "blackhole",
"settings": {}
}
],
"routing": {
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"inboundTag": ["local-test"],
"domain": ["full:example.net"],
"outboundTag": "reject"
}
]
}
}
通过选定的 Xray 核心加载后,将支持 SOCKS 的测试应用连接到 127.0.0.1:11080,并让应用把域名而不是预解析后的地址交给 SOCKS 入站。访问 example.net 时,该连接应被拒绝;访问另一个已知可直连的公开域名时,应走直连。如果两个目标都失败,先排查监听端口和测试应用是否使用了该入口。若只有拒绝没有发生,检查是否用了其他主机名、是否已经在应用本地解析,或者实际上复用了旧连接。此示例不启用 UDP,也不测试 TUN;不要用它来判断应用的 UDP 支持。
从最小文件逐步扩展
需要增加远端出站时,根据有权使用的服务器所提供的协议和传输参数,在 outbounds 中新增唯一标签,再加一条窄范围的域名规则引用它。保持已有直连与拒绝对照不变,先验证新规则确实选择了新出站,再单独确认远端握手。出站支持的协议与传输组合取决于核心,不能只改协议名称就沿用旧认证和传输字段。选择协议前可先看VMess 与 VLESS 的认证、加密和传输差异,再对照来源给出的实际配置。对于组合出站,还应检查代理服务器自己的域名解析和连接路径是否能脱离这个新出站独立建立。
最后把自定义文件与日常使用配置分开,保留原来已验证的客户端条目。接回业务前重做三组检查:目标是否进入预期入站、匹配是否选择预期标签、出站是否成功完成连接。仅在其中一段异常时,只回退那一段;遇到启动失败,先切回日常条目并恢复原本的系统代理或接管设置,再脱离业务流量验证自定义文件。保留一份能重现最小用例的配置,比保留一份只能在当前设备上偶然运行的完整配置更有排查价值。