客户端配置与常见问题

v2rayN 用于 Windows、macOS 和 Linux 桌面环境，集中管理订阅、系统代理与路由规则。v2rayNG 用于 Android，采用 Xray 内核，适合需要 VLESS 与 REALITY 等配置的场景。v2flyNG 同样用于 Android，属于 V2Fly 内核路线的备选客户端。选择时先确认操作系统，再核对订阅要求的协议、传输方式和内核功能；应用名称相近并不代表配置可以完整互换。已有配置能够稳定使用时，不必仅为更换名称而迁移，迁移前应保存订阅地址并记录自定义规则。

v2rayN 等客户端提供图形界面，负责导入配置、管理服务器和启动连接；Xray 或 V2Fly 内核负责实际处理流量。VMess、VLESS、Trojan 与 Shadowsocks 是代理协议，传输方式和传输安全设置则决定连接如何承载与保护。订阅是批量分发配置的入口，通常还会随更新调整服务器列表。排查时应按层定位：列表为空先看订阅，启动失败先看内核，只有某个配置不能连接再看协议参数。订阅导入成功只说明客户端取得并解析了内容，不等于其中所有服务器都能正常连接。

VLESS 是代理协议，REALITY 是 Xray 支持的传输安全方案，两者不在同一层级。常见配置会把 VLESS 与 REALITY 组合使用，但仍需同时匹配传输类型、服务器名称、公钥、短标识及流控等参数，具体字段以服务端配置为准。客户端出现 VLESS 选项，不代表当前内核已经支持配置中的全部 REALITY 功能。遇到无法识别字段或启动报错，应先核对内核类型和客户端支持范围，再检查链接是否完整；不要随意删除公钥或更改服务器名称来尝试连接。

v2rayN 的系统代理负责让遵循系统代理设置的应用接入本地代理，路由规则负责决定已接入流量使用代理还是直连。全局路由通常把已进入内核的流量交给代理出口，并不自动接管整台设备。TUN 通过虚拟网络接口接入更多应用流量，但仍受路由、排除项和 DNS 配置影响。Android 客户端的 VPN 模式也用于设备流量接入，不等于商业 VPN 服务账号。设置时先确认应用流量是否进入客户端，再判断出口是否符合规则，避免把接入问题误当成分流问题。

v2rayN 导入订阅时，应在订阅分组的地址字段粘贴完整订阅 URL，再执行该分组的更新操作；单条分享链接应使用对应的剪贴板导入入口。先检查复制内容是否混入空格、换行、说明文字或聊天软件添加的标点，再确认链接没有过期。若地址返回的是登录页、错误页或不受支持的配置格式，客户端即使访问成功也无法生成服务器列表。不要把订阅地址提交到陌生转换网站；它可能包含访问凭据。可向配置提供方确认客户端支持情况，并保留错误提示以便区分下载失败与解析失败。

v2rayN Desktop 版采用新一代跨平台界面，WPF 版是 Windows 的经典界面路线。首次安装可优先了解 Desktop 版；已有 WPF 使用习惯或依赖特定界面操作时，应先核对两版对应功能再决定迁移。安装前确认系统与处理器要求，并按安装程序提示处理运行库依赖。跨版本迁移应先备份订阅分组和自定义配置，不要让两个实例同时占用相同的本地监听端口。遇到启动失败时，记录具体报错并检查权限与依赖，不宜直接覆盖原目录或反复混用不同版本的程序文件。

v2rayNG 与 v2flyNG 的 arm64 安装包适合运行 64 位 ARM 系统的设备，通常体积更小；universal 包含多种处理器架构，适合无法确认架构或需要兼容其他架构的情况。较新的主流手机通常可以选择 arm64，但处理器支持 64 位并不保证系统也运行在 64 位模式，应以设备系统信息为准。出现解析失败或不兼容提示时，先检查系统版本要求和架构，再尝试通用包。更新应用还需保持签名兼容；若提示签名冲突，应先备份配置并确认安装来源，避免直接卸载造成配置丢失。

v2rayN 的 TUN 模式可能需要管理员权限、系统网络扩展授权或相应的虚拟接口组件，具体取决于操作系统与客户端版本。先按当前版本说明完成授权，再检查日志是否指向接口创建失败、路由写入失败或端口冲突。Android 使用 v2rayNG 的 VPN 模式时，需要确认系统连接授权；若另一款应用正在占用 VPN 服务，应先停止它。不要仅因权限报错就关闭系统安全防护。修改前记录原有模式，一次只处理一个冲突项，测试结束后停用暂时不需要的接入方式，避免重复接管流量。

