// TROUBLESHOOTING INDEX
V2Ray 常见问题与故障排查
按基础认知、安装配置、使用技巧和故障排查整理。先判断问题发生在客户端界面、内核启动、本机网络还是远端节点，再逐项修改设置。
// 01 · BASICS
基础认知
先分清客户端、内核、订阅和代理模式。概念层次清楚后，安装与日志排查会更直接。
v2rayN、v2rayNG 与 v2flyNG 应该怎么选？
Windows、macOS 与 Linux 桌面环境优先选择 v2rayN，它提供服务器列表、订阅分组、系统代理、路由和 TUN 等完整入口。Android 通常选择采用 Xray 内核的 v2rayNG；需要使用 V2Fly 内核生态时再选择 v2flyNG。三者的配置界面不同，订阅内容能否导入仍取决于服务端提供的协议与字段。
V2Ray、V2Fly、Xray 与图形客户端是什么关系？
V2Ray 通常指 Project V 形成的协议与工具生态，V2Fly 和 Xray 是常见内核家族，负责连接、传输、路由与 DNS 等底层工作。v2rayN、v2rayNG、v2flyNG 属于图形客户端，负责保存配置、调用内核并提供系统代理等操作入口。排查问题时要区分界面设置、内核启动和远端节点三个层次。
订阅链接和单个分享链接有什么区别？
订阅链接通常返回一组服务器配置，客户端可以按分组保存并定期更新；单个分享链接只描述一个节点，常见内容包括地址、端口、标识、传输方式与安全参数。导入订阅时应使用订阅管理入口，导入单个链接时使用从剪贴板导入或扫描入口。把两者放错入口，常见结果就是列表为空或提示格式无法识别。
系统代理模式与 TUN 模式有什么区别？
系统代理通过操作系统代理设置把支持代理的应用流量交给客户端，配置简单，适合浏览器和遵循系统代理的桌面程序。TUN 模式创建虚拟网络接口，可接管更多不读取系统代理设置的程序，但需要额外权限，也更容易受到本机防火墙、虚拟网卡和 DNS 设置影响。初次配置建议先验证系统代理，再按需要启用 TUN。
// 02 · INSTALLATION
安装配置
安装阶段重点核对操作系统、处理器架构、应用权限和首次导入顺序，不要用切换节点处理应用启动问题。
Windows 上的 v2rayN 桌面版与经典 WPF 版怎么选？
桌面版采用新一代跨平台界面，适合希望在不同桌面系统间保持相近操作方式的用户；经典 WPF 版面向 Windows，界面与既有教程中的菜单结构更接近。两者都能完成订阅、服务器选择和系统代理设置。已有稳定配置不必仅为界面变化迁移，新安装可先使用桌面版，遇到兼容问题再尝试 WPF 版。
macOS 安装包中的 Apple Silicon 与 Intel 怎么选？
打开系统的关于本机页面，查看芯片或处理器字段。显示 Apple M 系列芯片时选择 Apple Silicon，也就是 arm64 安装包；显示 Intel 处理器时选择 x64 安装包。选错架构可能导致应用无法启动或需要额外转译。安装前先确认芯片类型，比根据设备外观或购买年份判断更可靠。
Android 安装包中的 arm64 与 universal 怎么选？
2015 年后发布的大多数主流 Android 手机可以优先选择 arm64，安装包通常更精简。无法确认处理器架构、设备较旧，或 arm64 安装时提示不兼容，可改用 universal 通用版。通用版包含更多架构支持，因此文件通常更大，但客户端功能没有因此增加。不要仅依据系统显示的 64 位名称判断，安装结果才是直接依据。
客户端首次启动被系统拦截时怎么处理？
先确认安装包与当前操作系统、处理器架构匹配，再从系统安全提示中查看被拦截的具体原因。Windows 可检查应用保护提示，macOS 可在隐私与安全设置中确认本次打开，Linux 则检查安装格式、文件权限和缺失依赖。不要连续更换节点来处理启动拦截，因为此时内核尚未运行，问题发生在应用加载阶段。
第一次导入订阅的正确顺序是什么？
先复制完整订阅地址，在客户端中新建订阅分组并粘贴地址，然后执行更新订阅。服务器列表出现后，选择一个活动服务器，再启动内核并开启系统代理。最后用浏览器访问常用站点验证连接。订阅名称只是本地标记，不影响更新；真正需要保持完整的是订阅地址，复制时应避免遗漏开头、参数或末尾字符。
安装后是否需要单独下载 V2Ray 或 Xray 内核？
通常先使用客户端安装包自带或由客户端管理的内核，不需要在首次安装时额外拼接内核文件。若日志明确提示内核不存在、无法启动或版本不兼容，再检查客户端的内核设置与更新入口。手工放置内核时必须对应系统和处理器架构，并保持客户端配置的内核路径与实际文件位置一致。
// 03 · OPERATION
使用技巧
日常操作围绕订阅更新、活动服务器、代理模式和路由规则展开。每次只调整一个变量，日志才有可比性。
订阅应该多久更新一次？
更新频率取决于订阅提供方的变更节奏。节点信息长期稳定时，没有必要频繁刷新；收到配置调整通知、当前节点集中失效或订阅内容发生变化时，应手动更新一次。自动更新间隔不宜设置得过短，过于频繁可能触发请求限制。更新前保留当前可用服务器，更新后再观察分组和活动服务器是否被替换。
怎样选择活动服务器并判断配置能否使用？
先更新订阅，再在服务器列表中选择一个条目作为活动服务器。客户端提供的测试结果只能作为筛选参考，最终仍应启动内核并实际访问目标站点。测试失败时先查看日志中的域名解析、连接拒绝、握手失败或超时信息。不要只根据名称和排序判断，也不要同时修改协议、路由、DNS 与代理模式，否则很难定位变化来源。
全局、规则与直连模式应该怎么用？
全局模式通常把可接管流量交给当前服务器，适合临时验证节点是否工作；规则模式按照 domain、ip、geosite 等条件决定代理或直连，适合日常使用；直连模式主要用于暂停代理路径和对照排查。配置新订阅时可以先用全局模式验证连接，再切回规则模式。如果切换后出现差异，应检查规则顺序和最终兜底规则。
自定义路由规则为什么没有命中？
先确认规则类型与内容匹配，例如域名放入 domain 条件，地址段放入 ip 条件，预置分类使用正确的 geosite 名称。多数路由按从上到下顺序匹配，前面的宽泛规则可能提前截获流量。修改后要让客户端重新载入配置，并从日志确认实际目标域名、解析结果与命中的出站。只改规则但未重启内核，常会继续使用旧配置。
怎样设置开机启动与启动后自动连接？
开机启动、启动内核和启用系统代理是三个不同动作。先在客户端设置中启用随系统启动，再确认启动时加载上次服务器，最后按需要开启启动后设置系统代理。首次配置后应重启一次系统验证，检查客户端是否运行、内核是否启动、系统代理是否写入。只看到托盘图标并不代表代理路径已经生效。
// 04 · DIAGNOSIS
故障排查
从第一条可复现错误开始：订阅请求、配置解析、内核启动、节点连接、DNS、路由与应用接管依次检查。
订阅链接导入后为什么没有服务器？
先确认使用的是订阅管理入口，并执行一次手动更新。若列表仍为空，检查地址是否完整、是否包含多余空格、是否已失效，以及客户端日志中的 HTTP 状态或解析错误。浏览器能打开订阅地址不等于客户端一定能解析，其中内容还必须符合支持的订阅格式。也要检查服务器是否被导入到其他分组或被筛选条件隐藏。
订阅更新失败或提示网络错误怎么排查？
先用当前网络确认订阅地址可以访问，再检查客户端是否设置了用于更新订阅的代理方式。当前活动节点已经失效时，通过代理更新可能形成依赖循环，可暂时改为直连更新；直连无法访问时，则需要选择仍可用的服务器后重试。还应核对系统时间、地址参数、请求限制和日志中的证书或域名解析提示。
节点测试一直超时应该检查什么？
先切换同一订阅中的另一个节点，判断是单节点故障还是全部配置异常。全部超时时，检查本机网络、系统时间、防火墙、DNS 和内核启动日志；只有个别节点超时时，通常与远端状态、端口、传输参数或线路有关。测试工具本身也可能使用特定目标地址，因此应结合实际网页访问和连接日志判断。
客户端显示已连接但浏览器无法上网怎么办？
依次确认活动服务器、内核运行状态、系统代理开关和浏览器代理来源。先使用全局模式做一次对照测试，再查看日志是否出现 DNS 失败、路由到直连、连接被拒绝或握手错误。浏览器若安装过独立代理扩展，可能绕过系统设置，应暂时停用后重试。修改完成后关闭并重新打开浏览器连接，避免继续复用旧会话。
系统代理已开启但部分程序不生效怎么办？
部分程序不读取操作系统代理，或只支持特定代理类型，因此系统代理开启后仍可能直连。先确认浏览器等标准应用可以正常使用，再检查目标程序是否有独立代理设置。需要接管更多应用时可评估 TUN 模式，但应先记录原有网络设置。企业网络、安全软件和其他代理工具也可能覆盖系统代理，排查时只保留一个控制入口。
TUN 模式提示权限不足或启动失败怎么处理？
TUN 需要创建或管理虚拟网络接口。桌面系统上应按客户端提示授予管理员或网络扩展权限，Android 上应确认系统的 VPN 连接授权。若仍失败，检查是否已有其他虚拟网卡、代理工具或安全软件占用相关能力，并查看日志中的驱动、接口名称和路由写入错误。退出其他网络工具后重新启动客户端，通常比反复切换节点更有效。
// RELATED DOCUMENTS
继续查看配置步骤
需要从导入订阅开始操作时查看使用文档；需要理解代理模式、路由、TUN 与日常维护时进入系统教程。