V2Ray 客户端
常见问题

V2Ray 属于 Project V 代理工具生态，V2Fly 延续其内核维护；Xray 是同一技术生态中的另一内核实现。v2rayN 是图形客户端，负责管理服务器、订阅、路由和启动内核。界面能打开不代表内核已正常运行，排查连接前应先看核心日志。选择协议时还要核对当前内核是否支持对应的传输与安全参数，不能只看客户端名称。

Windows、macOS 与 Linux 桌面优先查看 v2rayN；Android 优先查看采用 Xray 内核的 v2rayNG，需要 V2Fly 配置兼容性时再考虑 v2flyNG。选择依据是系统、处理器架构及服务端配置，而不是界面是否相似。同一条订阅在不同客户端中的字段解析可能有差异，迁移后应检查协议、传输方式、TLS 与路由，不要直接沿用旧的本地配置目录。

订阅地址通常是返回配置集合的网络地址，添加后需要执行更新；分享链接常以 vmess://、vless:// 或 trojan:// 开头，通常描述单条服务器配置；原生 JSON 则可能包含入站、出站、DNS 与路由等完整内容。三者不能随意互换导入入口。拿到内容后先判断格式，再选择订阅分组、剪贴板导入或配置文件导入；不要把订阅网址当作服务器地址填写。

系统代理让遵循系统代理设置的应用连接到本地代理端口；路由分流决定已经进入内核的连接走 direct、proxy 还是 block；TUN 则通过虚拟网络接口接入流量，覆盖范围取决于平台与配置。三者处在不同环节。浏览器没有进入客户端时，修改 geosite 规则通常没有作用；已经进入客户端却走错出站时，应检查规则顺序，而不是反复切换系统代理。

VLESS 与 Trojan 是代理协议，REALITY 是连接安全机制，不能把它们当作同一层的三个互斥选项。配置需要同时对应服务端的协议、传输方式和安全设置；使用 REALITY 时，还要核对公钥、serverName 与 shortId 等参数。不要仅凭名称手动改协议，也不要把原有 TLS 配置直接改成 REALITY。优先导入提供方给出的完整链接，再逐项比对当前客户端与内核的支持情况。

2015 年后主流 Android 手机通常可优先考虑 arm64，但发布时间不能代替架构确认，应以设备系统信息和应用要求为准。universal 包含多种架构，适合不确定架构时尝试，文件通常更大。若提示无法安装，还要检查系统最低版本、剩余空间和已有应用签名是否冲突；不要把所有安装失败都归因于架构。卸载旧应用前，先备份仍需使用的配置。

桌面版采用新一代跨平台界面，经典 WPF 版使用 Windows 桌面界面，两者的菜单位置与部分配置入口可能不同。Windows 用户可根据操作习惯和具体兼容情况选择，不必同时运行两个版本。首次迁移先导出服务器与路由配置，再在目标版本中导入并检查本地端口；不要用新版数据文件直接覆盖旧版目录，也不要让两个实例争用同一个代理端口。

先确认复制的是完整订阅地址，开头结尾没有空格、换行或聊天工具附带的标点。在 v2rayN 中将地址放入订阅分组后，还需执行更新订阅；只保存分组不会生成服务器列表。若提示格式不支持，检查返回内容是否其实是登录页、错误页或客户端不支持的订阅格式。分享链接应使用对应的剪贴板导入入口；不要通过手动修改编码来掩盖地址失效问题。

桌面 TUN 需要创建或管理虚拟网络接口，可能要求管理员权限、服务安装或系统授权，具体取决于客户端版本和系统。Android 客户端则通过系统 VPN 授权接入流量，应在系统确认窗口中允许。授权后仍失败，要查看接口创建相关日志，并检查是否有其他 VPN 程序占用。先验证普通系统代理能否工作，再启用 TUN，可避免把服务器配置问题与接口权限问题混在一起。

macOS 先在系统的关于本机信息中确认是 Apple Silicon 还是 Intel，再选择对应的 arm64 或 x64 安装入口。Linux 需要同时确认处理器架构和软件包体系：Debian、Ubuntu 系通常选 deb，Fedora 等系统通常选 rpm，再区分 x64 与 arm64。安装后无法启动时，应查看系统依赖与应用日志；不要仅通过重命名安装包后缀来尝试跨架构或跨包管理器安装。