v2rayN 的绕过大陆预设通常依据域名与 IP 规则，把匹配的中国大陆地址交给直连出口，其余流量按规则处理；实际结果取决于当前规则内容、匹配顺序和规则数据。全局路由适合短时验证代理出口，或确实需要统一出口的应用场景，但可能让本可直连的请求绕远。日常使用可先选择适合网络环境的分流预设，再为特殊域名添加明确规则。切换后需要重新建立测试连接，因为已存在的连接可能继续使用原出口。切记路由只处理已进入内核的流量，不能替代系统代理或 TUN 接入。

v2rayN 与 Android 客户端通常会把订阅分组视为由远端内容管理的列表，更新时可能重建条目，因此直接修改订阅条目的地址、备注或协议参数未必能够保留。需要长期维护的个别配置，可在客户端支持的情况下复制到独立的手动分组，再进行修改。路由规则、应用分流与订阅条目属于不同设置层，应分别备份。更新前后可比较分组内的条目名称和配置变化，不要只看列表数量。配置提供方主动变更参数时，旧条目可能失效；保留旧配置便于对照，但不代表旧参数仍可继续使用。

v2rayNG 后台断开时，先检查系统电池优化、后台活动权限和设备厂商的应用管理设置；只有确认应用被系统终止后，再按需允许后台运行。耗电增加则应区分客户端持续处理大量流量、网络反复重连与其他应用频繁唤醒。查看系统电池统计，并在相近使用时长和流量条件下比较，不能只凭通知栏常驻判断耗电异常。若开启了始终开启的 VPN 或阻止未经过 VPN 的连接，停用客户端后可能影响网络。调整这些系统选项前，应先理解其断网保护效果，再选择保活与续航之间的平衡。

v2rayN 可结合连接日志、应用自身代理设置与出口 IP 查询判断流量路径。先关闭已有测试页面并建立新连接，再对照目标域名匹配到的路由规则；仅看到客户端处于运行状态，不能证明该应用已经使用代理。命令行工具、开发工具和部分浏览器可能维护独立代理设置，需要分别核对。出口查询只反映该次请求的路径，不代表全部域名或 DNS 请求都采用相同出口。Android 还应检查应用分流的包含或排除列表。分享日志求助前，删除订阅 URL、认证参数和其他可关联个人账户的信息。

v2rayN 的订阅更新失败时，先保留现有列表，再区分网络请求失败与内容解析失败。检查设备时间、当前网络是否需要登录、订阅是否到期，以及地址是否被配置提供方更换。若客户端提供直连或经代理更新的选项，可在已有可用连接的前提下对照测试，避免依赖尚未取得的配置来获取订阅。证书错误应先核对时间与地址，不要直接关闭证书验证。若多个分组只有一个失败，优先检查该订阅；若全部失败，再检查网络、DNS 与本地代理状态。频繁点击更新通常不能解决服务端限制或内容格式变化。

v2rayN 或 v2rayNG 显示超时，只能说明本次测试未在限定时间内完成，不能直接认定配置失效。不同测试可能只检查 TCP 建连，也可能发起真实网页请求，结果不能混为一谈。先使用真实请求测试并查看日志，再核对服务器地址、端口、系统时间和协议参数。若只有单个条目异常，可切换同订阅的其他条目对照；若全部超时，优先检查当前网络、DNS、内核启动状态及本地端口。还可换一个网络复测，以区分本地环境与远端服务问题。不要通过随意修改加密方式或跳过安全验证来掩盖参数错误。

v2rayNG 的连接状态首先表示本地服务已经启动，不保证远端握手、域名解析与目标网站访问全部成功。先检查日志中是否存在认证失败、连接拒绝或 DNS 超时，再分别测试常用网站与单个异常网站。Android 应核对应用分流列表，桌面端则检查浏览器是否采用了独立代理。若启用了自定义 DNS、TUN 或复杂路由，可先记录设置，再逐项回到已知可用的组合进行比较。还需检查设备时间与网络登录页面。一次只改变一个选项，确认故障出现在哪一层后再修改，避免同时更换服务器、DNS 和路由导致原因无法复现。

v2rayN 系统代理不生效时，先确认内核已运行、本地监听端口正确，再在系统网络设置中查看代理地址是否与客户端一致。浏览器扩展、其他代理软件、组织策略或应用自身设置都可能覆盖系统代理；命令行程序也未必读取这项设置。退出后无法上网，可能是系统仍指向已经停止的本地代理端口，可先重新打开客户端并清除系统代理，再核对系统设置。若使用过 TUN，也要检查虚拟接口与路由是否正常恢复。不要在公司或学校受管理设备上强行修改策略，应区分个人设置残留与管理员施加的配置。