Windows
首次安装可从 v2rayN 桌面版开始;已经熟悉经典界面的用户可选 WPF 版。两种入口主要对应不同的界面实现,菜单名称和位置可能有差异。阅读教程时先辨认界面,再找订阅、路由和系统代理的对应入口。
若只是从旧版迁移,先保留原配置和订阅信息,再用新客户端验证一条曾经可用的节点。这样遇到异常时,可以先区分界面变化、导入问题和连接问题。
前往下载 →先确认操作系统,再核对处理器架构与安装格式。同名客户端可能提供多个安装包;包的差别不等于可用节点的差别。
首次安装可从 v2rayN 桌面版开始;已经熟悉经典界面的用户可选 WPF 版。两种入口主要对应不同的界面实现,菜单名称和位置可能有差异。阅读教程时先辨认界面,再找订阅、路由和系统代理的对应入口。
若只是从旧版迁移,先保留原配置和订阅信息,再用新客户端验证一条曾经可用的节点。这样遇到异常时,可以先区分界面变化、导入问题和连接问题。
前往下载 →在系统信息中查看芯片或处理器:Apple Silicon 选 arm64,Intel 选 x64。不要只凭电脑的外观、系列名或购入时间判断,同一产品系列可能同时存在不同架构的机型。
应用能够打开只说明安装环节已经通过。首次连接时,再分别确认订阅列表能否刷新、节点是否已选中,以及用于测试的应用是否采用当前系统代理设置。
前往下载 →v2rayNG 使用 Xray 内核;需要 V2Fly 内核时可选 v2flyNG。确认系统支持 arm64 后选对应安装包,无法判断时可对照下载页的通用版说明。先选能处理目标配置的客户端,再比较体积和安装格式。
首次启动连接时,系统可能弹出 VPN 连接授权。授权后再打开一个测试应用确认流量是否经过客户端;如果设备已有其他 VPN 服务在运行,先检查它是否占用了系统的 VPN 连接。
前往下载 →桌面环境可使用 v2rayN。通常 Debian、Ubuntu 系选择 deb,Fedora 系选择 rpm;包格式确定之后还要核对架构,不能把发行版名称当成处理器类型。安装失败时先读包管理器的报错,区分架构、依赖和权限问题。
安装成功后也要单独验证应用接入:各桌面环境对系统代理的实现不尽相同,有些应用使用自己的网络设置。若浏览器正常而另一应用不通,先检查后者的代理设置。
前往下载 →客户端先取得节点配置,应用流量进入之后,内核才会解析目标并按规则选择出站。排查时沿这条路径寻找第一个出现异常的环节。
能看到节点列表,说明至少取得了一份配置;能连上节点,说明该节点在当前条件下可用;目标应用能访问,则还要求它的流量确实进入客户端,并命中了期望的规则。这三个结果不能相互替代。
初次设置时,先用一条节点和一个应用建立可重复的测试。记录接入模式、目标地址和测试结果,然后再加路由规则或调整 DNS。保留这份记录,后续才能判断异常来自新设置还是网络环境变化。
路由规则适用于同一设备要让不同目标走不同出口的场景。系统代理主要决定哪些应用把请求交给客户端;路由决定已经进入内核的流量往哪里走。编辑规则时,先写清匹配条件和目标出站,再将范围较窄的例外放在会覆盖它的通用规则之前。测试时各选一个应该命中的目标和一个不应命中的目标,并对照客户端可用的连接日志检查实际出站。规则生效但结果不符时,先查顺序,再查节点。
域名解析异常和连接超时有时会表现为同一条页面报错。先确认是应用自行解析、系统解析,还是由内核处理查询,再决定改哪一层。客户端里的 DNS 配置不一定影响应用自带的解析器,也不是把服务器换成另一个地址就能让所有分流生效。核对规则使用的是域名还是地址,确认查询所用的网络路径,再用同一个域名重复测试。若测试结果前后不一致,同时考虑缓存是否仍在使用旧答案。
单条节点分享链接描述一条连接配置,订阅地址则用于取得并刷新一组配置。两者不能只按链接的外观区分,也不应随意填入同一个入口。导入前按来源给分组命名,刷新后先核对节点是否出现在对应组内,再做连接测试。使用关键词过滤时,要区分筛选后的视图和订阅实际返回的内容。若更新后找不到节点,先取消过滤并核对分组,不必马上删除订阅或重新安装客户端。
客户端能识别分享链接,不代表当前内核能运行链接描述的完整配置。选择内核时,把协议、传输和安全设置分开核对,而不是只认节点名称或协议缩写。桌面客户端支持的内核组合也不一定和移动客户端一致。若切换内核后启动失败,先用原有可用配置验证改动,再检查日志指向的是字段解析错误、端口被占用,还是出站连接失败。不同阶段的问题不适合用同一种方式处理。
辨认项目、内核与图形客户端三类名称,可以解释为什么同一份教程不能逐字套用到每个应用,也能缩小排查问题的范围。
Project V 是相关代理工具的项目体系,V2Ray 是其中用于处理连接的核心组件。后来,V2Fly 社区延续了 V2Ray 的开发,Xray 则从这一代码家族分出并独立演进。两者共享一批基本概念:入站接收流量,路由判断走哪一路,出站负责把连接交给下一站,或者按配置拒绝连接。首屏的四个出站名称是示意标签,实际名称与行为由配置定义。
以浏览器为例,当它采用本地代理设置时,请求才会到达相应入站;内核随后用可获得的目标信息匹配规则。若浏览器绕过了代理,即使内核正在运行,也不会替它执行分流。理解这层边界,比记住某个版本的按钮位置更有用:设置界面会变,但流量需要先进入内核这一前提不变。
V2Fly 与 Xray 各自维护协议实现和配置功能。它们的文档可能都出现入站、出站等字段,但字段同名并不保证每个选项都可互换。VMess、VLESS 等名称描述协议的一部分;连接还会受到传输方式、安全设置以及两端实现的影响。服务端的配置决定了客户端需要满足哪些条件,不能根据节点备注中的地区或线路名称推断。
迁移时先保留旧环境,将同一条已知可用的配置单独导入新环境。若界面识别节点但内核未能启动,先读启动错误;若内核启动后只有该节点不通,再回到节点参数和网络可达性。用这个顺序排查,可以避免把传输参数不符误判为订阅过期,也能避免一开始就修改整套分流规则。
三款客户端各自公开源代码。v2rayN 面向桌面,提供订阅、节点和路由配置的管理界面;v2rayNG 以 Xray 为内核;v2flyNG 提供以 V2Fly 为内核的移动端选择。客户端与内核是不同层的项目,订阅列表的展示方式、界面菜单的布局、系统权限的申请流程,不能用来判断内核是否属于同一分支。
开源许可约束的是代码的使用、修改与再分发,不能代替对第三方订阅服务的判断。免费使用客户端与付费购买线路是两件事。配置中若包含订阅地址或节点凭据,不应把整份文件贴到公开讨论区。报告问题时,通常只需提供操作系统、客户端和内核名称、故障出现的阶段,以及去掉敏感字段的报错摘要。
客户端更新可能改变界面和系统接入方式,内核更新可能改变新增特性的支持范围或配置的解析行为,订阅刷新则会重取节点列表。安装包有时随附内核,因此一次升级可能同时影响前两层;但刷新订阅并不会把应用升级,也不会自动修复本地路由错误。排查更新后的故障,第一步是弄清这次实际改了什么。
保留旧设置后,可以用固定网络、固定节点和固定测试目标做前后对照。先确认应用能启动,再确认节点仍然可用,最后检查此前的规则是否命中。若只有规则结果变化,还要看域名和地址数据是否随更新一起更换。把几个动作拆开做,能保留明确的回退点,也能给维护者提供更有用的复现描述。
起步时先按订阅导入教程建立一个可用状态,再考虑更复杂的规则。列表未更新时,重点检查订阅来源和获取过程;列表正常而所有节点均失败时,先核对当前网络、接入模式与内核启动状态;如果只有个别应用失败,则检查该应用是否使用系统代理、是否有独立 DNS 设置,以及它的目标命中了哪条规则。
比较连接质量时,不要用一次延迟结果代替实际体验。网页短请求关注响应时间,文件传输更容易反映持续吞吐,两者受不同因素影响。使用同一网络和同一测试目标重复比较,把网络切换、节点更换和配置改动分别记录。若设置回退后请求仍不稳定,应重新检查节点和线路,而不是继续叠加本地规则。
从单机连接到局域网部署,这三篇文章分别处理接入范围、节点取舍与规则优先级。按现有问题选读即可。
/ 部署实践
概览在主路由与旁路由上直跑 Xray 内核的几种方式,对比性能需求、透明代理接管与维护成本,帮助判断是否值得部署。
如果只有一台电脑需要专门配置,单机部署通常更容易测试和恢复。把配置放到网关前,先明确哪些设备应受影响、故障时由谁恢复网络,以及如何验证局域网服务仍能互通。部署的难点往往不是启动内核,而是让接管范围与预期一致。
/ 入门指南
面对订阅里几十个节点,从延迟测试、流量倍率、地区用途到 VMess、VLESS、Trojan 协议差异,给出入门选择思路。
先按用途排除不合适的地区或计费方式,再在同一网络环境下比较候选节点。综合观察响应速度和稳定性,而不是单次测速的排名。
/ 路由分流
逐条拆解 domain、full、regexp、ip 与 geosite、geoip 写法,说明规则自上而下匹配的顺序与常见冲突的处理方式。
只改一条规则,再同时检查原本应当走直连的目标和应当走代理的目标,能更快发现规则匹配范围是否比预期更大。