完整手册 / 配置与排查

V2Ray 客户端完整手册

从选客户端和验证第一条连接开始,再处理分流、TUN 与日常维护。每章先说明改的是哪一层,再给出检查方法和回退路径。

想先把连接跑通,按快速上手教程操作;需要理解字段、对照平台差异或找出故障发生在哪一层,再回到这份手册查对应章节。

一、核心概念:客户端、内核与连接

界面保存设置,内核处理流量

先把客户端和内核分开看。v2rayN、v2rayNG 和 v2flyNG 是用来编辑、导入和启停配置的图形客户端。界面里的当前配置、订阅分组和规则预设,最终要转成内核能读取的配置。内核负责监听本地入口、解析规则并建立出站连接。列表里看得见一条记录,只说明界面读到了这条记录;内核可能还没启动,也可能在加载时拒绝了某个字段。遇到“点了连接但没反应”,先看有没有启动错误,再判断该查应用入口还是远端连接。

Project V 是理解 V2Ray 生态的起点。V2Fly 延续了 V2Ray 的社区开发,Xray-core 则由同一技术脉络分出,后来各自演进。两者共享一部分配置概念,却并不保证互认所有字段。桌面端先用 v2rayN,再根据实际配置选择它提供的内核;安卓端的两款客户端使用不同内核,具体差异会在下一章检查。若界面显示导入成功,启动时却报传输或安全字段不受支持,先确认客户端实际启动了哪个内核,不要从产品名字反推能力。

协议、传输与连接安全不是同一项

VMess、VLESS、Trojan 用于区分出站协议,各自有相应的参数和身份验证方式。传输说明这些数据沿什么方式送到对端,例如使用原始流式连接或 WebSocket。TLS 是连接安全方式之一;REALITY 是 Xray 中可用于特定部署的连接安全机制,并不与 VLESS 并列为同一类字段。查看一条配置时,依次核对地址和端口、协议、传输、安全方式,不要只看到两个熟悉的缩写,就判断两条配置可以互换。

同一个域名也可能出现在几个位置,作用并不相同。服务器地址用于找到要连的对端;启用 TLS 时,服务器名称可用于握手与证书身份匹配;应用访问的目标域名则可能是路由判断的依据。把目标网站域名填进服务器地址,或者在名称不匹配时随手改掉安全校验,都不能解决字段填错的问题。碰到握手失败,保留出错时的字段类别与提示,和可信来源提供的配置逐项比,不要凭“看起来像域名”自行替换。

先回答流量在哪里进入、在哪里出去

客户端在本机打开的监听端口叫入站;从内核离开时,流量可能直连,也可能经远端转发,这叫出站。代理模式决定应用的请求能否进入客户端,路由规则决定进入之后选哪个出站。浏览器有页面可以打开,不一定经过代理出站;内核日志有启动记录,也不代表浏览器用到了这个入站。诊断时把应用、入口、匹配规则和出站分成四步,记录看到的是哪一步的证据。这样不会为了修复一个没采用代理的应用,误改原本能正常加载的远端配置。

订阅是发放一组连接配置的方式,不是另一种协议,也不是远端可用状态的证明。更新订阅只回答“能否取到并读入配置”,连接测试才回答“当前应用能否用这条配置完成请求”。从第一天就分开记录这两个结果:更新所用的分组和时间、测试所用的配置和应用、客户端给出的第一条错误。后续遇到更换网络或更新软件,同样的记录可以用来区分偶发故障与真实变化,也方便在不知道具体原因时先回到可用状态。

二、选客户端:平台、架构与内核

桌面先确定系统和包类型

桌面端首推 v2rayN。先到下载中心按系统选择,再对照设备的处理器架构和包格式。系统名称只能决定下载区,不能决定该区里的每一个入口。比如,同样是 macOS,Apple Silicon 和 Intel 对应不同安装包;同样是 Linux,处理器架构正确也不能把面向另一套包管理体系的安装包直接混用。若系统显示的信息不明确,先记下系统设置里的原始文字再查,不要只用购机年份或者应用商店里的设备名称判断。

