Windows
v2rayN · 桌面首选
希望用中文图形界面管理订阅、切换节点和配置分流,可以先选 v2rayN。下载页提供桌面版与经典 WPF 版:前者采用跨平台界面,后者保留经典桌面交互。选择时看系统要求与使用习惯,不必为了界面不同同时安装两套。
安装后先添加订阅,确认节点列表能正常更新,再启用系统代理。如果目标应用不遵循系统代理设置,再考虑 TUN;不需要一开始就打开所有开关。
前往下载v2rayN / v2rayNG / v2flyNG 白话教程
从订阅导入到系统代理,用真实菜单讲清设置;桌面选 v2rayN,安卓先看 v2rayNG。
上方是设置示意,点击卡片查看操作说明;菜单名称可能随界面调整。第一次使用,先从订阅导入开始。
按系统选择
先确定系统,再看处理器架构。安装包决定程序能否运行,节点参数决定连接是否兼容,这两件事需要分别确认。下面的入口会打开对应平台的下载选项。
v2rayN · 桌面首选
希望用中文图形界面管理订阅、切换节点和配置分流,可以先选 v2rayN。下载页提供桌面版与经典 WPF 版:前者采用跨平台界面,后者保留经典桌面交互。选择时看系统要求与使用习惯,不必为了界面不同同时安装两套。
安装后先添加订阅,确认节点列表能正常更新,再启用系统代理。如果目标应用不遵循系统代理设置,再考虑 TUN;不需要一开始就打开所有开关。
前往下载v2rayN · 按芯片选择
先在系统菜单中打开“关于本机”,确认设备使用 Apple Silicon 还是 Intel 处理器,再选择对应安装包。两种架构的文件面向不同硬件,不能仅凭文件大小决定,也不需要因为教程截图界面不同而更换内核。
首次运行若遇到系统安全提示,先确认下载来源,再到“系统设置 → 隐私与安全性”查看具体原因。系统代理影响遵循系统设置的应用;TUN 另有权限要求,建议基础连接成功后再配置。
前往下载v2rayNG 优先 · v2flyNG 备选
一般先看采用 Xray 内核的 v2rayNG;已有配置明确依赖 V2Fly 时,再看 v2flyNG。主流较新设备通常选择 arm64,无法确认架构时查看设备信息或选择通用包。通用包覆盖更多架构,但不意味着连接能力更强。
从“订阅分组设置”保存订阅地址后,还要执行更新订阅。首次启动连接时,系统会请求建立 VPN 连接的授权;同时运行其他占用这一通道的工具可能发生冲突,需要先停止其中一个。
前往下载v2rayN · 图形桌面环境
按发行版的包管理体系选 deb 或 rpm,再确认设备是 x64 还是 arm64。文件扩展名对应安装方式,处理器架构对应运行环境,两个条件都要匹配。这里介绍的是图形客户端,适合在桌面环境中管理订阅与规则。
安装完成后先检查程序能否启动、内核能否运行,再检查桌面环境的代理设置。不同应用对系统代理的支持并不一致;终端程序未走代理时,应先查看该程序的代理配置,而不是反复导入同一份订阅。
前往下载订阅地址需要自行准备。客户端负责读取配置与转发请求,不会因为完成安装就自动生成可用的服务器。
查看全部客户端 →设置项 → 白话解释
设置名相似,不代表作用相同。系统代理负责告诉应用“入口在哪里”,路由决定“请求往哪里走”,DNS 负责“域名如何找到地址”。先分清这一层关系,排查时才知道该打开哪个菜单。
TUN 可以理解成在系统里增加一个虚拟网络入口,让更多不读取系统代理设置的应用也能交给客户端处理。它解决的是“请求有没有进客户端”,不是“节点能不能连接”。建议先用系统代理确认订阅和节点可用,再启用 TUN,并按提示授予权限。若同时运行其他虚拟网卡或 VPN 工具,路由可能互相影响。不同桌面平台的授权方式有所区别,开启后还要检查 DNS 与分流结果,不能只看开关是否点亮。
v2rayN 主界面 → 启用 Tun
先验证节点可用,再检查权限与路由。
系统代理相当于在系统设置里留下一张地址条,告诉愿意读取它的应用把请求交给客户端。它不等于所有程序都会走代理,也不决定请求最终采用直连还是代理出口。在 v2rayN 中选“自动配置系统代理”后,用浏览器测试;结束使用时选择“清除系统代理”。如果客户端已经退出,但浏览器仍报代理连接失败,先检查是否留下了旧入口。它与 TUN 的区别主要在接管方式,不能把两者当成连接质量的高低档位。
系统代理 → 自动配置系统代理
停止使用 → 清除系统代理
路由就是给请求分类:哪些直连,哪些交给代理,哪些需要拦截。规则通常按顺序匹配,因此前面的宽泛条件可能覆盖后面的精细条件。初次使用可以先选内置预设,确认正常后再添加域名规则。域名策略控制内核在匹配时是否需要解析地址,并不是“全部请求代理”的开关。下面只展示一个路由字段,不是完整配置;不同内核支持的字段可能不同,不应把网上整段配置直接覆盖到现有客户端中。
"routing": {
"domainStrategy": "IPIfNonMatch"
}
订阅地址是一份节点清单的获取入口,订阅分组则用来记录来源和更新设置。保存地址不等于已经取得节点,通常还需要执行一次更新。自动更新只是按间隔重新拉取清单,不会延长订阅有效期,也不能修复服务端失效的链接。建议给分组起容易辨认的名称,先手动更新成功,再设置自动更新。若更新后为空,查看日志中的网络、证书或解析提示;不要把含有访问凭据的订阅地址贴到公开讨论区。
v2rayNG → 订阅分组设置 → 添加并保存
返回主界面 → 更新订阅
Mux 尝试让多个逻辑请求共用较少的底层连接,主要影响连接组织方式,不是通用的提速按钮。效果取决于传输协议、服务端支持和实际网络条件,有些组合不需要额外启用。日常使用先保留客户端默认值;只有明确知道配置要求,或正在做单变量对比时才修改。遇到连接不稳定,先恢复默认并检查日志,而不是持续增加并发数。下面展示关闭状态的字段片段,仅用于认识含义,具体生效位置取决于所用内核。
"mux": {
"enabled": false
}
DNS 负责把网站域名转换成可连接的地址,但查询本身也有出口与路由。节点连接成功而网站打不开,可能是解析失败,并不一定是节点失效。配置时要区分直连请求的解析与代理请求的解析,还要考虑解析服务器本身能否到达。先保留客户端可用的默认配置,再按明确目标调整远程 DNS、查询路由和域名策略。开启 TUN 也不代表所有 DNS 都已按预期转发,仍需结合系统设置、应用行为与实际测试确认。
v2rayN → 设置 → DNS 设置
分别检查解析服务器与查询路由。
第一次配置时,先完成“导入订阅 → 更新节点 → 选择节点 → 启动连接 → 验证访问”这一条最短路径。每次只改变一个设置,记录改动前后的结果。若同时更换节点、开启 TUN、替换 DNS 和修改路由,即使问题消失,也很难知道真正起作用的是哪一项,下一次出错时仍然没有判断依据。
验证连接时既要看客户端,也要看实际应用。启动按钮显示已运行,只能说明程序开始工作;测试结果正常,也不代表每个域名都命中了预期规则。可以先确认普通网站能打开,再测试需要走指定出口的目标,最后查看日志里的路由结果。完整操作见入门指南,各平台的权限与安装问题见安装大全。
下载客户端后还缺什么?还需要有效的节点参数或订阅地址。客户端像一张控制台,负责保存配置、启动内核和展示状态;服务器地址、端口及认证信息来自所使用的服务。只有客户端而没有配置,不能建立对应的代理连接。
全局模式和 TUN 是同一回事吗?不是。全局通常描述请求进入客户端后如何选择出口,TUN 描述请求怎样被接管。即使开启 TUN,路由仍可能让部分请求直连;即使选择全局,未进入客户端的应用请求也不会因此自动被接住。
订阅更新会覆盖手动改动吗?订阅节点可能在更新时重建或替换,不适合把临时修改当作长期保存方式。需要保留的配置先单独备份,并确认它是否属于订阅分组。更多概念可以在术语表逐项对照,不必在第一次使用时记住所有缩写。
客户端 / 内核 / 协议
这些名字处在不同层次。客户端提供可操作的界面,内核执行网络连接,协议规定通信方式;看懂三者的关系,比只记住一个下载名称更有用。
Project V 是理解 V2Ray 背景的一个起点,核心思路是把代理连接、路由与传输能力组织成可以配置的模块。日常讨论中的“V2Ray”有时指具体内核,有时泛指使用相关协议的工具集合,所以搜索到同一个名字,下载对象却可能完全不同。本站把入口明确分成图形客户端,避免把后台执行程序与可点击操作的应用混在一起。
V2Fly 延续了 V2Ray 相关实现与社区维护工作,Xray 则在相关技术基础上发展出自己的实现与功能。它们有共同的技术背景,但并不意味着配置字段、功能进度和协议扩展始终一致。阅读教程时,应同时确认教程针对的客户端和内核;菜单看起来相似,只能说明界面接近,不能证明底层行为完全相同。
v2rayN 是面向桌面的开源图形客户端,承担订阅管理、节点选择、参数生成与内核启动等工作。它可以与不同内核协同使用,具体支持范围取决于客户端集成方式和所选内核。桌面版与经典 WPF 版的差别首先体现在界面技术和平台覆盖,不应简单理解成“新界面就能让同一节点更快”。
v2rayNG 是采用 Xray 内核的开源安卓客户端,v2flyNG 是采用 V2Fly 内核的开源备选。二者在操作习惯上有相近之处,但选择依据应是节点要求与功能兼容性。已有配置包含特定扩展参数时,先核对内核是否支持,再决定客户端。需要横向查看差异,可以阅读客户端对比,不用为了名称相似反复迁移订阅。
开源意味着源代码按相应许可提供,人们可以在许可范围内阅读、使用、修改或分发。不同客户端、内核及其依赖可能采用不同许可,具体条件以各项目随附的许可文本为准。代码可阅读有助于技术审查和社区协作,但使用者仍需关注安装来源、系统权限、配置内容以及服务端如何处理请求。
客户端软件与订阅服务也是两件事。开源客户端可以免费使用,而订阅是否收费、有效期如何计算、节点是否可用,取决于服务提供方。本站提供下载入口与配置解释,不出售节点,也不代替服务方管理账号。遇到订阅失效,应先检查地址与服务状态;反复重装客户端通常不能解决服务端的问题。
“更新”至少可能指三种动作:升级客户端程序、更新用于建立连接的内核、刷新订阅里的节点清单。此外,路由可能依赖 GeoIP、GeoSite 等规则数据,它们也有自己的更新过程。更新订阅不会自动升级应用,升级应用也不会自动修复过期的订阅地址。先说清要更新的对象,操作才不会落错菜单。
准备调整环境前,先备份分组、路由和手动添加的节点,保存仍可工作的配置。更新后逐项确认订阅、默认节点与代理模式;如果出现异常,查看日志中的具体错误,再判断是参数不兼容还是权限变化。不要在排查时连续覆盖所有设置。页面中的菜单路径用于定位功能,实际界面若有调整,以当前客户端内对应功能的名称与说明为准。
订阅链接可能携带访问凭据,日志也可能包含服务器地址。求助时先隐藏这些信息,仅保留错误类型、相关设置与复现步骤;遵守所在地法律及所用网络的管理规定。
继续了解协议与内核术语 →配置专题
基础连接完成后,再按实际问题深入:解析查询走哪条路、桌面界面该选哪一种、订阅为什么拉取失败。每篇围绕一个明确设置展开,便于对照客户端操作。
了解 DNS 查询为什么可能绕过代理,再检查远程 DNS、TUN 接管与域名解析策略。用实际检测结果确认设置,而不是只看开关状态。
阅读设置说明 →从平台覆盖、运行依赖和操作界面理解两套桌面实现。切换前先梳理配置迁移范围,按设备环境与使用习惯决定。
查看界面与选型区别 →区分请求超时、链接失效、证书错误与解析为空,结合日志定位更新失败的环节,再考虑自动刷新与经代理更新。
按错误类型排查 →