v2rayN 提供新一代跨平台界面的桌面版,以及经典 WPF 版。首次安装可以先看桌面版;已有 WPF 使用习惯时,可按运行环境选择。两种界面不意味着订阅服务不同,连接仍取决于配置内容与内核兼容性。
启动异常先检查运行环境、目录写入权限与安全软件提示,不要连续覆盖配置目录。更新前保存个人设置,确认新界面中的监听端口与原来一致。
客户端功能与配置入口
先确定设备和内核,再配置订阅、分流与流量接管。界面为设置示意,具体名称可能随客户端更新调整。
v2rayN 把订阅、服务器配置、路由规则和运行日志放在同一个桌面界面中。安装后先确认本地监听端口,再导入服务方提供的链接,选择活动配置并启动内核。系统代理适合遵循系统设置的浏览器和应用;终端工具则可单独指定代理地址。桌面版便于在不同系统间沿用操作习惯,但文件路径、网络权限和 TUN 授权仍需按系统分别处理,不能直接照搬另一台设备的运行环境。
查看桌面配置步骤 →v2rayNG 是使用 Xray 内核的安卓客户端,适合在手机上导入订阅、扫描分享二维码和选择路由模式。首次启动连接时,系统会请求建立 VPN 连接,确认后客户端才可接管对应流量。与桌面系统代理不同,安卓端通常通过本地 VPN 接口工作;如需只处理部分应用,可以检查分应用代理设置。连接中断时先看日志和系统电池限制,再检查订阅,避免把后台进程被暂停误判成服务器故障。
选择安卓安装包 →v2flyNG 面向需要 V2Fly 内核的安卓使用场景。选择它的依据是配置与内核的兼容性,而不是界面是否相似。导入前应核对协议、传输方式与安全设置;某个字段能在 Xray 中使用,并不代表在 V2Fly 中也有相同含义或实现。已有 v2rayNG 配置时,先保留原订阅,再用少量配置测试导入与连接。两款安卓客户端应分别管理授权与配置,测试期间只启动其中一款,减少 VPN 接口冲突。
阅读三款客户端对比 →订阅地址用于获取一组服务器配置,不等于客户端本身,也不等于单条分享链接。在订阅分组设置中填写完整地址和便于识别的备注,保存后执行更新订阅。更新只代表成功获取配置,是否能够连接仍需单独验证。出现更新失败时,先检查地址是否被截断、是否过期以及当前网络能否访问订阅端点,再决定是否使用经代理更新。订阅链接可能携带访问凭据,不宜出现在公开截图、聊天记录或故障报告中。
查看订阅更新排查 →路由规则决定一条连接直连、代理还是阻断,通常按顺序匹配,先命中的规则先起作用。初次配置可从绕过局域网与私有地址开始,避免影响打印机、路由器管理页和本地开发服务。需要按域名分流时,再添加范围明确的规则,并核对对应出站标签是否存在。DNS 会影响域名解析与部分规则的匹配结果,因此排查分流问题时要同时检查 DNS 设置,不能只看系统代理开关是否处于启用状态。
阅读 routing 字段说明 →TUN 模式通过虚拟网络接口接管流量,适合不读取系统代理设置的应用,但它不负责修复错误的服务器参数。先用本地代理确认连接可用,再开启 TUN,排查范围会更清楚。桌面系统可能要求额外网络权限或提权操作,Linux 还需留意虚拟接口、路由表和 DNS 的变化。若启用后局域网访问异常,先停用 TUN 并恢复原网络状态,再检查绕过规则,避免同时调整内核、DNS 和路由导致问题难以复现。
查看模式选择与验证 →客户端下载安装
桌面使用 v2rayN,安卓优先了解 v2rayNG。安装包类型、芯片架构和客户端内核是三个不同的选择维度。
v2rayN 提供新一代跨平台界面的桌面版,以及经典 WPF 版。首次安装可以先看桌面版;已有 WPF 使用习惯时,可按运行环境选择。两种界面不意味着订阅服务不同,连接仍取决于配置内容与内核兼容性。
启动异常先检查运行环境、目录写入权限与安全软件提示,不要连续覆盖配置目录。更新前保存个人设置,确认新界面中的监听端口与原来一致。
v2rayN 安装包按 Apple Silicon 与 Intel 芯片区分。先在“关于本机”中查看芯片信息,再选择对应架构。应用首次打开时,系统可能要求确认开发者相关提示,网络和代理配置权限也需要按实际提示授权。
安装完成不等于系统代理已经启用。先让客户端启动内核,再检查代理模式与浏览器请求;遇到权限提示时按教程逐项处理,不建议直接关闭系统安全机制。
v2rayNG 使用 Xray 内核,v2flyNG 是 V2Fly 内核备选。主流较新手机通常选择 arm64 包;不确定设备架构时,可先阅读通用版说明。不要仅凭两个客户端名称相似,就认定它们支持完全相同的协议字段。
首次连接需要确认系统 VPN 授权。若切换到后台后断开,检查电池优化和后台运行限制;同时运行其他占用 VPN 接口的应用,也可能让连接被替换。
v2rayN 的 deb 包适用于采用对应包管理体系的发行版,rpm 包用于另一类发行版;还要区分 x64 与 arm64。先确认发行版、处理器架构和桌面环境,再选安装包,避免把包格式与处理器架构混为一谈。
Linux 上不同应用读取代理设置的方式并不一致。桌面代理、终端环境变量与应用自身代理配置应分别检查;只有在确实需要更广泛接管流量时,再考虑 TUN 模式和相关网络权限。
首次连接流程
客户端负责读取配置和启动代理,不会自动提供可用服务器。准备好有权使用的订阅地址或分享链接,再按顺序操作。
首次测试尽量保持配置简单:一个活动配置、一种代理接入方式、一个明确的测试请求。连接稳定后再添加复杂分流和自动更新,出现问题时更容易找到改动来源。
查看完整教程 →在订阅分组中填入完整地址,保存后执行更新;单条分享链接则通过对应导入入口添加。看到配置条目后,核对协议、服务器地址和传输设置。订阅刷新失败与配置连接失败属于不同阶段,应分别查看日志,不能只靠反复更新订阅解决。
把准备测试的配置设为活动项,再启动连接。桌面先用系统代理或应用指定代理,安卓确认 VPN 授权。真连接测试可以辅助判断当前配置是否可用,但结果与测试目标和网络状态有关,不应只凭一次测试就删除整组配置。
浏览器打开测试页面,再用明确指定代理地址的命令检查请求。浏览器可用而终端不可用,通常应先看终端是否配置代理;两者都不可用,再检查内核日志、本地端口和远端连接。每次只改一个设置,保留能够复现问题的操作顺序。
Project V 开源生态
界面负责管理,内核负责执行。理解这层关系,比只记住一个客户端名称更有助于选型和排错。
图形客户端
v2rayN · v2rayNG · v2flyNG代理内核家族
Xray · V2Fly具体功能取决于客户端调用的内核及其配置支持。
Project V 是围绕网络代理能力形成的开源项目生态,V2Ray 是其中常见的核心名称。日常所说的“安装 V2Ray”,往往实际指安装一个图形客户端,再由客户端管理代理内核。订阅管理、托盘菜单和配置编辑是界面层的功能;接受本地连接、建立出站和执行路由,则由内核完成。区分这两层,才能判断错误来自界面设置还是内核运行。
V2Fly 延续 V2Ray 相关开发,Xray 是由 V2Ray 衍生并独立发展的内核项目。两者在部分协议与配置概念上相近,但功能、字段和更新节奏并不完全相同。尤其是 VLESS、REALITY 或某些传输选项,需要核对所用内核的实际支持。REALITY 属于连接安全相关技术,不能因为它常与协议名同时出现,就把它当成可以任意互换的独立代理协议。
v2rayN、v2rayNG 与 v2flyNG 都是开源客户端项目。桌面端的配置管理需求优先看 v2rayN,安卓端按 Xray 或 V2Fly 的兼容需求选择另外两款。开源意味着代码与相应许可可供了解,不代表任何来源的订阅都可信。客户端、内核以及随附组件可能采用不同的开源许可,涉及修改、再分发或打包时,应分别阅读对应许可文本和发布说明,不能只按客户端名称推断全部依赖的授权条件。
更新程序是更换客户端组件,更新订阅是重新获取服务器配置;前者不会自动延长服务有效期,后者也不会自动补齐内核缺少的功能。升级前记录原有代理模式、端口、路由和 DNS 设置,升级后先验证基础连接,再恢复进阶选项。配置文件包含的认证信息和订阅地址应妥善保管,提供日志时移除敏感内容,并保留足以定位问题的错误类型、发生时间与操作步骤。
先确认编辑的是客户端自身设置,还是交给内核执行的配置。内核 JSON 中,inbounds 定义本地入口,outbounds 定义流量出口,routing 把规则指向出站标签,dns 处理解析设置。字段名字相似不代表不同内核可以完整互换。手动修改前备份原文件,先检查 JSON 语法,再逐段验证行为;被客户端自动生成的文件还可能在下次启动时重写。
配置与排错文章
遇到问题时先定位阶段:程序能否启动、订阅能否更新、内核能否连接、应用是否实际使用代理。