平台客户端选包依据
Windowsv2rayN下载区提供 x64 的桌面版和经典 WPF 版,先看系统类型,再选界面。
macOSv2rayN“关于本机”里查看芯片或处理器,分别选 Apple Silicon 或 Intel。
Android优先 v2rayNG,备选 v2flyNG确认系统支持 arm64 后选该包;架构不明时可先对照通用版说明。
Linuxv2rayN架构在 x64 与 arm64 中选;发行版的包管理体系决定用 deb 还是 rpm。

Windows 的两个安装入口不是两种代理协议:桌面版使用跨平台界面,WPF 版使用经典 Windows 界面。已有使用习惯时,可以按菜单布局选;第一次安装则先用一种完成订阅和连接,不必为对照教程同时开两个窗口。两份实例可能尝试监听相同的本地端口,也可能分别修改系统代理,最后一个退出时清掉另一份还在使用的设置。如果系统类型没有明确对应下载中心列出的入口,先查看系统要求和下载页常见问题,不把别的系统包当作替代方案。

安卓按配置要求选内核

安卓先看已有配置需要什么。v2rayNG 使用 Xray 内核,是优先选择;v2flyNG 使用 V2Fly 内核,适合作为需要核对 V2Fly 配置时的备选。如果可信配置说明明确依赖某个内核独有的字段,优先满足这一要求,而不是把“导入成功”当成兼容结论。对于较常见的配置,第一次只装一款并完成验证;确有对照需要,再关闭原有 VPN 连接,使用另一款复测相同目标。否则系统可能已经切换到新的 VPN,会误以为两款都在处理请求。

选架构时,安卓设备的处理器能运行六十四位代码,不一定表示当前系统向应用提供六十四位环境。遇到系统提示安装包不适用于设备,先确认设备说明与安装入口;若包由其他方式传到手机,还要确认实际拿到的是面向安卓的安装包。通用版可以减少架构判断带来的误选,但不会改变内核,也不会弥补系统版本不满足要求。若系统提示与已安装应用冲突,别急着卸载,先保存可重新导入的配置,再核对两个安装来源。

把兼容性分成三次检查

第一次检查系统能否完成安装,第二次检查内核能否加载当前配置,第三次才检查目标应用是否真的能建立连接。三次失败对应不同处理方式:安装失败回到系统与架构,加载失败回到字段和内核,应用失败再看代理模式、解析与路由。迁移到另一台设备时,先迁移可重复获取的订阅或单条配置,不先复制整套应用数据。不同设备的接管权限、绑定端口和界面选项不一定相同,从一份最小配置起步,比事后分辨哪些旧设置产生冲突更省时间。

记录选型理由时,不需要抄满一张参数表。留下设备架构、安装入口、客户端名称、当前内核和配置来源这几项就够了。还可以写一句为什么没选另一入口,例如“需要读入带 Xray 专属字段的配置”。遇到别人给的菜单路径与自己不同,先用这份记录对照;确认只是界面名称不同,再按功能寻找入口。以后要验证问题是否只出现在某个客户端时,保持同一网络、同一目标和同一条连接配置,切换的才真正只有客户端这一项。

三、安装:运行权限与首次启动

桌面安装结束后,先只打开界面

Windows 按下载中心所选入口运行安装程序,按系统提示完成后,从开始菜单启动对应的 v2rayN。首次使用不需要因为将来可能开启 TUN,就让所有启动都以管理员身份运行。先用平时登录的账户确认窗口、菜单和设置可用,再按具体功能提示授予所需权限。出现缺少运行组件的提示时,记下完整的组件名称和当前入口,返回下载说明对照。不要从不明来源找一个名称相近的文件替换,也不要把程序打开失败当成订阅地址有问题。

macOS 使用与芯片匹配的磁盘映像。打开映像后,按窗口中的安装指引放入应用目录,再从那里启动,不要把挂载窗口当作长期运行位置。如果系统拦下启动,先读清提示区分架构、来源或管理策略,再检查下载入口与设备要求。单位管理的设备应遵循设备策略,不为了一次安装全局降低系统保护。安装之后确认打开的是应用目录中的那份,可以避免更新后又误点了旧映像里的副本,看起来像修改的配置突然没有保存。

