v2rayN 常见问题与故障排查
按现象定位配置层级。内容覆盖 订阅导入、节点连接、系统代理与 TUN 权限，每项给出可以依次执行的检查动作。
基础认知
先分清客户端、订阅、节点和流量接管方式。概念混用会让后续排查落在错误层级。
v2rayN、v2rayNG 与 v2flyNG 应该怎样选择？
Windows、macOS 与 Linux 桌面环境使用 v2rayN。Android 设备优先选择采用 Xray 内核的 v2rayNG；需要使用 V2Fly 内核时，可选择 v2flyNG。三者的界面和配置入口不同，但订阅地址通常可以直接复用。切换客户端前应记录当前路由模式、DNS 设置和订阅分组，避免只导入节点却遗漏运行参数。
订阅、节点和配置文件分别是什么？
订阅是一组可更新的服务器配置入口，节点是其中一条具体连接记录，配置文件则包含入站、出站、路由和 DNS 等完整运行参数。日常使用通常先导入订阅，再从生成的节点列表中选择活动节点。手工配置适合单条参数调试，不应与订阅分组中的自动更新记录混在一起修改。
系统代理模式与 TUN 模式有什么区别？
系统代理模式修改操作系统的代理设置，主要接管遵循系统代理的浏览器和应用；TUN 模式通过虚拟网络接口处理更广范围的网络流量。先用系统代理验证节点与订阅是否正常，再根据应用兼容性决定是否启用 TUN。两种模式同时排查会增加变量，不建议在连接失败时反复叠加切换。
REALITY 节点为什么对参数一致性要求较高？
REALITY 配置中的协议、安全层、传输方式、服务器名称、公钥、shortId 与 flow 需要和服务端保持一致。任意字段被订阅转换器改写、截断或遗漏，都可能造成握手失败。出现问题时应先对照原始配置检查这些字段，再检查本机时间；不要只替换地址和端口后继续使用旧参数。
安装配置
安装包架构、订阅响应与系统权限是首次配置阶段最常见的三个变量。
粘贴订阅地址后没有导入任何节点怎么办？
先在客户端的订阅分组中确认地址没有首尾空格，并检查分组是否已启用。随后执行一次更新，查看日志中的 HTTP 状态、解析失败或证书提示。如果地址在浏览器中返回登录页、错误页面或普通网页，客户端就无法把它识别为订阅内容。确认地址可访问后，再检查订阅格式是否被当前客户端支持。
订阅更新失败但旧节点仍然存在，应该怎样处理？
旧节点存在只表示上一次更新结果仍保存在本地，不代表订阅当前可用。先记录日志中的响应状态与失败时间，再检查订阅有效期、本机时间、系统代理和 DNS。若只有某个分组失败，应单独编辑该分组并重新保存地址；若全部分组同时失败，应优先检查网络环境与客户端代理闭环问题。
Android 安装包中的 arm64 与 universal 怎么选？
2015 年以后发布的主流 Android 手机通常使用 arm64，可优先选择 arm64 安装包，文件体积也更集中。无法确认处理器架构、设备较旧或 arm64 安装失败时，再使用 universal 通用包。两种安装包的主要功能一致，区别在于包含的处理器架构范围，不需要因为订阅协议不同而更换安装包类型。
启用 TUN 时提示权限不足或虚拟接口创建失败怎么办？
先完全退出客户端，再按当前平台要求授予网络扩展、管理员或虚拟接口权限，然后重新启动。若系统中已有其他虚拟网络工具，应先退出它们，避免接口、路由表或 DNS 接管冲突。权限授予后仍失败，可暂时关闭 TUN，用系统代理验证节点正常，再根据日志中的接口名称和权限提示继续定位。
使用技巧
先建立一条可验证的最小连接，再逐步加入规则分流、DNS 与更广范围的流量接管。
导入订阅后应该怎样选择默认节点？
先更新订阅并确认节点所属分组，再执行一次真实连接测试。延迟测试只能反映测试目标与当时网络状态，不能单独代表完整可用性。选择节点后将其设为活动服务器，开启系统代理，并访问常用站点验证。若分组较多，建议保留清晰的用途名称，避免更新后误选到过期或测试节点。
全局、规则与直连模式分别适合什么场景？
全局模式通常让符合接管范围的请求统一经过当前代理，适合快速验证节点；规则模式按照域名、IP 或规则集决定代理与直连，适合日常使用；直连模式用于临时绕过代理。排查连接问题时先用全局模式减少规则变量，确认节点可用后再切回规则模式并检查命中日志。
修改节点后为什么需要重新设为活动服务器？
部分客户端会把编辑结果保存到节点列表，但当前运行中的内核仍使用启动时生成的配置。修改地址、端口、协议参数或 flow 后，应重新选择该节点，必要时停止并再次启动连接，使运行配置重新生成。可以通过日志中的启动时间与出站名称判断新配置是否已经加载。
DNS 设置应该从哪里开始调整？
节点可以连接但域名访问异常时，再把 DNS 作为独立变量检查。先保留客户端默认配置，分别测试域名与已知 IP 的访问结果；只有域名失败时，查看 DNS 查询日志、系统 DNS 与 TUN DNS 接管状态。不要同时更换多个解析服务器、路由规则和 FakeDNS 设置，否则难以确认是哪一项产生影响。
故障排查
连接问题通常落在网络可达性、协议握手、流量接管、DNS 或本地端口五个层级。
节点测试显示超时，应该按什么顺序排查？
先校准系统日期、时间和时区，再更新订阅并确认节点没有过期。随后检查服务器地址与端口能否建立连接、本机防火墙是否拦截、协议参数是否完整。最后关闭额外路由规则，用单一节点和系统代理重试。日志若停在连接阶段，多数与网络或端口有关；停在握手阶段则应回查安全层参数。
客户端显示已连接但网页无法打开怎么办？
先确认活动节点确实被当前内核加载，再检查系统代理是否开启以及浏览器是否采用系统设置。然后分别测试域名和 IP，判断是否为 DNS 问题。若只有部分网站失败，查看路由命中结果；若全部请求失败，临时切到全局模式并关闭 TUN 重试。每次只改变一个设置，便于根据日志确认故障层级。
系统代理已经开启但应用仍然直连，原因是什么？
有些应用使用自己的代理设置，或不读取操作系统代理，因此系统代理开启后仍可能直连。先检查应用内是否存在代理选项，并确认没有固定为不使用代理。还要查看系统代理地址与端口是否对应客户端当前监听端口。需要接管不遵循系统代理的流量时，可在确认普通连接正常后再评估 TUN 模式。
日志中出现端口被占用应该怎样处理？
端口被占用表示客户端准备监听的本地 HTTP、SOCKS 或 API 端口已被其他进程使用。先退出重复启动的客户端实例和其他代理工具，再重新连接。若仍冲突，可在设置中改用未被占用的本地端口，并同步检查浏览器或系统代理中的端口。修改后应重启内核，确认日志出现新的监听地址。
固定排查顺序
先确认输入，再确认连接，最后处理接管范围。顺序固定后，日志才具有可比较性。
-
01
校准本机环境
确认系统时间、时区、网络连接与客户端运行权限。完全退出重复进程，并暂时关闭可能修改路由表或占用本地端口的其他网络工具。
-
02
刷新订阅输入
检查订阅地址、分组状态和更新时间。更新后确认节点字段完整，尤其是协议、安全层、传输方式、服务器名称、公钥和 flow。
-
03
建立最小连接
选择单一节点，使用系统代理与全局模式测试。暂不启用复杂路由、额外 DNS 方案或 TUN，使连接路径保持可读。
-
04
按日志定位层级
连接阶段失败时检查地址、端口和网络；握手阶段失败时检查协议参数；连接成功但域名失败时检查 DNS；只有特定应用异常时检查代理接管方式。
-
05
逐项恢复功能
基础连接稳定后，再依次恢复规则模式、定制 DNS 与 TUN。每恢复一项都执行相同访问测试，并保留对应时间段的日志。