配置参考 / v2rayN
v2rayN 进阶配置手册
第一次安装、导入订阅或验证连接,请先走完快速上手。这份手册从已经能建立连接的配置出发,按订阅来源、流量入口、名称解析和出站去向拆开设置。桌面端首推 v2rayN;若还没选安装包,先到客户端下载核对平台与架构。
订阅分组与服务器过滤
先标记来源,再整理名称
打开 v2rayN 的「订阅分组设置」,先为每个订阅填写能识别来源和用途的备注,例如「日常使用」与「维护备用」。备注用于识别分组,不会改写服务器地址,也不会进入路由条件。同一份订阅即使换了本地备注,服务端返回的服务器记录仍取决于订阅地址。反过来,两条订阅里出现相同名称,也不能证明它们来自同一个地址或使用同一份连接参数。整理清单时先按来源分组,再看服务器备注,比直接在「全部」视图里逐条重命名更容易复核。
手工添加的服务器也要和订阅管理的记录分开对待。需要长期保留的测试配置,不宜只留在会随订阅刷新而变化的列表里。先确认本地保留方式,再对订阅组做清理。若客户端允许复制配置到独立分组,复制后确认新记录不再依赖原订阅刷新;否则把它作为独立配置维护。不要用显示顺序标记常用服务器:来源一更新,排序和备注都可能改变。选中某条记录和让它成为当前活动服务器也是两件事,操作后要看主窗口的活动状态。
把显示筛选与更新过滤分开
列表搜索适合临时查找,清空搜索后原有记录应重新出现。订阅设置里的过滤则可能参与导入或更新,决定这一轮有哪些记录进入分组。两者的验证方法不同:测试列表搜索时不需要再次拉取;测试订阅过滤时应在目标组执行一次更新,再核对实际保留的记录。若界面有独立的筛选输入框和订阅「过滤」字段,先用界面提示确认各自作用,别把两个输入框当成同一个持久规则。
若当前版本的过滤字段明确支持正则表达式,可以从简单的匹配开始。下面的表达式只匹配以「备用」或「测试」结尾的备注,允许末尾留有空白。它不表示必然保留或排除这些记录;方向取决于该字段的说明。先用已知会命中和不会命中的各一条备注试验。不要把完整订阅链接、账户标识或连接参数当成匹配样本,也不要把普通搜索框是否识别竖线当成正则支持的证据。
(备用|测试)\s*$
从空列表恢复到可验证状态
更新后分组变空,先取消列表搜索和其他视图条件,再看更新日志是否收到可解析的记录。拉取失败、解析结果为空、过滤后为空,表面都是没看到新条目,但恢复动作不一样。拉取失败先确认更新所用的网络路径和订阅是否仍有效;解析结果为空先核对来源返回的格式;过滤后为空则暂时清掉过滤表达式,只更新当前组并重新计数。不要把「所有组更新」当作第一步,否则其他组同时变化,容易掩盖是哪项设置造成差异。
如果只剩少量记录,抽查备注格式是否变了。末尾新增说明词、全角括号换成半角、标签从尾部移到前面,都能让原先的表达式漏选。适宜的做法是把表达式收窄到确实稳定的命名约定;当上游没有稳定格式,宁可用临时列表搜索,也不要绑定一条过细的导入规则。过滤能整理显示或导入结果,不能判断协议是否兼容,更不能代替连接测试。确认列表恢复后,再对一个已知可用的服务器验证活动状态和实际请求。
路由规则实战
先区分流量入口和出站匹配
路由规则只处理已经交给内核的流量。浏览器采用系统代理时,请求可能先进入客户端;未采用系统代理的应用,通常不会因此自动进入同一个入口。判断规则无效之前,先确认当前应用的连接确实经过客户端。可在应用里显式使用客户端监听的本地代理做对照,也可在适用的平台检查 TUN 入口。规则不是操作系统的全局网络开关;改一条规则不会自动让原本绕过客户端的进程进入内核。
在 v2rayN 的路由界面选中当前使用的规则集,再调整单条规则。新建但未启用的规则集不会接管正在运行的配置。对于按顺序处理的 Xray 路由,优先匹配范围窄的例外,再放一般规则,最后考虑兜底。多个匹配字段写在同一条规则里时,通常要求同时成立;如果目的是「某个域名或某段地址都直连」,宜分别建立域名规则与地址规则,而不是期待一条同时写有域名和地址条件的规则表达「或」。
用可控域名验证顺序
下面是 Xray 配置中可替换的 routing 对象,不是完整配置。保留现有配置的入口和其他字段,并确保已有 direct 与 proxy 两个对应的出站标签。示例把公共示例域及其子域送到直连出站,其他 TCP 或 UDP 流量送到代理出站。实际使用时可把示例域替换为有权测试、能稳定访问的域名。若在图形界面编辑,应按界面的字段拆填,不要把整个对象粘进单个域名输入框。
{
"domainStrategy": "AsIs",
"rules": [
{
"type": "field",
"domain": ["domain:example.com"],
"outboundTag": "direct"
},
{
"type": "field",
"network": "tcp,udp",
"outboundTag": "proxy"
}
]
}
domain: 筛选域名及其子域;只要精确匹配单个主机名时,可用 full:。如果入口只收到一个 IP 地址,AsIs 不会把该地址反查成请求域名,域名例外就可能不命中。部分入口可从能识别的连接内容里获得域名,但结果受协议、入口设置和流量形态影响。不要把嗅探当作所有连接都能恢复域名的承诺。需要覆盖已经按字面 IP 发起的连接时,再为已确认由自己管理的目标地址单独写地址条件。
按顺序核对命中和结果
先做命中测试,再做业务测试。对例外目标和一个不匹配例外的目标分别建立新连接;若日志能显示入口、目的地或出站标签,逐项核对。浏览器的连接池会复用旧连接,网页能继续打开并不证明新规则生效。最好结束旧连接或换一个干净的测试会话。确认标签正确后,再看连接是否真正完成。命中 direct 但服务打不开,可能是目标本身在当前网络不可达;改成别的标签前,先确定该目标本来应该从哪条路径可达。
如果使用 geosite 或 geoip 集合,把资产文件是否存在、分类是否包含目标和规则顺序分开检查。分类数据随更新变化,不能用分类名推断某个域一定在其中。排查时先改用一条明确的域名规则做对照,再决定是否恢复集合。未命中任何规则时,Xray 通常使用出站列表中第一个出站;示例显式放了兜底,正是为了不依赖列表顺序。保存前记录旧规则集,遇到大范围异常可先切回,而不是继续叠加例外。
DNS 配置优化
从实际发起查询的一层入手
同一台设备上,操作系统、浏览器和代理内核都可能解析名称。系统 DNS 服务于使用系统解析接口的应用;浏览器可能有自己的安全 DNS;Xray 的 dns 对象提供内核侧的解析能力。三者不一定用同一上游,也不一定拿到同一答案。改了客户端的 DNS 设置后,系统网络面板仍显示原地址,不足以判断修改失败。要先知道应用从哪一层取得答案,再去看那一层的查询路径。
还要区分目标域名与代理服务器域名。目标域名是应用要访问的服务;服务器域名则可能在代理连接建立之前就需要解析。若负责解析服务器域名的查询必须先借助这条尚未建立的代理,就会形成循环。排障时先确认服务器的解析与连接能独立建立,再调整目标域名的查询策略。分流里的「DNS 请求从哪个出站出去」和「目标连接最终从哪个出站出去」同样是两件事,不要用一个结果替另一个下结论。
明确上游、地址族和生效边界
下面是 Xray 的最小 dns 对照对象,把它放在完整配置的顶层 dns 字段。这个例子用地址形式指定公共 DoH 服务,避免示例自身额外依赖对上游主机名的解析,同时将内核这部分查询限制为 IPv4。上游仍需能从执行查询的路径连接;在有企业解析或内网区域的网络里,应保留组织要求的解析器。该对象不会把所有应用的 DNS 自动切换到内核,也不会改变系统接口的 DNS 设置。
{
"servers": ["https://1.1.1.1/dns-query"],
"queryStrategy": "UseIPv4"
}
| 检查项 | 作用 | 验证线索 |
|---|---|---|
servers | 为内核 DNS 配置上游 | 对照内核日志和上游连通性 |
queryStrategy | 限制内核查询使用的地址族 | 对照 A 与 AAAA 记录及实际可达性 |
| 浏览器安全 DNS | 控制浏览器自己的解析路径 | 用同一应用与同一目标重测 |
只请求 IPv4 适合作为定位手段,例如想确认失败是否由不可达的 IPv6 路径引起。若目标只提供 IPv6,或本地网络依赖 IPv6,这个设置会少拿到必要的答案,不宜作为通用优化。启用双栈时,解析到某个地址也不代表系统一定有到该地址的可用路由。用同一目标分别检查两个地址族,记录是查询没返回、连接没建立,还是应用在已有连接上重试。不要以一次打开网页的快慢评估 DNS 策略。
验证缓存、分区解析与回退
有些名称在办公网络里应由内部解析器返回,交给公共上游可能得到不同答案或根本找不到。先挑一个内部目标和一个公开目标作为对照,分别确认解析器、答案适用的网络以及实际连接路径。需要做域名分配时,先明确专用上游负责的名称范围,再设置其他域名的默认上游。不要用公共解析结果覆盖企业内部记录,也别把同一域名因网络位置而返回的不同答案一律判成错误。
修改后尽量使用新连接验证,并留意系统、浏览器和内核各自的缓存。命令行查询工具常直接询问某个解析器,可以验证上游响应,却不能单独证明应用走了同一条路径。若现象只在浏览器出现,再对照该浏览器的安全 DNS 和缓存;若只在 TUN 下出现,则检查 DNS 是否真的被 TUN 接管。回退时先恢复原上游和分配规则,再重测原始样本。遇到解析成功但页面仍打不开,可沿常见问题继续区分连接与应用层错误。
TUN 模式
确认应用为什么需要虚拟接口
系统代理通常为遵循代理设置的应用提供一个转发入口;TUN 则通过虚拟网络接口和操作系统路由接收选定的 IP 流量。它常用于没有独立代理设置的桌面应用,但是否接收到流量,仍取决于系统路由、客户端配置和应用行为。TUN 不等于新增一条代理线路,也不会替代内核中的路由规则。可以把它理解为换了流量入口:入口收到请求后,才轮到规则判断直连、代理或其他去向。
先在 v2rayN 现有模式下确认活动服务器可用,再检查主窗口的「开启 Tun」入口。不同桌面平台的权限提示、虚拟接口创建方式和内核实现可能不同,按客户端提示和系统管理流程处理即可,不要为了排查而关闭整套系统保护。若 macOS 在打开程序或授权阶段就有提示,先读macOS 安装与网络权限说明,确认是应用启动、系统代理还是网络权限的问题,别把三个阶段当作同一种失败。
用隔离变量的方法切换
启用前记录原系统代理状态、活动服务器和当前路由集。若条件允许,先关闭会重复接管同一测试应用的系统代理,并确保清理的是本次客户端设置,别覆盖原有的组织代理。暂停其他由自己管理且可能争用路由的工具,保持服务器与 DNS 配置不动。开启后先看客户端与内核是否启动成功,再看虚拟接口是否出现,最后确认测试目标的实际流量进入了该接口。三项依次验证,比看到开关变色就开始改更多设置可靠。
验证时至少选两类目标:一个原本应通过代理的应用请求,一个原本应走本地网络的服务。若公共目标可用但打印机或内部服务失联,先区分名称解析和地址可达性;同一设备可能按地址可达,但依赖局域网发现的应用看不到它。多播、广播和链路本地通信与普通网页请求不同,不能用网页正常推断设备发现也正常。保留本地服务所需的系统路由,按客户端实际支持的排除范围做对照,并检查网段有没有与另一块虚拟接口重叠。
定位断网、回环与休眠恢复
打开 TUN 后大范围断网,先关闭并确认原模式恢复,再重开一次收集最早出现的报错。接口建立失败优先查权限、驱动或并行虚拟接口;接口已建成但连接不断重试,则查默认路由和代理服务器自身的出站路径。如果内核连接服务器的流量又被送回同一个虚拟接口,可能形成回环。此时应检查客户端如何保护自身连接以及它选用的物理出口,不能靠把所有目标改为直连来掩盖入口问题。
只有个别应用异常时,先判断它是否复用了开启前的连接,再对照地址族和传输类型。网页使用较小请求能成功,而长连接或较大传输经常停住,也可能与路径可承载的报文大小有关。不要盲填网上抄来的接口参数;应记录原值,确认环境特征,再单独试一个调整。设备从休眠恢复或切换网络后,也要重新核对默认出口与虚拟接口状态。关闭 TUN 后如仍无法联网,先核对系统代理是否还指向本地端口,以及由客户端添加的路由是否已撤销。
FakeDNS
理解合成地址的用途
FakeDNS 向符合条件的域名查询返回一个合成地址,并在内核中记录域名与该地址的对应关系。应用拿到地址后发起连接;如果连接又回到持有映射的入口,内核就有机会恢复原域名,按域名规则处理。这个过程并不意味着远端服务真的位于合成地址,也不意味着建立连接时可以省掉所有实际解析。使用直连或需要真实地址的出站时,仍要在适当的一层把真实目标解析出来。
FakeDNS 依赖查询和后续连接形成闭环。应用用自己的解析器从系统之外拿到真实地址时,合成流程可能根本没发生;应用拿到了合成地址,后续连接却绕开客户端时,也无法利用映射。后者常表现为解析工具给了答案、应用却连不上。启用前应先在普通 TUN 与普通 DNS 下拿到可重复的基线,确认目标应用既能把查询交给预期的解析入口,也能把后续 IP 连接交给同一个负责恢复映射的内核。
范围、映射池与排除对象
下面是 Xray 顶层 fakedns 字段的一种最小对照片段,展示地址池与容量写法。它只定义池,不会独立启用合成解析。完整链路还需让内核 DNS 对选定请求使用 FakeDNS,并在接收连接的入口配置支持恢复域名的嗅探。图形客户端若已经生成相关配置,优先检查现有配置,不要为同一入口叠加第二套池。具体界面选项取决于客户端与所选内核。
{
"fakedns": [
{
"ipPool": "198.18.0.0/15",
"poolSize": 4096
}
]
}
池范围必须和本地网段、实验网络及其他虚拟接口的地址用途区分开。示例范围用于对照,不表示在每个设备上都没有冲突。容量也不是越大越好:映射需要在应用使用合成答案的期间仍可找回,频繁的域名查询与长时间保留的应用缓存会增加错配或映射失效的风险。先在用途明确的一组域名上验证,再扩大范围。要拿真实地址做本地发现、企业登录或设备管理的应用,应优先保留其现有解析路径,不把内部服务一并纳入初次试验。
按症状找缺失的一环
看不到合成回答时,先确认应用有没有自带解析或缓存,然后确认请求实际进入了哪一个 DNS 入口。能得到合成回答、但路由看不到原域名时,核对应用的连接是否进入正确接口,入口是否启用了相应恢复能力,以及应用使用的地址是否仍在当前池的有效映射中。已经看到正确域名和出站标签却连不上时,排查应转向出站自身与目标真实地址的解析,而不是反复调整池容量。
不要用浏览器打开一个合成 IP 来验证网站身份。直接访问 IP 会改变请求语义,也可能不会带上应用原本应该使用的主机名。应通过应用按原域名创建新连接,再核对日志中恢复的域名与命中出站。测试结束关闭 FakeDNS 时,先恢复原来的 DNS 选择,再终止还保留合成答案的测试会话;必要时按应用和系统的正常流程清理缓存。若客户端刚重启而应用复用了旧的合成回答,也应重新查询,而不是期待新进程无条件沿用上一次的映射。
多订阅管理
把来源、更新和日常切换分开
持有多份订阅时,一份来源对应一个分组。分组备注可以表达责任边界,例如日常使用、短期测试或保留旧配置。不要把供应来源、当前线路品质和协议类别全部压进同一个名称里:来源相对稳定,线路状态随时间变化,协议还可能随着上游更新而变化。组备注只需要回答「这批记录从哪里来、为什么保留」。服务器备注则帮助在这一组内识别条目,两层名称没必要重复堆叠。
第一次添加新来源,先手动更新当前组。查看是否收到可解析的列表、条目是否符合预期、常用协议是否与所选内核相容,再决定自动更新。桌面端使用 v2rayN;Android 上的 v2rayNG 与 v2flyNG 不应只按界面相似程度选择。订阅里的协议、传输配置和内核支持需要成套核对;可参考Xray 与 V2Fly 内核区别。成功显示一条记录,只代表客户端识别了足够的信息,不等于运行时一定支持这份参数组合。
给更新留出失败边界
自动更新适合来源稳定、手动更新已验证的订阅。设置间隔时优先考虑来源允许的频率和实际变更节奏,不需要用高频刷新来探测服务器状态。尽量分开更新不同来源,便于把报错对应到一个具体组。更新订阅的网络请求与使用订阅中服务器建立代理连接不是同一过程。更新失败时,现有连接可能仍正常;列表刚更新成功时,新服务器也可能尚未验证。这两个状态应分别记录。
若界面提供不同的更新路径,先用当前已知可达的方式测试目标来源。通过当前代理更新时,要考虑代理失效后是否还有独立的恢复路径;改成直连更新之前,也要确认来源本来就允许并可从该网络访问。不要在某一份订阅失败后直接清空全部分组。先保留现有可用条目,核对失败出现在请求、响应解析还是导入阶段,再决定是否只暂停这一组的自动更新。
应对内容变更、重复项和链接轮换
上游更新会增删记录,也可能改名或更换参数。同名不一定重复,不同名也不一定是两条独立线路。清理之前至少核对协议、地址、端口与传输方式,且不要把凭据复制到公开记录。不确定刷新是覆盖还是合并时,先对一组执行一次手动更新,比较活动服务器、新增条目与消失条目。重要线路消失时,不必立刻修改整份路由:先选择已验证的备用来源恢复连接,再单独检查原组变化。
订阅地址换发时,可在条件允许的情况下将新地址放进单独分组做短期验证:先更新,再检查协议兼容性,然后完成一次实际应用请求。确认可以接替之后再停用旧组的更新,最后视需要移除旧记录。若来源不支持两个地址并存,则先记录组名、过滤条件与选中的服务器,并保留另一条已验证的连接路径,再替换地址。订阅链接往往包含账户凭据,分享排障信息时只提供组备注、失败阶段和经过清理的报错,不贴原始链接或完整导出。
换设备迁移也要遵循同样的边界。先迁移一份必要的来源,确认客户端与所在网络都能使用,再迁移过滤和自动更新设置。不同设备的活动服务器、系统代理状态和本地接口不同,不能仅靠导入一份清单复现整套运行环境。整理结束后,留一份不含连接机密的维护记录:来源用途、更新方式、测试目标和最近一次成功处理的故障。
自定义出站
先定义职责,再选择配置入口
出站描述内核怎样处理一条已经接收的连接。它可以按系统网络直接连接,也可以用指定的代理协议转发,或明确拒绝连接;路由规则用 outboundTag 引用相应的出站。服务器记录是客户端管理连接参数的方式,出站是运行配置中的执行对象,两者并非总是一一对应。自定义出站适合需要稳定引用多个处理分支的场景。如果只是临时切换当前服务器,主窗口的活动服务器与路由集通常已经够用。
先确认 v2rayN 界面允许编辑哪些设置,以及当前运行的是客户端生成的配置还是自行维护的完整配置。直接改一次运行时生成的文件,下一次保存、换服务器或重启时可能被覆盖。若用自定义配置入口维护完整文件,就要同时承担入口、DNS、路由和出站之间的关联;不能期待图形界面的每个设置都自动合并进去。开始前保留可正常启动的配置,记录本地监听端口和当前路由集,方便确认回退后应用重新接入了正确的入口。
用明确标签组合出站与路由
以下是 Xray 的顶层配置片段,定义了两个行为不同的出站。direct 使用 freedom 直连,blocked 使用 blackhole 拒绝连接。它不是一份带入口的完整配置,也不含代理服务器。合并时保留现有出站,在同一个数组内增补所需对象;如果已存在同名标签,应复用或明确改名,而不是粘贴重复项。用于引用的标签必须和路由规则中的字符串逐字一致。
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
},
{
"tag": "blocked",
"protocol": "blackhole",
"settings": {}
}
]
}
只有规则命中 blocked 时,该分支才会按预期拒绝连接。准备测试时选一个允许中断的目标,为它写一条具体规则,放在常规兜底前,然后发起一个新连接做对照。不要用操作系统的连通性检测目标试验阻断,否则系统状态指示可能和真实可达性分离。没有显式兜底规则的配置,还要检查出站数组第一项是什么;改变数组顺序可能把原本没有命中规则的流量导向另一个出站,即使规则文本一字未改。
检查启动、命中与实际连接
按三个阶段收集证据。第一阶段是内核接受配置:检查结构能否解析、协议是否受当前内核支持、标签引用与本地监听参数是否一致。第二阶段是请求走到正确的出站:用两个目标测试,其中一个命中新增分支,另一个仍走原分支。第三阶段是出站能完成任务:对直连分支检查所在网络是否可达,对代理分支另查服务器的解析与连接,对拒绝分支确认影响只限测试范围。启动成功不是路由正确的证明,命中标签也不是远端连通的证明。
引入实际代理出站时,不要从别的内核配置只复制协议名就直接使用。还要按当前内核的配置格式核对传输与安全设置、服务器地址的解析路径,以及它支持的传输类型。出现超时时,先替换成手头已验证的出站做同条件对照;若仅新出站失败,继续查该分支,而不是去改系统 DNS 或扩大 TUN 接管范围。每轮变更后从新会话验证,避免应用复用旧连接导致误判。
完成测试后,把配置按作用分开归档:可恢复的完整配置留在受保护的位置,可交流的排错记录只保留规则次序、字段名称和脱敏后的异常。简短记录变更原因,例如「把内部测试域移到直连例外前部」,比保留一串未说明用途的试验配置更有用。标签和规则的概念可回查术语表;如果连基础入口都不再稳定,先恢复配置,再回到快速上手的连接验证流程。