Windows
v2rayN 首推v2rayN 提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版延续经典桌面交互;按系统要求与使用习惯选择,不必同时运行两套客户端。
安装前确认处理器架构与运行环境。便携方式使用时,把程序解压到可写、路径清晰的目录,不要在压缩包内部直接运行。首次测试先选系统代理,确认浏览器可访问后,再考虑 TUN 与其他进阶选项。
桌面使用 v2rayN,安卓选择 v2rayNG / v2flyNG;从下载到订阅导入与路由配置,按步骤完成。
配置管理 · 界面示意
客户端负责组织配置与调用内核,不会自动提供服务器或订阅。准备好由可信来源提供的订阅链接,再更新配置、选择条目,最后开启适合当前平台的流量接入方式。
界面上的“更新订阅”与“启动服务”是两个操作。前者获取远端配置,后者运行本地内核;更新成功并不等于连接已经建立。
配置工作区
先区分配置来源、规则决策和流量入口,再调整具体参数。下面展示的是设置项示意,不是可操作的客户端窗口;实际菜单位置以所用客户端为准。
订阅分组用于把不同来源的配置分开管理。先在客户端新增分组,填写便于识别的备注与订阅地址,保存后执行更新,再从对应分组选择条目。分组备注只帮助辨认,不会改变服务器参数。相比逐条粘贴配置,订阅能在来源变更参数后集中更新,但也可能覆盖远端管理的字段。需要长期保留的手动修改应单独备份;订阅链接通常含访问凭据,不应放进公开截图或转交在线转换页面。
路由规则决定请求走直连、代理还是阻止出站,不负责把应用流量送进客户端。通常先保留客户端预设,再按域名或地址增加少量明确规则。多条规则同时命中时,优先级与顺序会影响结果,应先阅读当前内核的匹配方式。相比把所有请求统一交给代理,分流可以保留局域网服务的正常访问,也更容易定位单个网站异常。修改后用同一个目标复测,并留意 DNS 解析得到的地址是否改变了匹配结果。
系统代理适合读取系统代理设置的浏览器与桌面应用;不遵循该设置的程序仍可能直接联网。TUN 通过虚拟网络接口接入流量,覆盖范围更广,但需要平台权限,并可能与其他虚拟网卡或网络工具冲突。初次配置先用系统代理验证,再根据应用需求尝试 TUN,不要把两个开关都当作必选项。安卓客户端通常通过系统 VPN 授权建立接入。无论选择哪种入口,最终的直连与代理行为仍由路由规则决定。
内核负责解析配置并建立实际连接,图形客户端提供导入、选择与运行入口。Xray 与 V2Fly 有共同的生态背景,但支持的协议扩展和配置字段并不完全相同。需要 REALITY 的配置应确认使用支持它的 Xray 内核;不要只看客户端名称判断兼容性。桌面端在客户端支持时选择对应内核,安卓端则可据此选择 v2rayNG 或 v2flyNG。切换后先检查启动日志,出现未知字段时核对配置来源与内核要求,而不是反复重装。
订阅能更新但网页打不开,通常需要继续检查流量有没有进入本地客户端,而不是立即更换订阅。先确认内核成功启动,再核对系统代理指向的本地端口,随后检查路由和 DNS。每次只改一个条件,保留修改前的设置,才能知道是哪一步产生了变化。多个客户端同时接管系统代理、浏览器单独配置代理扩展、其他程序占用监听端口,都可能造成界面状态与实际访问表现不一致。
遇到“全局代理”选项时,要先看它位于哪里:系统代理中的全局设置、客户端路由的全局模式与 TUN 流量接入并不是同一个概念。前者影响应用如何进入代理,路由模式影响进入后的请求走向。术语含义不确定时,先查术语表;需要逐项操作时,再按配置教程完成一次最小可用配置。
平台入口
先确定操作系统,再确定处理器架构。桌面端统一查看 v2rayN,安卓端按内核需求选择 v2rayNG 或 v2flyNG。具体安装包入口集中在下载中心,首页不展示版本号。
v2rayN 提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版延续经典桌面交互;按系统要求与使用习惯选择,不必同时运行两套客户端。
安装前确认处理器架构与运行环境。便携方式使用时,把程序解压到可写、路径清晰的目录,不要在压缩包内部直接运行。首次测试先选系统代理,确认浏览器可访问后,再考虑 TUN 与其他进阶选项。
v2rayN 按 Apple Silicon 与 Intel 处理器分别提供入口。先通过“关于本机”确认芯片,再选对应安装包;处理器选型与订阅协议是两件事,不会因换包而自动转换配置。
安装后按系统提示处理应用权限,启用系统代理时确认当前网络服务的代理设置已同步。若只在部分应用中失败,先检查应用是否读取系统代理;需要 TUN 时,再按教程核对权限和虚拟接口状态。
v2rayNG 使用 Xray 内核,适合需要相应协议支持的配置;v2flyNG 使用 V2Fly 内核,作为按配置需求选择的备选。主流设备通常选择 arm64,不确定架构时查看设备信息或选择通用版。
首次启动连接需要确认系统 VPN 授权。系统通常只允许一个应用占用该 VPN 接口,测试前停止其他同类连接。若切到后台后中断,再检查电池优化与后台运行限制,不要只反复导入同一份订阅。
v2rayN 提供 deb 与 rpm 包,并区分 x64、arm64 架构。安装包格式取决于发行版的软件包体系;处理器架构则取决于设备,两项都要匹配,不能仅凭文件后缀判断是否适用。
桌面环境、浏览器与应用对系统代理的读取方式可能不同。先用图形客户端完成订阅和本地监听设置,再检查目标应用的代理入口。TUN 需要额外权限与网络环境配合,已有虚拟网络接口时应逐项验证。
流量入口 ≠ 路由规则
应用先通过系统代理或虚拟接口把请求交给客户端,内核再按照路由规则决定出站。开启 TUN 不代表所有请求必然走远端代理,启用分流也不意味着所有应用都会自动进入客户端。
验证时选择一个明确目标,观察日志里是否出现对应请求。完全没有请求记录时,优先检查流量入口;有记录但连接失败时,再检查服务器参数、解析结果和出站规则。日志是否记录请求也取决于当前日志级别。
快速上手
把首次配置压缩成三个阶段。先建立可用基线,再增加规则、自动更新或 TUN 等选项。详细菜单与平台差异见完整教程。
确认系统与架构后安装对应客户端,准备来自可信来源的订阅链接或单条配置。订阅地址不是普通介绍页地址,复制时不要混入空格、换行或说明文字。已有旧配置时先导出备份,并确认备份是否包含订阅分组、路由与应用设置,避免把只含节点的文件误当作完整迁移文件。
客户端可以管理配置,但不能代替配置提供方生成有效的服务器参数。地址、端口、用户标识与传输选项应来自同一份完整配置;不要把不同教程里的字段拼接使用。
在订阅管理中添加分组并保存地址,执行更新后检查是否出现配置条目。单条分享链接则使用客户端的导入入口。选择准备使用的条目,再确认它的协议与当前内核匹配。更新失败时先检查订阅地址是否仍有效,以及当前网络能否取得订阅内容;不要立即删除全部设置。
订阅格式不被识别时,优先向来源确认兼容的输出格式。转换只能处理工具支持的格式,不能补回缺失参数,也不能赋予内核尚未支持的协议功能。包含凭据的地址不宜交给不明在线转换服务。
桌面端先启用系统代理,安卓端确认 VPN 授权,然后访问明确的测试目标。客户端显示运行,只能说明本地服务处于运行状态;还应检查目标访问结果和日志。失败时按“内核启动、本地端口、应用入口、DNS、路由、服务器配置”的顺序缩小范围,不要一次切换多组设置。
结束测试后,用客户端提供的停止与清除系统代理功能退出。若浏览器仍指向已经停止的本地端口,普通网页也可能打不开。需要恢复时先核对系统网络设置,再决定是否重新启动客户端。
Project V · V2Fly · Xray
客户端名称、内核名称与协议名称不在同一层。选型先看平台,再看配置需要的协议与内核能力,不用把所有名称当作不同的连接服务。
Project V 是围绕网络代理工具形成的开源生态背景,V2Ray 是其中的重要项目。V2Fly 延续 V2Ray 相关开发,Xray 则在共同基础上发展出自己的协议扩展与实现方向。两条路线都有各自的演进节奏,不能把名称相近理解成配置字段始终相同,也不宜简单用“新版替代旧版”概括关系。
对使用者而言,差异最终落在具体功能上:某份配置使用哪些协议、传输与安全机制,当前内核是否接受这些参数。以 REALITY 为例,应确认所用 Xray 内核及客户端导入支持情况。若日志提示未知协议或字段,先核对兼容性,而不是把问题归为网络不稳定。更详细的对应关系见选型指南。
v2rayN 面向桌面环境,把配置列表、订阅分组、路由与系统代理入口集中到图形界面。v2rayNG 面向安卓,使用 Xray 内核并通过系统 VPN 接口接入应用流量。v2flyNG 同样面向安卓,提供基于 V2Fly 内核的选择。三者都是开源客户端,但不意味着界面布局、菜单名称与配置备份格式可以直接互换。
桌面首选 v2rayN,是因为本页的桌面教程围绕它组织;安卓优先查看 v2rayNG,再按内核需求考虑 v2flyNG。选择备选客户端应有明确原因,例如已有配置要求对应的内核行为,而不是同时开启多个客户端试图叠加效果。多个入口争用代理设置或 VPN 接口,反而会增加排查变量。
开源意味着项目代码按相应许可证提供查看、使用或再分发的条件,具体权利义务应以各项目随附的许可证为准。客户端界面、内核与附带组件可能采用不同许可;某一个组件的许可不能直接代替整个发行包的许可说明。使用开源客户端也不等于自动获得订阅或服务器服务。
订阅提供方负责配置内容,客户端负责读取和执行,网站文档负责说明操作与概念。三者的职责应分开看。含用户标识的订阅链接、二维码与导出文件都应按敏感配置保存。排查时分享日志只保留必要错误上下文,先移除服务器地址、用户标识与订阅凭据,避免把完整访问资料贴到公开讨论中。
客户端更新可能调整界面、配置生成逻辑或系统集成,内核更新则可能改变协议支持与参数处理。升级之前记录当前可用模式并备份设置,升级之后先用原有配置测试;确认基线正常,再尝试新增功能。若出现异常,比较启动日志与设置变化,比连续重复安装更容易定位原因。
订阅更新、规则数据更新和程序更新是不同操作。订阅更新刷新远端配置,规则数据更新影响匹配范围,程序更新替换客户端或相关运行组件。下载入口集中在下载中心;安装、迁移与平台特有问题集中在全平台安装配置大全。遇到已有明确现象的问题,也可先查FAQ再决定下一步。
配置文章
先完成基础配置,再阅读与当前问题相关的专题。平台教程解决安装与设置顺序,内核对比帮助判断兼容性,原理文章用于理解进阶选项的作用边界。
讲清 v2rayN 桌面版与 WPF 版的区别和选择方法,覆盖解压路径、运行库、导入订阅、系统代理与 TUN 设置,以及 Windows 上的典型报错。
阅读安装流程 →梳理 Project V 生态中 V2Fly 与 Xray 的分叉由来,对比 VLESS、REALITY 等协议支持差异,说明 v2rayNG 与 v2flyNG 各自适合谁。
阅读内核对比 →从 DNS 查询被拦截、返回虚拟 IP 讲起,说明 FakeDNS 如何配合域名分流与 TUN 模式工作,以及哪些场景不适合开启。
阅读 FakeDNS 原理 →