Linux 按发行版从图形软件安装工具打开 deb 或 rpm,并核对安装程序显示的架构与依赖。系统工具提示缺依赖时,先确认包对应当前发行版和架构,再使用发行版自身的软件来源处理依赖。完成后从桌面应用列表启动 v2rayN。若机器只在远程终端里使用,没有能打开图形程序的桌面会话,本手册里的图形设置步骤不适用;不要反复安装不同格式的包来寻找窗口,也不要为了能启动把系统目录改为所有人可写。

安卓安装权限与连接授权分开处理

从浏览器或文件管理器打开可信安装包时,系统可能要求允许当前来源安装应用。只对实际打开安装包的应用处理这次授权,装完可在系统设置里撤销这项临时权限。首次打开代理客户端与首次开启 VPN 是两件事:可以先确认界面、订阅入口和设置保存,再处理系统 VPN 授权。未经允许时应用可能仍显示导入的记录,但目标应用的流量不会因此进入 VPN。如果设备已设定由工作单位管理的连接策略,应先确认允许替换,不能直接解除管理策略。

首次安装时不要急着恢复旧设备的全部设置。先关闭自动连接和其它会改写网络入口的客户端,让新程序以默认状态独立启动。开一次设置页再退出重进,确认所用账户可以保存正常设置;桌面端还可以记录界面显示的本地监听设置,但无须把端口暴露给局域网。若关闭并重开后设置恢复成旧值,先检查是否打开了另一份程序、是否使用了不同的登录账户,或者数据目录写入是否失败。此时还没引入订阅,排查面最小。

把首次启动结果记成一条基线

基线不是测速结果,而是当前设备上能重复观察到的状态。先用原有网络方式打开一个日常使用的普通页面,记录客户端此时尚未接管流量;窗口关闭后,再看系统代理或 VPN 状态是否保持原样。若原来已有手动代理或常驻 VPN,记下原设置,免得后来无法恢复。然后准备一组来源清楚的配置进入下一章。这样,导入以后出现的故障才有前后可比的记录;如果导入之前网络就不正常,应先解决基础连通性,而不是增加新变量。

四、订阅导入:分组、更新与生效

先区分订阅地址和单条配置

订阅地址通常用来获取一组配置,经过更新后组内条目可能变化;单条分享链接或二维码通常只导入对应的一条连接设置,不会随某个分组刷新。不要按网址看起来像普通网页,就把它直接交给在线转换工具。完整地址可能带有用于识别账户的敏感信息,二维码也可能含有服务器地址与身份字段。先确认资料来源和格式说明,再打开客户端对应的导入入口,别把整条地址贴到公共搜索框或聊天群用来判断格式。

在 v2rayN 打开“订阅分组”里的订阅分组设置,新建分组,填写好辨认的别名和“可选地址(URL)”,保存后回到主界面切到这个分组,再使用更新当前订阅的操作。首次操作只更新这一组,可以一眼看出新增条目落在哪。保存只是写入地址,并没有发起获取操作;更新才会取回数据并尝试解析。若组内已经有手工补过的条目,先把重要配置独立保留,避免下次刷新用取回的数据覆盖或移除本地修改。

在 v2rayNG 或 v2flyNG 中,先打开侧栏或菜单里的订阅分组管理,新建分组并保存备注与地址,再回到配置列表执行更新订阅,具体菜单名随界面而变。单条分享链接则使用添加菜单中的剪贴板导入或扫码入口,扫描后检查显示的协议和分组,再决定是否启用。剪贴板里若有多行文字,最好重新复制来源给出的完整链接,而不是手工从聊天记录截取。第一次只导入一种来源,避免两个相同别名让当前选择难以辨认。

更新出错时,按请求与解析拆开

更新没取到数据时,先确认地址是否过期、复制时有无漏字符、当前网络能不能发起请求,以及设备时间是否明显偏差。更新接收到了内容却没有条目,则核对返回的是配置数据还是登录页、错误页等普通网页,再看格式与内核是否匹配。不要把响应正文直接拿去公开求助。若日志显示超时,还要检查客户端为更新选择的请求路径:直连更新与经当前代理更新是不同路径,后一种要求已有一条可用连接。只有失败的旧连接时,反复选择经代理更新不会自行修复它。

列表出现条目以后,选一条名称和来源都能确认的记录。桌面端将它设为活动配置,安卓端点选条目后再启动连接,按系统提示授权。观察日志是否出现字段解析错误或端口占用,再用同一个普通目标做连接验证,必要时保留一条已知可用的配置作对照。即使订阅更新状态显示成功,一条记录也可能因对端停用或安全参数不符而失败。先用同组另一条可信配置复测,再决定是重查整个订阅,还是仅记录这一条的异常。