需要中国大陆网站直连、其他网站按规则代理时，可从绕过大陆规则集开始；全局模式适合临时判断分流是否导致异常，但仍应查看实际规则对私有地址等流量的处理。切换模式后要确认配置已重载，并用同一个网站重复验证。全局模式不等于所有程序都已接入代理：未遵循系统代理的应用仍可能直连，这类情况应先确认应用代理设置或 TUN 接入。

当前网络能够直接访问订阅服务时，可使用更新订阅（不通过代理）；直连失败且已有可用代理时，再尝试通过代理更新。两种方式改变的是获取订阅的网络路径，不会修复过期地址或服务端返回的错误内容。切换方式前记录日志中的具体错误，例如解析失败、连接超时或 HTTP 状态码；不要连续高频刷新，以免触发订阅服务的请求限制。

在路由设置中添加域名匹配并选择 direct 出站，例如 domain:example.com 匹配该域名及其子域，full:example.com 仅匹配完整域名。Xray 路由通常按规则从上到下匹配，专门例外规则应放在可能提前命中的宽泛规则之前。保存并重载后，关闭旧连接再重新访问，结合访问日志观察出站标签。不要只靠网页能否打开判断规则命中，也不要把系统代理的绕过列表当成内核路由表。

优先迁移订阅地址或客户端支持导出的配置，再检查当前服务器、路由规则与 DNS。系统代理、TUN 授权、开机启动、本地端口和应用分流通常与设备环境有关，需要在新设备上重新确认。不同客户端的完整备份不一定互通，能导入分享链接也不代表能读取彼此的数据库。备份可能含服务器认证信息与私人订阅地址，应存放在受控位置，完成迁移后清理临时副本。

如果程序退出后系统仍指向已经关闭的本地代理端口，浏览器会继续向该端口发起连接。在 v2rayN 中先执行清除系统代理，再正常退出；使用 TUN 时，还需确认虚拟接口和相关路由已恢复。若客户端已经关闭，可在系统网络设置中检查手动代理。不要随意清空其他软件或组织管理的代理配置；恢复后重新启动浏览器，并分别验证本地网络与普通网站连接。

先确认测试方式：TCP 连接成功只说明目标端口可连接，不代表协议握手或网页请求成功；某一种测试超时也不能独立证明服务器失效。检查服务器地址、端口、系统时间及当前网络，再核对协议、传输和安全参数。查看日志中是解析失败、连接被拒绝还是握手错误，必要时用另一网络做对照。每次只改一项并保留原配置，避免多处同时修改后无法判断原因。

已连接通常只表示本地服务或 VPN 接口已启动，不等于远端连接成功。先检查核心日志是否正常启动，再确认应用是否接入系统代理或 VPN；访问网页时观察是否出现请求记录。没有记录，重点查流量入口；有记录但失败，再查服务器握手、DNS 和路由。先用单一浏览器、单一网站验证，暂时停用可能改写代理的扩展，避免浏览器独立设置覆盖系统配置。

先在状态栏选择自动配置系统代理，并确认内核启动成功、本地监听端口没有被占用。随后打开系统网络代理设置，核对地址与端口是否指向当前实例。若数值很快被改回，检查其他代理软件、浏览器扩展或设备管理策略。部分应用不读取系统代理，需要在应用内单独配置或评估 TUN；遇到这类应用时，反复切换路由模式不会解决流量未进入客户端的问题。

保留现有可用配置，先记录更新时的错误，再分别检查地址是否过期、设备时间是否准确、域名能否解析和当前网络是否能访问订阅服务。HTTP 401 或 403 应优先核对授权与服务状态，超时则重点检查网络路径；返回成功但无法解析时，应检查内容格式。可在已有可用服务器的前提下对比直连与代理更新，但不要公开完整订阅地址，也不要把旧列表为空当作必须重装客户端的依据。

先在同一网络和浏览器中比较正常网站与异常网站，再查看异常域名的解析错误和路由命中记录。若改为临时全局规则后恢复，应检查先命中的直连或拦截规则；若日志明确提示域名解析失败，则检查客户端 DNS 配置、浏览器安全 DNS 及 TUN 的 DNS 接管是否相互影响。一次只调整一处，清理缓存并建立新连接后复测。网页能打开但部分资源失败时，也要检查资源域名，而不只是地址栏中的主域名。