V2Ray 常见问题与故障排查
按基础认知、安装配置、使用技巧和故障排查整理 v2rayN、v2rayNG、v2flyNG 的高频问题。建议先确认问题所属环节，再根据日志与配置逐项缩小范围。
- 订阅导入
- 系统代理
- TUN 权限
- V2Ray 路由规则
- DNS 排查
客户端、内核与代理模式
先分清图形客户端、代理内核、协议与系统代理各自负责的环节，可以避免把导入问题、连接问题和路由问题混在一起处理。
V2Ray、v2rayN 和 Xray 内核分别是什么？
V2Ray 通常指 Project V 形成的协议与工具生态；v2rayN 是负责订阅管理、路由设置和系统代理控制的图形客户端；Xray 是客户端可以调用的代理内核。图形界面不会取代内核处理连接，而是把配置转换为内核可读取的内容并管理其运行状态。
v2rayN、v2rayNG 和 v2flyNG 应该怎么选？
Windows、macOS 与 Linux 桌面环境优先选择 v2rayN。Android 常用 v2rayNG，其内核与桌面端常见的 Xray 配置衔接较直接；需要使用 v2fly 内核时可选择 v2flyNG。选择时还要确认订阅包含的协议与传输方式是否被对应客户端和内核支持。
系统代理、路由模式和全局代理有什么区别？
系统代理决定操作系统和遵循系统设置的应用是否把请求交给客户端；路由模式决定请求进入内核后走 direct、proxy 还是 block 出口；全局代理通常表示大部分已进入客户端的流量都使用代理出口。三者位于不同处理环节，开启系统代理并不等于所有程序都会自动受控。
VMess、VLESS、Trojan 和 Shadowsocks 可以放在同一客户端里吗？
只要当前客户端及其内核支持相应协议，就可以在同一订阅分组或服务器列表中保存这些配置。不同协议不能互相替换字段，例如 VLESS 的 flow、REALITY 的 publicKey 与 shortId 都有明确用途。导入后应检查协议、端口、传输层和安全参数是否完整。
订阅地址和单个分享链接有什么区别？
订阅地址通常返回一组可更新的服务器配置，适合统一维护；单个分享链接只描述一个配置，导入后不会自动跟随订阅变化。订阅更新会按客户端规则合并或替换分组内容，因此手工修改订阅内项目可能在下次更新时被覆盖，长期自定义配置应单独保存。
订阅导入与安装包选择
安装阶段的常见问题集中在订阅地址格式、更新方式、处理器架构和系统权限。应先确认输入内容与所选安装包，再处理客户端内部设置。
订阅导入失败，应该先检查哪些内容？
先确认复制的是完整订阅地址，没有多余空格、换行或被聊天工具截断；再用客户端的订阅分组功能新增地址并执行更新。若仍失败，检查地址是否过期、当前网络能否访问订阅服务，以及返回内容是否为客户端支持的订阅或分享链接格式。
订阅更新失败，但地址在浏览器中可以打开怎么办？
浏览器可打开只说明地址可访问，不代表返回内容能被客户端解析。应查看客户端日志中的 HTTP 状态、解码提示和格式错误，并分别尝试直连更新与通过当前代理更新。若返回的是登录页面、错误页或空内容，需要先在订阅服务侧恢复正确响应。
Android 下载时 arm64 与 universal 怎么选？
近年的主流 Android 手机通常使用 64 位 ARM 处理器，可优先选择 arm64 包，文件体积也通常更集中。无法确认处理器架构、设备较旧或 arm64 包安装失败时，再选择 universal 通用包。通用包包含更多架构资源，兼容范围更广，但安装包一般更大。
v2rayN 桌面版与 Windows WPF 版怎么选？
桌面版基于跨平台界面方案，适合希望在不同桌面系统间保持相近操作逻辑的用户；WPF 版仅面向 Windows，界面与托盘操作更接近传统 v2rayN 使用方式。首次安装可以从桌面版开始，已有固定工作流或依赖经典界面时再选 WPF 版。
macOS 提示无法验证开发者时怎样处理？
先关闭提示窗口，进入系统设置的隐私与安全性页面，找到刚被阻止的 v2rayN，并使用系统提供的仍要打开选项。随后重新确认启动。首次运行还可能请求网络访问权限，应按实际使用需要允许；完成后再检查菜单栏状态与系统代理设置。
系统代理、TUN 与路由分流
客户端显示运行并不代表所有应用流量都已进入内核。系统代理、应用内代理和 TUN 的接管范围不同，路由规则则在流量进入后决定出口。
客户端显示已连接，但浏览器无法上网怎么办？
先确认浏览器是否遵循系统代理，再检查客户端是否已选择可用配置并启用正确的系统代理模式。随后临时切换到较简单的路由模式，排除自定义规则误分流。如果所有配置都失败，应查看日志中的 DNS、握手、证书时间与连接超时信息，而不是反复切换开关。
系统代理已开启，部分应用仍然直连是什么原因？
系统代理只对读取操作系统代理设置的应用生效。部分程序使用自带网络栈、固定代理配置或 UDP 连接，因此可能绕过系统代理。可先检查应用内部是否设置了代理，并确认其 SOCKS 或 HTTP 端口与 v2rayN 本地监听端口一致；需要接管更多流量时再评估 TUN 模式。
TUN 模式为什么提示权限不足或启动失败？
TUN 需要创建虚拟网络接口并调整系统路由，因此通常要求管理员权限或系统网络扩展授权。先退出客户端，再按当前系统要求提升权限后启动，并允许相关网络组件。若仍失败，检查其他 VPN、虚拟网卡、安全软件或旧的 TUN 进程是否占用了接口与路由。
如何设置国内地址直连、其余流量走代理？
在路由设置中让 geosite:cn、geoip:cn 与 geoip:private 指向 direct 出口，再把未命中的其余流量交给 proxy。规则顺序会影响匹配结果，更具体的域名或 IP 规则应放在通用规则之前。修改后应重新加载配置，并分别测试直连域名与代理目标。
sniffing 流量探测应该开启吗？
sniffing 可从连接中识别目标域名，帮助仅获得 IP 的流量继续匹配 geosite 域名规则，常见桌面配置可以开启。它不是连通性的必要条件；如果特定应用出现域名识别异常、连接被错误改写或与自定义路由冲突，可针对对应入站关闭后比较结果。
超时、DNS 与本地端口
排查时先判断问题发生在订阅解析、本地进程、域名解析还是远端连接。保留一套最小配置并一次只调整一个变量，通常比同时更换多个设置更有效。
节点连接超时应该怎样逐步排查？
先确认本机网络正常，再检查服务器地址、端口、协议、传输方式与安全参数是否完整。多个配置同时超时通常更像本地网络、DNS 或系统时间问题；只有单个配置超时则应重点核对该配置。日志中的 timeout、connection refused 与 handshake failed 分别指向不同环节。
订阅更新成功但服务器列表为空是什么原因？
更新成功可能只表示请求完成，返回内容仍可能为空、格式不兼容或不含受支持的配置。先查看订阅分组的更新日志与解析数量，再确认是否启用了过滤条件。若响应实际是提示文本、网页内容或未知分享格式，客户端不会把它识别成服务器项目。
日志提示端口被占用怎么处理？
端口被占用表示本地 SOCKS、HTTP 或 API 监听端口已被其他进程使用，也可能是上一次内核进程没有正常退出。先完全退出相关客户端并重新启动；仍有冲突时修改本地监听端口，例如从 10808 改为未占用端口，同时更新浏览器或其他应用中的代理端口。
只有域名打不开，但直接访问 IP 有响应怎么办？
这种现象通常需要优先检查 DNS。确认客户端 DNS 配置可用，路由规则没有把查询错误送往不可达出口，并清理操作系统的旧解析缓存。若开启 TUN，还要检查 DNS 劫持或虚拟 DNS 设置。不要只替换节点，因为连接出口正常时，问题可能发生在域名解析阶段。
修改配置后问题更多，怎样恢复到可排查状态？
先备份当前配置，再暂时关闭自定义 DNS、Mux、复杂路由和 TUN，只保留一个确认字段完整的配置、默认本地端口与基础系统代理。验证基础连接后，每次只恢复一项设置并重新测试。按变量逐项增加，比同时修改多个开关更容易定位冲突来源。