第一次成功后,再设自动更新

先手动更新并用一条记录完成连接,再决定是否开启自动更新。在 v2rayN 的分组设置里确认该组允许更新,按来源实际变更频率填写自动更新间隔,字段单位是分钟。取得了新条目并不等于应用会按你希望的方式切到另一条,刷新后应重新核对活动配置。若同一地址同步到其他设备,各自更新的时间和当前选择可能不同。地址更换或更新流程异常时,可对照订阅更新排查笔记,并记录出错的是取回、解析还是选用阶段。

五、代理模式:入口与连接验证

桌面先用系统代理建立基线

在 v2rayN 选定活动配置并确认内核已启动,再打开系统代理分段选择,设为“自动配置系统代理”。这个操作把系统代理指向客户端的本地入口,适合先用遵循系统代理的浏览器验证。若浏览器另装了会独立控制代理的扩展,测试时应确认它是否覆盖了系统设置;使用专门代理设置的应用也要单独检查。系统代理并不会把所有程序的流量改道,更不等于每个请求都会从远端出去,进入内核后的出站仍由当前路由规则决定。

选项操作含义检查重点
清除系统代理移除系统代理设置原有手动代理需要按记录恢复;应用自身的代理设置不受此操作管理。
自动配置系统代理把系统代理配置为客户端本地入口系统记录的地址、端口应与实际监听一致。
不改变系统代理不要求客户端改写系统代理原来设置的代理可能继续生效,不能据此判断已清除。

如果只想让某个支持手动代理的工具使用客户端,不必改写整台设备的系统设置。在客户端查看当前本地监听的类型与端口,在工具代理选项中填写对应类型,并使用本机回环地址。不要把远端服务器的端口填到本地代理字段,也不要把本地 HTTP 入口当作 SOCKS 入口;端口数字能填进去不代表双方使用了同一种协议。手动实验结束后,从该工具撤回设置再退出客户端,免得工具日后一直尝试连接一个已停止监听的本地地址。

安卓连接前先看 VPN 状态

安卓的常见操作是选中当前配置,再点连接;系统第一次请求建立 VPN 时,需要用户确认。确认对话框只说明同意建立系统接管通道,不代表远端已经握手成功。若已经有别的 VPN 或工作配置正在运行,先查系统的连接状态与管理要求;普通使用时用一个客户端做对照,不并行测试。若界面有按应用代理选项,失败的应用也可能没有被纳入范围。先用同一浏览器完成基准测试,再单独检查目标应用是否在排除列表中。

用同一个目标验证三段路径

验证时固定网络和目标,依次看三件事:客户端进程是否正常监听,应用发起请求时日志是否出现对应时间的连接,最后应用是否拿到预期结果。建议重新开一次页面请求,避免用浏览器缓存里的旧画面当作连通证据。页面能打开但日志里看不到请求,可能是应用没有采用这个入口;日志有入站但出现出站超时,则应回头核对规则和实际连接。一次对某个站点的成功,不足以推断所有应用、所有传输都已经正常。

如果浏览器正常、更新工具却打不开,先检查工具是否支持系统代理,是否有独立设置,或者是否额外用到了没有被当前方式接管的流量。若系统显示本地代理已经设置,但内核提示端口占用,先退出同类客户端或确认占用来源,再决定是否换端口。更换之后要同步检查手动填写过的应用,否则系统代理可能已经指向新端口,而单个工具还在使用旧端口。排查时只改一个入口,保证现象变化能归因,不把换节点、换路由和换端口放在一次操作里。

结束测试前,先记录工作状态,再复原入口。桌面若此前是直连,清除本次写入的系统代理,并确认退出应用后普通页面仍可访问;此前已有单位或个人手动代理,则按准备阶段的记录恢复,别把清除当作恢复旧值。安卓停止应用连接后检查系统 VPN 状态,尤其留意始终开启或限制未通过 VPN 连接的设定。若停止后全机都不能访问,先查这一层,而不是重新导入配置。入口的开关能独立验证,下一章的分流测试才不会被接管范围干扰。

