V2RAY HELP
V2Ray 安装、订阅与连接常见问题
按基础认知、安装配置、使用技巧和故障排查整理 v2rayN、v2rayNG、v2flyNG 的常见问题。建议先确定问题所在层级，再依次检查客户端、订阅、节点、本地代理与系统网络设置。
01 / 基础认知
客户端、内核与订阅
先区分图形客户端、运行内核、协议类型和订阅格式。名称相近不代表安装包或配置可以直接互换。
V2Ray、v2rayN 和 v2rayNG 分别是什么？
V2Ray 通常指 Project V 相关协议、配置体系与内核生态。v2rayN 是面向 Windows、macOS 和 Linux 的桌面图形客户端，负责订阅管理、节点选择、系统代理和路由设置。v2rayNG 是 Android 图形客户端，主要使用 Xray 内核。三者不是同一个安装包，选择时应先按设备平台确定客户端。
V2Fly 内核和 Xray 内核有什么区别？
V2Fly 延续 Project V 的开源实现与配置体系，Xray 在相近配置结构上扩展了更多协议与传输能力。常见 VMess、VLESS、Trojan 和 Shadowsocks 配置在两类内核中有较多共通字段，但具体传输选项并不完全相同。导入订阅时应以服务提供方标注的协议和客户端支持范围为准。
Windows、macOS、Android 和 Linux 应该选择哪个客户端？
Windows、macOS 和 Linux 可优先选择 v2rayN，统一管理订阅、路由规则和系统代理。Android 可优先选择使用 Xray 内核的 v2rayNG；需要使用 V2Fly 内核时再选择 v2flyNG。不要把不同平台的安装包交叉安装，桌面安装包与 Android 安装包的格式和运行环境不同。
VMess、VLESS、Trojan 和 REALITY 应该怎么选？
客户端中的协议类型必须与服务端配置一致，不能只依据名称自行切换。已有订阅时通常不需要手动选择，客户端会从订阅内容读取协议。手动添加节点时，应逐项核对地址、端口、用户标识、传输方式、TLS 设置、服务器名称和路径。REALITY 还需要匹配公钥、短标识等对应字段。
订阅链接和单个节点分享链接有什么区别？
订阅链接通常包含一组节点，并可通过更新操作同步节点增删和参数变化；单个分享链接只描述一个节点，常见前缀包括 vmess、vless、trojan 或 ss。长期使用多个节点时适合建立订阅分组，临时导入单个配置时可使用剪贴板分享链接。删除订阅分组前应确认其中是否还有需要保留的节点。
02 / 安装配置
版本选择与首次导入
安装包先按操作系统和处理器架构选择。完成安装后，再处理订阅保存、更新和首次连接。
Windows 上的 v2rayN 桌面版和经典 WPF 版怎么选？
桌面版采用新一代跨平台界面，适合希望在不同桌面系统间保持相近操作方式的用户；经典 WPF 版面向 Windows，界面与既有教程更接近。两者都能完成订阅、节点和系统代理管理。首次安装可从桌面版开始，已有稳定配置和操作习惯时可继续使用 WPF 版。
macOS 应该下载 arm64 还是 x64 安装包？
采用 Apple 芯片的设备选择 arm64，采用 Intel 处理器的设备选择 x64。可打开系统信息，在硬件概览中查看芯片或处理器名称。安装包架构选错时，常见表现是无法打开、提示架构不兼容或需要额外转译。确认设备架构后重新下载对应安装包即可，不需要修改订阅内容。
Android 的 arm64 和 universal 版本怎么选？
2015 年后发布的主流 Android 手机和平板通常可选择 arm64，安装包体积更集中。无法确认处理器架构、设备较旧或 arm64 安装失败时，可改用 universal 通用版。两种版本的主要功能一致，区别在于包含的处理器架构范围。更新客户端时建议继续使用与当前安装相同的版本类型。
订阅链接导入后为什么没有节点？
先确认使用的是添加订阅入口，而不是手动添加单个服务器入口；保存订阅后还需要执行一次更新。若分组存在但节点为空，应检查链接是否完整、是否带有多余空格、是否已过期，以及客户端是否支持返回的订阅格式。还可在浏览器中确认链接能够正常访问，但不要公开分享带有个人授权信息的订阅地址。
首次导入订阅后应该按什么顺序连接？
先更新订阅并确认节点列表出现，再选择一个与当前网络条件匹配的节点。桌面端随后启用系统代理，Android 端则点击连接并确认系统弹出的网络连接授权。完成后用浏览器访问常用网站验证连接。若失败，应先换一个节点测试，再检查本地端口、路由模式和系统时间，避免同时修改过多设置。
03 / 使用技巧
代理模式、TUN 与分组
客户端成功启动后，连接行为主要由系统代理、TUN、路由模式和订阅分组共同决定。
v2rayN 如何手动更新订阅？
在订阅分组或订阅管理菜单中找到更新操作，选择更新当前分组或全部分组。更新完成后查看节点数量和名称是否变化，并重新选择需要使用的节点。若更新覆盖了手动备注，可在分组层级设置便于识别的名称。自动更新间隔不宜设置得过短，应根据订阅内容实际变化频率安排。
系统代理模式、PAC 模式和不改变系统代理有什么区别？
系统代理模式会把操作系统支持代理的应用流量交给客户端本地端口；PAC 模式依据规则决定哪些地址经过代理；不改变系统代理只启动内核和本地端口，应用需要自行填写代理地址。浏览器与常规桌面应用通常先使用系统代理，开发工具或不读取系统代理的程序则需要单独配置或使用 TUN。
TUN 模式为什么需要额外权限？
TUN 模式需要创建虚拟网络接口并调整系统路由，因此通常要求管理员权限或系统网络授权。权限不足时，客户端可能显示启动失败、接口创建失败或路由写入失败。应从客户端提供的 TUN 设置入口完成组件配置，并允许系统授权。不要同时运行多个会接管虚拟网络接口的工具，以免路由发生冲突。
全局、规则和直连路由模式应该怎么用？
全局模式通常让符合接管范围的连接统一走当前节点，适合短时间判断节点本身是否可用；规则模式依据域名、地址或进程规则选择代理与直连，是日常使用的常见选择；直连模式主要用于暂停代理转发或排查本地网络。切换模式后应重新测试目标应用，旧连接可能需要关闭后再建立。
如何把多个订阅分组管理得更清楚？
可按服务来源或使用场景建立独立分组，并给分组设置稳定、易识别的名称。节点较多时使用包含或排除关键词过滤地区、线路类型和测试节点，避免所有条目混在一个列表中。更新前不要频繁删除再重建分组，否则本地筛选规则和备注可能需要重新设置。失效订阅应先停用，确认不再需要后再删除。
04 / 故障排查
超时、断网与启动失败
排查时先分清单个节点、全部节点、单个应用或整个系统的故障范围，再逐层缩小原因。
节点测试显示超时应该先检查什么？
先判断是单个节点超时还是全部节点超时。单个节点失败通常与该节点状态或参数有关，可更新订阅并切换其他节点；全部失败时应检查当前网络是否正常、系统时间是否准确、客户端内核是否成功启动，以及防火墙是否阻止本地进程。延迟测试方式与真实网页访问不同，测试超时后仍可用实际连接再确认一次。
客户端显示已连接但浏览器无法上网怎么办？
先确认浏览器能够访问普通直连网站，再检查客户端是否启用了合适的系统代理模式。随后核对当前节点是否可用、本地代理端口是否被占用、路由模式是否误设为直连，以及浏览器是否安装了会覆盖代理设置的扩展。可关闭浏览器全部窗口后重新打开，必要时先停用 TUN，只保留系统代理进行分层排查。
v2rayN 系统代理已开启但部分软件不生效怎么办？
部分软件不会读取操作系统代理，或只支持特定的 HTTP、HTTPS、SOCKS 代理格式。先在软件网络设置中查找代理选项，将地址填写为本机回环地址，并使用 v2rayN 当前显示的对应端口。若软件完全不支持代理，可评估使用 TUN 模式。修改端口后要同步更新应用设置，避免仍指向旧端口。
v2rayN 订阅更新失败有哪些常见原因？
常见原因包括订阅链接失效、授权信息过期、当前网络无法访问订阅地址、系统时间误差、证书连接异常、返回格式不受当前客户端支持，以及代理循环导致更新请求无法发出。可先复制原链接检查首尾空格，再尝试直连更新或切换可用节点更新。若服务方更换了链接，应删除旧地址并保存新地址后重新更新。
客户端启动失败或提示端口被占用怎么处理？
端口被占用表示其他程序或另一个客户端实例正在监听相同本地端口。先退出重复运行的代理客户端，并在任务管理器或系统进程列表中确认旧进程已经结束。仍有冲突时，可在本地监听设置中改用未占用端口，然后重启客户端。所有手动填写代理端口的浏览器、开发工具和局域网设备也要同步修改。