Windows
桌面首选 v2rayN。桌面版与经典 WPF 版是同一客户端的两套界面:需要跨平台一致的界面时选桌面版,沿用旧版操作习惯时选经典 WPF 版。下载前在系统设置的「系统 → 关于」查看系统类型,确认设备是否为下载页所列的架构。
从旧版迁移时,先按客户端提供的方式备份配置。旧程序若仍在托盘运行,应先退出,再启动新程序。两份程序同时运行可能争用本地代理端口;这类启动报错应先查端口,而不是删除订阅重来。迁移后也要复核系统代理是否指向新程序正在监听的端口。
前往下载客户端下载
先选系统,再核对芯片架构。下载页单独列出各安装包的系统要求。
桌面首选 v2rayN。桌面版与经典 WPF 版是同一客户端的两套界面:需要跨平台一致的界面时选桌面版,沿用旧版操作习惯时选经典 WPF 版。下载前在系统设置的「系统 → 关于」查看系统类型,确认设备是否为下载页所列的架构。
从旧版迁移时,先按客户端提供的方式备份配置。旧程序若仍在托盘运行,应先退出,再启动新程序。两份程序同时运行可能争用本地代理端口;这类启动报错应先查端口,而不是删除订阅重来。迁移后也要复核系统代理是否指向新程序正在监听的端口。
前往下载在「关于本机」查看处理器信息。显示 Apple 芯片时选 Apple Silicon 包,显示 Intel 处理器时选 Intel 包;不要凭设备外壳或购买年份猜架构。打开磁盘映像后,按安装窗口提示将 v2rayN 移到「应用程序」,再从该目录启动。
切换 Wi-Fi 与有线网络后,如果同一个应用突然绕过代理,先确认当前网络服务的代理设置,而不是马上重装。共享电脑上的配置也应分开管理:不要把包含订阅地址的导出文件留在公共目录。若系统弹出权限提示,先核对提示所指的应用和操作,再决定是否授权。
前往下载需要 Xray 内核时先看 v2rayNG;配置明确要求 V2Fly 内核时选 v2flyNG。系统支持 arm64 时可选对应的安装包,不确定设备应用架构时可选通用包。首次启动连接会打开系统的 VPN 授权对话框;导入列表本身不会启动 VPN 服务。
当连接只在锁屏后中断,先检查应用的后台运行限制,再看网络和节点。设备上若已有另一款应用占用 VPN 服务,先停止那款应用,再单独验证新设置。仅某个应用无法联网时,优先看分应用代理清单是否选反;其他应用正常不代表该应用也被纳入。
前往下载v2rayN 按发行版包格式和处理器架构分别提供入口。使用 Debian 或 Ubuntu 时看 deb,使用 Fedora 等采用 RPM 的发行版时看 rpm;确认系统为 x64 或 arm64 后,再选相应文件。软件包格式正确,并不表示发行版已满足所有运行依赖。
图形桌面、终端程序和浏览器不一定读取同一套代理设置。桌面能联网而终端不通时,先核对该终端程序采用的代理来源。若安装工具报告依赖缺失,保留原始提示并对照发行版要求,不要反复下载其他架构的包。需要 TUN 时,再另外检查虚拟网卡权限和现有路由。
前往下载配置链路
左图按配置顺序阅读,不是数据包的流向图。先把节点和分流设好,再选择由谁把应用流量交给客户端。遇到故障时也按这几层拆开检查,避免把订阅更新失败、节点握手失败和应用未使用代理混成一个问题。
v2rayN · 配置顺序
outboundTag订阅分组解决的是节点来源和更新范围问题。在 v2rayN 打开「订阅分组 → 添加订阅分组」,填写备注与订阅地址,保存后执行「更新全部订阅」,再查看对应分组是否出现节点。v2rayNG 则从「订阅分组设置」添加地址,返回主列表后再更新。保存地址和下载列表是两次操作;空列表先看更新提示、地址有效期和返回格式,不要把订阅地址贴进公开日志。
活动服务器决定代理出站使用哪个节点。v2rayN 可以在列表里右键「设为活动服务器」,然后观察日志是否使用了该节点;v2rayNG 通常先点选节点,再点底部连接按钮。切换后用同一个目标复测,才能把节点差异与网络差异分开。单次延迟只能说明当时测试路径的响应情况;初始化、认证与目标应用访问仍需分别看结果,不宜只凭数字决定节点是否可用。
路由规则用域名、地址等条件决定走哪条出站。v2rayN 在「路由设置」中选择并编辑规则集;v2rayNG 可以先从设置中的预定义规则入手,不必照搬桌面规则界面。排查规则冲突时,将较具体的匹配项放在宽泛条件之前,再从日志确认实际命中的出站。首次编辑只加一条能复现、也容易撤销的规则;如果同时改解析策略和兜底项,结果便很难归因。
出站是路由匹配后的去向。规则中的 outboundTag 必须对应配置里实际存在的出站标签;直连不经过代理服务器,而拦截出站会阻断匹配的连接。v2rayN 的图形编辑器可直接选择出站,手写配置则需要核对标签拼写,也不能假定另一套规则集使用同名标签。验证时分别选择应走代理和应走直连的目标,看看两种结果是否符合预期。
系统代理适用于遵循系统代理设置的应用;有些程序使用自身的代理选项。需要让虚拟网卡接收流量时,再在 v2rayN 测试「启用 Tun 模式」,并核对权限、路由和解析设置。v2rayNG 依赖系统 VPN 授权,不是复用桌面系统代理;分应用清单也会改变接管范围。排查时先停用当前模式,再切到另一种模式验证,以免两个代理入口同时生效而掩盖故障。
首次配置
准备服务方提供的订阅地址或单节点分享链接。两者用途不同:订阅地址添加到「订阅分组」,用于拉取并更新一组服务器;单节点分享链接走服务器导入入口,不用填进订阅地址栏。如果拿到的是一个订阅管理网页,先从管理界面复制客户端适用的订阅地址,不要直接复制浏览器地址栏里的登录页面。
在 v2rayN 保存订阅分组后执行更新,切到新建分组查看节点是否出现。若已有多个分组,给新分组加能辨认来源的备注,并在该分组内核对协议类型。更新后看到旧列表时,先看这次是否真的更新成功,不要凭节点名称判断。若更新失败,读清提示是下载、认证还是解析错误,再回头检查对应环节。订阅地址可能带有访问凭据,截图和求助时应遮住整条地址。
先选一个与客户端内核兼容的节点。在 v2rayN 把它设为活动服务器,再从托盘「系统代理」选择「自动配置系统代理」,用遵循系统设置的浏览器开始测试。仅运行客户端不代表浏览器已使用代理;若浏览器装有代理扩展,先检查扩展是否覆盖系统设置。不要在同一次测试中同时换节点、改 DNS、启用 TUN,否则即使结果变好,也无法确定是哪项变更生效。
在 v2rayNG 主界面点选节点后启动连接,按系统提示授予 VPN 权限。首次测试先不改分应用清单;基础连接确认后,再限定哪些应用需要纳入或排除。桌面程序如果明确不读取系统代理,可以先检查它是否支持手动填写本地代理;确需使用 TUN 时,再按安装大全核对该平台的权限和路由要求。
用同一个应用访问预期走代理的目标,随后用一个应当直连的目标核对分流。每次只更改一个设置,并记下重试时间,与运行日志对应。图标亮起只说明服务已经启动,测试延迟有响应也不等于实际应用的请求经过了正确的出站。浏览器若已经缓存内容,可用一次新的请求复测,不要把页面仍然可见当成连接成功。
若日志没有相应入站,先查应用代理设置和本地监听端口;若有入站但命中了直连,先查规则顺序和目标匹配条件;若已选代理出站却握手失败,再核对服务端参数、网络连通性和系统时间。需要恢复时,撤回最近一次改动再比较,不必先清空整个客户端。退出测试前把临时提高的日志级别调回原值,避免日常使用积累过多连接记录。
开源生态
早期 Project V 将 V2Ray 作为处理网络代理的核心组件。核心负责监听本地入口、匹配路由条件并建立出站连接;图形客户端负责把订阅、节点列表和常用设置组织成可以操作的界面。这种分工延续到今天:用户可以更新一个订阅组、切换一个活动节点,客户端再据此生成内核所需的配置,不必每次手工修改整份文件。
日常讨论中的「装 V2Ray」可能指装客户端,也可能指配置内核。看教程前先分清这两个层次。菜单找不到,通常要对照客户端和界面版本;内核启动失败,则先看具体的配置字段和运行日志。这两类问题处理顺序不同,不能仅凭界面长得一样就套用别人的配置步骤。
V2Fly 延续 V2Ray 核心的社区维护;Xray 从 V2Ray 代码演进而来,形成独立的内核家族。两者共享一些协议和配置概念,但支持的传输、安全选项与字段并不完全相同。v2rayN 能按配置使用不同内核,不表示任意节点都可以在内核之间互换。移动端选型也以已有节点要求为先,而非只比较界面。
例如,服务方明确要求 REALITY 或指定 XTLS Vision 流控时,应先确定所选内核和客户端组合支持相应功能,再核对节点协议、传输方式和安全层。只替换内核而保留一套不兼容的参数,节点有时仍可显示在列表里,却无法实际建立连接。需要逐项比较入口和功能时,可查看三款客户端对照。
v2rayN、v2rayNG 和 v2flyNG 都是开源图形客户端。v2rayN 面向桌面,v2rayNG 使用 Xray 内核,v2flyNG 提供基于 V2Fly 内核的安卓备选。客户端与内核分别维护,随包分发的组件可能采用各自的开源许可证,应以对应软件包的许可说明为准。开源描述的是代码和分发条件,不代表第三方订阅服务或节点的运营方式。
VMess、VLESS 和 Trojan 是节点可能采用的代理协议,REALITY 则是 Xray 生态中的安全机制,不是与前三者并列的代理协议。读节点信息时,先区分协议、传输与安全设置,再对照内核支持情况。需要查某个字段是由客户端填写还是由内核解释,可从概念速查开始。
更新安装包会更换客户端程序,也可能带来内核、依赖或界面入口的变化;更新订阅则重新读取服务方提供的节点列表。某个旧节点在更新后消失,先确认订阅端是否删减了条目以及活动服务器是否需要重选。旧配置迁移后如果界面仍在,内核却无法启动,再核对生成配置时使用的参数是否仍然受支持。
升级前记录主要配置与代理模式,按界面提供的方式备份需要保留的内容。升级后先用原有节点复测,确认程序正常,再调整规则;不要边迁移边重写分流。遇到界面说明与实际界面不同,优先按消息提示、内核日志和系统要求判断。各平台的安装顺序与常见限制可在安装大全对照。
延伸阅读
讲解 v2rayNG 的 VpnService 授权流程、各品牌系统的省电白名单设置,以及分应用代理的正向与反向模式用法。
适合已能启动连接,但发现锁屏后掉线,或只有个别应用未按预期走代理的读者。两种现象对应不同设置,先区分再改。
用通俗方式讲清 REALITY 的握手伪装思路与 XTLS Vision 减少重复加密的流控机制,以及它们在 Xray 内核中的配合。
从客户端字段入手,区分安全层和流控的职责,理解为什么导入成功后仍要核对内核支持情况。
按系统代理、本地端口、节点时间、DNS、路由规则、TUN 冲突的顺序逐项核对,定位已连接但无法上网的真实原因。
准备一个能稳定复现问题的测试目标。先确认应用请求是否进入客户端,再查路由和握手,避免对同一故障来回切换节点。