六、路由分流:匹配、顺序与 DNS

分流是给已进入客户端的请求选出口

开始前保留一套已验证的路由预设,再复制一份做实验。预设名称方便选用,但不能替代规则检查;同一个“绕过”名称在不同配置里不一定对应相同列表。判断一条请求时,先问应用把域名还是 IP 交给了入口,再看规则条件和排序,最后才看出站标签。若规则只按域名写,而应用给的是 IP,最先应核对内核是否能在当前入口恢复目标信息,不要靠随意增加几个相似域名来碰运气。

一条规则可以依域名、地址范围等条件命中;部分组合条件需要同时满足。规则按顺序评估,宽泛条件放在专门规则前面,可能让后面的例外始终没有机会被用到。维护时把较具体的规则放在宽泛规则之前,并单独安排默认出口。添加一个站点后,至少检查它、一个原来要走另一个出口的目标,以及未单独列出的普通目标。只测试新增的站点,看不出来默认路径有没有被这次修改一起改变。

内核 JSON 示例:局域网直连与默认出站

下面是可并入 Xray 或 V2Fly 自定义配置的顶层 routing 片段,不是整份可启动的配置:现有配置需要已经定义标签为 direct 的直连出站和标签为 proxy 的代理出站,并保留原来的入站。若现有标签不同,使用实际标签。图形客户端使用规则编辑器时,对照录入条件与目标出站,不把整段 JSON 粘到域名文本框。先在副本中验证,再应用到常用配置。

