Windows
v2rayN 首推v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留熟悉的窗口布局;两者都围绕服务器管理、订阅分组和路由设置展开,不必仅凭界面新旧判断哪一版更适合。
首次安装先看系统要求与运行依赖。迁移已有配置时,先退出旧客户端并备份配置目录,避免两个实例同时修改系统代理。浏览器能使用系统代理,而其他程序仍直连时,再判断是否需要 TUN,不要先把所有开关一起打开。
前往下载桌面平台选 v2rayN,安卓优先了解 v2rayNG。先确认系统和处理器架构,再进入对应安装入口。
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留熟悉的窗口布局;两者都围绕服务器管理、订阅分组和路由设置展开,不必仅凭界面新旧判断哪一版更适合。
首次安装先看系统要求与运行依赖。迁移已有配置时,先退出旧客户端并备份配置目录,避免两个实例同时修改系统代理。浏览器能使用系统代理,而其他程序仍直连时,再判断是否需要 TUN,不要先把所有开关一起打开。
前往下载选择 v2rayN 前,打开系统的“关于本机”,查看显示的是芯片还是处理器。Apple Silicon 与 Intel 对应不同安装入口;优先使用匹配硬件架构的安装包,不要只看文件扩展名。
安装后先导入配置,再测试系统代理。系统代理只影响遵循系统代理设置的应用,并不等于接管所有网络流量。需要启用 TUN 时,还要按客户端提示处理权限和相关组件;若提示权限不足,先解决授权问题,不必反复更换订阅地址。
前往下载v2rayNG 使用 Xray 内核,v2flyNG 是采用 V2Fly 内核的备选。主流较新的设备通常选择 arm64;不确定设备架构时,可结合系统信息和下载页说明选择通用版。内核不同,支持的配置字段也可能不同,导入成功并不代表所有参数都能运行。
首次连接需要确认系统 VPN 授权。若锁屏后容易断开,再检查系统的电池优化、后台运行和自启动设置。“分应用代理”决定哪些应用进入代理范围,启用后要核对代理与绕行的选择方向,同时留意其他 VPN 应用是否正在占用连接。
前往下载v2rayN Linux 下载入口按 deb、rpm 和处理器架构区分。Debian、Ubuntu 等发行版通常使用 deb,Fedora 等发行版通常使用 rpm;还需区分 x64 与 arm64,不能把包格式与处理器架构当成同一个条件。
桌面环境中的代理设置与终端程序的代理环境变量是两条路径。图形客户端显示系统代理已开启,不代表每个命令行工具都已接入。先用明确支持代理的应用验证连接,再配置其他程序;使用 TUN 时,另外检查权限、路由以及现有网络管理工具的影响。
前往下载从接管流量到决定出口,按依赖顺序理解五组设置。下方是静态界面示意,菜单名称可能随客户端界面调整。
v2rayN → 主窗口底栏 → 系统代理
系统代理把遵循系统设置的应用交给客户端本地入口。在 v2rayN 主窗口底栏选择“自动配置系统代理”,再用浏览器验证。它不负责判断每个域名是否直连,具体出口仍由路由规则决定。与 TUN 相比,这种接管方式涉及的系统网络设置较少,适合先完成基本连接测试。退出前可选择“清除系统代理”;若其他代理工具也在运行,应先关闭其中一个,避免系统设置被反复覆盖。
v2rayN → 设置 → 路由设置
路由决定进入客户端的请求从哪个出口发出。在“设置 → 路由设置”中先查看现有规则,再添加明确的域名或 IP 条件。规则通常按顺序匹配,较宽的条件放在前面,可能遮住后面更具体的例外。与安卓分应用代理相比,域名路由侧重目标地址,而不是应用身份。排查时先确认流量已进入客户端,再核对匹配条件、规则顺序和出站标签;只切换系统代理,不能修复路由本身的逻辑错误。
v2rayN → 订阅分组 → 订阅分组设置
订阅分组用于分别保存来源地址和更新选项。在“订阅分组 → 订阅分组设置”中填写别名与地址,保存后再执行更新。与从剪贴板导入单条分享链接不同,订阅可以再次拉取来源列表,来源变更也会影响本地条目。建议不同来源单独分组,先保留默认过滤条件。更新失败时核对地址是否完整、是否过期,以及当前更新是否通过代理;不要把含有访问凭据的订阅地址放进公开截图或日志。
v2rayN → 主窗口底栏 → 启用 Tun
TUN 通过虚拟网络接口接管流量,适合不遵循系统代理的应用。先确认普通代理连接可用,再按客户端提示取得权限并开启“启用 Tun”。它与系统代理解决的是接管范围问题,不是让失效服务器恢复连接。启用后还需检查 DNS 与局域网访问,避免同其他 VPN 或虚拟网络工具争用路由。相比只改系统代理,TUN 的排查范围更大;遇到断网时先关闭 TUN 恢复基线,再逐项核对配置。
v2rayN → 设置 → DNS 设置
DNS 把域名解析为地址,但系统、应用和代理内核可能各自参与解析。在“设置 → DNS 设置”中调整前,先分清出问题的是解析还是连接。路由中的 domainStrategy 控制路由匹配是否需要解析域名,不等于替换整个系统的 DNS。与单纯更换上游服务器相比,让解析路径和路由出口配合更重要。开启 TUN 或使用 FakeDNS 时,应同时检查流量接管与域名映射;不要把多个不明用途的配置片段直接拼接。
先建立一条可重复的测试路径,再增加分流规则。桌面端以 v2rayN 为例,安卓端以 v2rayNG 为例。
准备好有权使用的订阅地址或单节点分享链接。v2rayN 中打开“订阅分组 → 订阅分组设置”,添加分组、填写别名与地址,保存后执行订阅更新。若拿到的是单条分享链接,复制完整内容,再使用“服务器”菜单中的剪贴板导入入口,不要把它填进订阅地址栏。
v2rayNG 可从主界面的添加入口导入剪贴板内容,订阅则在订阅分组中维护。完成后检查条目是否出现在预期分组;空列表先排查地址和过滤条件,不要急着修改 DNS。客户端本身不附带可用服务器,安装完成与连接配置完成是两件事。
在 v2rayN 的服务器列表中选定要使用的配置,确认已设为活动服务器,再选择“自动配置系统代理”。初次测试可先采用“绕过局域网”一类现成路由方案,保留其他选项默认值,避免同时引入多个变量。
v2rayNG 中选择配置后点击连接,并确认系统 VPN 授权。若启用了分应用代理,测试应用必须包含在预期接管范围内。桌面端暂时不必同时启用 TUN;需要覆盖不读取系统代理的程序时,再单独测试 TUN。每次只改一项,失败后才能准确回到上一种可用状态。
使用明确受代理设置影响的浏览器访问目标站点,再查看客户端日志是否出现对应连接。Tcping 只反映 TCP 握手情况,真连接延迟会经过代理链路,下载测速观察吞吐;三者回答的问题不同,不能只凭一个测试结果判断所有应用都能使用。
如果测试失败,按“活动配置 → 接管方式 → 路由 → DNS”的顺序检查。浏览器正常而某个程序失败时,先看该程序是否读取系统代理;锁屏后中断时,先看后台限制。确认连接稳定后,再备份配置并记录必要设置,后续调整就有可比较的基线。
客户端负责操作界面,内核处理连接和路由。理解两者的分工,比记住一组开关位置更有用。
Project V 是围绕网络代理工具展开的项目生态,V2Ray 是其中广为使用的核心软件。V2Fly 社区延续相关开发,Xray 则在共同技术基础上发展出自己的实现与功能。两者存在相近的配置概念,但不能据此认定所有字段、协议能力和默认行为完全一致。阅读教程时应先确认当前客户端实际调用的内核,而不是只根据应用名称作判断。
“协议”“传输”“安全设置”也不是同一个层级。协议描述连接双方如何交换代理请求,传输决定数据通过怎样的通道承载,TLS 等设置则涉及连接安全。排查导入后的连接问题时,要逐项核对服务端要求。只把协议名称改成另一个名称,或额外打开一个功能开关,通常不能补齐缺失的服务端参数。
v2rayN 面向桌面平台,提供服务器列表、订阅分组、路由管理和系统代理等图形入口。界面把许多底层字段整理为可操作的菜单,但实际功能仍取决于所选内核、运行平台以及配套组件。跨平台桌面版与经典 WPF 版的主要区别首先是界面技术与适用平台,不应把界面名称直接当成协议兼容性的结论。
v2rayNG 是采用 Xray 内核的安卓客户端,v2flyNG 提供 V2Fly 内核方向的备选。安卓系统通过 VpnService 授权实现流量接管,桌面端则涉及系统代理、虚拟接口等不同机制。因此,同一份分享链接可以在不同设备上导入,并不意味着权限、后台保活和应用接管设置也能照搬。换平台后应重新走一次验证流程。
v2rayN、v2rayNG 与 v2flyNG 的客户端项目采用 GPL-3.0 开源协议。开源意味着可以按照许可条件阅读、使用、修改和分发代码;涉及分发修改版本时,还应遵守相应的源码和许可义务。客户端调用的内核与其他组件可能采用各自的许可,不能把客户端的协议名称直接套用到整个依赖集合。
开源属性与远端服务质量也应分开看。客户端提供配置和连接能力,订阅内容由相应来源维护,服务器是否可用取决于远端配置、账号状态与网络条件。本页面整理的是客户端选择与操作说明,不提供订阅账号。评估连接问题时,把软件、配置来源和远端服务拆开检查,结论才更明确。
客户端、内核和规则数据的更新节奏可能不同。界面升级可能改变菜单位置,内核升级可能调整字段支持,规则数据变化则可能影响域名分类与路由结果。更新前记录当前接管方式、路由选择和自定义 DNS,并备份客户端配置;订阅地址仍应妥善保管,不要把备份文件公开分享。
更新后先验证原有基础连接,再检查订阅分组和自定义规则是否保留。若出现新问题,记录具体错误与触发步骤,不要连续修改内核、路由和 DNS。下载入口集中在客户端页面,那里按平台与架构区分安装方式;进阶手册负责解释各设置之间的关系,便于在界面变化后仍能找到对应概念。
遇到术语不熟悉时,可以先从术语表区分系统代理、TUN、DNS 与路由,再到常见问题按现象查找处理方向。需要维护多个订阅或添加自定义出站时,再阅读进阶手册,不要在首次连接阶段一次性套用复杂配置。
围绕订阅更新、分享链接和安卓设置,补充设置面板之外的判断方法。
按顺序排查订阅失效:地址过期、编码格式不识别、更新走代理的设置、系统时间偏差与过滤规则误删,每步给出对应的设置位置。
阅读订阅排查笔记 →解释单节点分享链接与订阅地址的结构差异,演示在 v2rayN 和 v2rayNG 中从剪贴板导入链接、添加订阅分组的步骤与注意点。
阅读链接导入说明 →讲清 v2rayNG 首次连接的 VpnService 授权弹窗、各品牌系统的后台省电限制如何加入白名单,以及分应用代理的绕行与代理模式。
阅读安卓设置笔记 →