{
  "routing": {
    "domainStrategy": "IPIfNonMatch",
    "rules": [
      {
        "type": "field",
        "ip": ["10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "network": "tcp,udp",
        "outboundTag": "proxy"
      }
    ]
  }
}

这个例子将命中指定私网段的 IP 请求直连,最后一条则匹配其余进入路由的 TCP 和 UDP。这里有个容易忽略的边界:IPIfNonMatch 只有在没有规则命中时才会尝试解析域名用于 IP 匹配;合法的宽泛兜底规则可能在这之前已经命中。所以不能把这个例子读成“所有解析到私网地址的域名必定直连”。如果已有明确的内网域名,给该域名添加专门规则放在兜底之前;若确需根据域名解析结果匹配地址,再评估 IPOnDemand 带来的额外查询与解析路径。

把 DNS 查询与最终访问分开观察

分流需要认识目标,但 DNS 查询本身也有去往解析服务的路径。某个网站的流量走代理,不表示解析它的请求也沿同一路径。浏览器自己的加密 DNS、系统设置的解析服务和客户端内置 DNS,都可能参与。调整时先记录实际启用了哪一种,再根据目标选需要由内核处理的解析范围。先测一个直连目标、一个代理目标,记录日志里目标名、匹配规则和出口;有需要时再按DNS 查询走向与防泄漏配置的步骤检查解析路径。

若改完规则后只有局域网服务失败,先用明知正确的局域网地址测试,再用原域名测试,两次结果不同常提示名称解析或域名匹配需要单独处理。若所有目标都失败,回到备份的预设并重载,确认至少能恢复基线,再检查是否引用了不存在的出站标签,或把现有必需的例外规则覆盖了。相比一次写完几十条规则,更稳妥的办法是每加一种条件就测一组结果,并留下实际采用的顺序;之后升级客户端时也能用这份清单判断规则是否改变了行为。

七、TUN 模式:接管范围与回退

先判断问题是否真出在入口

TUN 通过虚拟网络接口或相应的系统机制接收匹配路由的流量,不要求每个桌面应用都理解系统代理设置。它适合在同一条配置已通过系统代理验证,但目标应用仍不采用该入口时作为下一步。若原配置在普通浏览器里已经握手失败,或者内核连启动都失败,开启 TUN 不会修复远端参数。先写清要新增接管哪一个应用、与原模式相比应该出现什么现象,避免把范围更广误解成一定更稳定。

接管范围并不意味着所有流量都会经同一出站。系统路由、客户端的 TUN 设置、内网排除项和应用自身的解析方式都会产生影响。桌面端可能要启用相应的组件并取得系统权限;安卓端常用的是系统 VPN 通道,不要把桌面界面里的选项原样套到手机。已有特殊网络环境时,例如必须访问局域网共享或机器上已有另一套虚拟接口,先准备一条可恢复的测试路线。在远程会话依赖当前网络时,不要贸然切换接管模式,以免断开后无法在本机撤回。

从干净的基线启动 v2rayN 的 TUN

先在桌面端确认能够复现一条正常的系统代理连接,并记下原系统代理状态、当前路由与活动配置。随后停止系统代理接管,保留同一条活动配置,确保没有另一款代理客户端在更改系统路由。找到 v2rayN 界面提供的 TUN 开关,按提示处理必要权限。若当前界面没有这个入口或启动失败,查看日志给出的组件和错误,不根据别的系统截图复制开关参数。初次验证只看 TUN,不同时新增远程 DNS 或重写分流规则。

开关启用后,依次测试三类目标:普通网页、原先不走系统代理的应用、需要保留直连的局域网资源。每次测试前重新发起请求,观察日志中有无该应用尝试时的入站或规则命中。仅普通网页可用,原问题仍未解决;原应用开始工作但内网资源消失,则要检查局域网路由和排除范围。若工作正常但断开 TUN 后出现全机异常,检查系统默认路由、原代理和 DNS 是否恢复,记录哪项残留,不要把关闭再开启当成长期处理办法。

把 DNS、虚拟地址和传输故障分开判断

TUN 下可能遇到 DNS 请求改变路径的情况。先比较已知的内网地址是否可达,以及相应的内网名称是否能解析;地址可达而名称失败,先查解析选择与范围,不先重装客户端。若启用了 FakeDNS,返回的地址可能是内核为域名映射的虚拟 IP;只有后续连接按设计回到能还原这份映射的入口,规则才能用恢复出的目标判断。FakeDNS 原理与适用场景可作为下一步阅读,基线还没建立前不必开启。

一个应用的网页入口可用,但它的语音或实时连接仍失败,可能是实际流量类型与网页测试不同。先在同样的网络上关掉 TUN 对照,确认现象不是目标应用固有的问题,再检查当前出站和路由是否支持它用到的传输。不要仅凭“网页能开”就认为所有流量类型都通过。相反,若开启瞬间各类请求全部失败,首先关闭 TUN、恢复原系统代理状态并验证基线。再重开进行第二轮时只检查一个分支,例如权限或路由冲突,直到能指出具体哪项设置改变了结果。

八、日常维护:更新、备份与复查

把订阅更新和软件更新分开做

订阅更新改变的是连接条目,软件或内核更新改变的是配置解析、界面与运行行为。在同一天碰上两种更新时,先完成一种,验证后再做另一种。日常可以按来源实际调整频率复查订阅,不必把自动更新间隔设得很短。更新组后看看活动配置是否仍在、是否出现同名条目,再测试固定目标。若更新前可用、更新后异常,先用此前单独保存的配置做对照;比直接删除重导更容易判断是条目变化,还是眼下的网络恰好不稳定。

客户端升级前,先记下所用入口与当前内核,保存订阅分组、常用路由、本地端口、DNS 选择和接管偏好。若升级说明涉及配置迁移,先确认备份能在可用环境中读取。升级完成后先不切换内核和路由,只开到原有的接管模式,复查一个普通目标和一个本地资源。发现新界面改了默认项时,记录实际选项,不靠旧截图猜测。若必须回退,先保留升级后新生成的必要记录,尽量用升级前的备份恢复,别把已迁移的数据直接塞给旧程序。

按恢复需要选择备份方式

订阅地址适合重建经常变化的列表,单条导出适合保住当前能用的一项,客户端备份适合迁移同类设备上的分组与部分偏好。三者包含的内容不同:订阅地址不保存手工路由,单条分享一般不包含全局设置,备份也可能不带系统权限与其它系统级状态。准备换设备时,先阅读多设备配置同步笔记,按需要分别保留,不把一个二维码当作整台设备的网络设置快照。

备份要知道放在哪里、如何打开、谁有权访问。配置文件可能含账号标识和完整订阅地址,不把它直接存进公开共享位置,也不在公共反馈里上传整份压缩包。迁移时优先使用客户端自身支持的导入导出;导入后先只恢复必要的分组与规则,再逐项设本地端口、设备权限和网络接管。保持旧设备的配置不动,直到在新设备上完成一轮验证。若条目能导入但保存的路由不认,手动重建少量必要规则比覆盖整份配置更容易确认差异。

故障记录只保留有用的信息

遇到间歇性故障,记录发生时间、当前网络、活动配置的自用别名、是否开了 TUN、失败的是哪一个应用,再取这个时间窗口内最先出现的错误。若设备睡眠唤醒后才失败,要把“唤醒前正常、唤醒后异常”单独写出来,再查网络是否切换以及本地监听是否恢复。只有某个网络失败时先回到工作网络复测,不必立刻把订阅判为失效。向他人求助时保留错误类别和必要的上下文,移除完整地址、二维码、身份字段与可识别的访问记录。

给常用设备定一轮短复查:确认配置能加载,普通目标走预期出口,本地资源仍可访问,再检查关闭接管后能否回到原网络。计划让电脑给其他设备共享代理时,应先确认确有需求,区分本机回环监听与局域网监听,不扩大到不受信任的网络;具体检查项见v2rayN 局域网共享设置。停止共享后再检查监听是否收回。平时不依赖这一功能,就把它留在关闭状态,也减少以后排查端口时需要考虑的入口。

九、进阶路线:单变量实验与排错

用对照组替代反复切开关

进阶操作从能复现的问题出发。写清基线是“在这台设备、这个网络、用这个入口、访问同一目标”,然后只改一个变量:客户端、内核、规则、DNS 或接管模式中选一项。比如浏览器可以用而某个工具不能用,先只换入口,不同时改路由和订阅;两个入口都出错,再用同一应用替换活动配置。若不能复现失败,也不要把某次成功归给最后按过的开关。把操作前后同一项观察结果写下来,才能判断下一轮该向前还是回退。

可以把异常写成“预期、实际、证据、下一步”。例如预期内网工具访问局域网资源时直连,实际开启 TUN 后超时,证据是局域网地址可达但域名请求失败,下一步便是检查该域名解析由谁处理。另一种情况是客户端从未收到该工具请求,这时应先看入口和接管范围,而不是分析路由规则。使用这一格式时,别把看不到日志写成证实没发生;日志等级和记录范围可能不足,可先短时提高可见性,测试后改回日常设置。

从本机基线读懂启动与连接错误

桌面端看到绑定失败时,先核对设置里的本地监听类型,再检查实际是否存在对应端口。Windows 可在 PowerShell 中运行下面这条只读命令,列出本机在监听的 TCP 地址、端口及进程编号;到任务管理器的详细信息页对照进程编号,确认是当前客户端使用的组件还是别的程序。命令不验证代理协议,也不测试远端连通,不能据此判断订阅质量。检查绑定地址时注意本机回环与面向全部接口的地址并不等价,后者要结合已有的共享配置判断。

Get-NetTCPConnection -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess

监听正常但内核报告外部连接超时,先区分是解析不出目标、连接尚未建立,还是已进入握手后才失败。字段不识别多发生在加载阶段,证书名称不匹配发生在有相应安全握手的阶段,远端返回的应用错误又是连接后的另一层。不同日志表述可能相近,结合发生的时点核对,不关闭安全检查来掩盖名称不匹配。若只在某个网络出现问题,就在已知可用的网络下复测相同配置;若多个配置都指向同一个失败环节,再检查本机共享条件。

按需求安排接下来的练习

第一轮练习只改一条域名规则:在备份的路由副本中增加一个需要直连的测试目标,观察它和另一个普通目标的去向,再撤销新规则复测。第二轮练习才动解析:固定同一条路由,分别观察直连目标和代理目标的名称查询与出站结果。第三轮处理接管:同一应用先用明确支持的入口测试,再对比系统代理或 TUN,留下最小可复现的设置。每轮都先写下预期和恢复办法,若前一轮还解释不了结果,就不要用下一层的改动把异常藏起来。

日常只用订阅、系统代理和少量分流时,能解释这三项就足够。需要处理不遵循代理的应用,再练习 TUN;需要迁移或用自定义内核配置时,再复查内核差异、字段和出站标签。卡在安装、架构或设备要求时回到下载中心与下载常见问题;需要把基本连接从头重做时按快速上手教程复现。完成一轮排查后,把最后可用的状态和可重复的验证步骤留下,比把所有高级选项都打开更有用。