Windows
v2rayN 提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版保留经典的窗口布局;二者都需要正确的订阅与运行环境,不应仅凭界面新旧判断连接效果。
首次安装建议先完成基础导入,选择一个配置并设置系统代理。若使用过其他代理程序,先退出其代理接管功能,确认本地监听端口没有冲突,再考虑开启 TUN 模式。切换客户端前记录订阅分组、路由与本地端口,避免把旧设置问题带入新安装。
前往下载 →从订阅分组开始,按顺序配置路由分流与系统代理。
CLIENT / 客户端入口
桌面使用 v2rayN,安卓优先查看 v2rayNG。先确定系统与处理器架构,再导入已有订阅;安装客户端本身不会生成可用的服务器配置。
v2rayN 提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版保留经典的窗口布局;二者都需要正确的订阅与运行环境,不应仅凭界面新旧判断连接效果。
首次安装建议先完成基础导入,选择一个配置并设置系统代理。若使用过其他代理程序,先退出其代理接管功能,确认本地监听端口没有冲突,再考虑开启 TUN 模式。切换客户端前记录订阅分组、路由与本地端口,避免把旧设置问题带入新安装。
前往下载 →v2rayN 的安装包按 Apple Silicon 与 Intel 芯片区分。在系统的“关于本机”中查看芯片或处理器信息,选择对应架构;不要根据电脑外观或购买时间推断。
完成安装后,先按系统提示处理应用启动权限,再导入订阅。系统代理只影响遵循该设置的应用,终端工具可能仍需单独指定代理地址。排查时应先确认客户端已经监听本地端口,再区分浏览器配置与终端环境变量,不必一开始就调整全部网络选项。
前往下载 →v2rayNG 以 Xray 内核为主要技术基础,适合作为安卓端的优先选择;v2flyNG 是基于 V2Fly 内核的备选。需要比较的是订阅协议与内核能力,而不是名称是否接近。
主流较新设备通常选择 arm64,架构不明确时再查看通用版。首次连接需确认系统的 VPN 授权,同一时间通常只能由一个应用占用该连接位置。后台连接中断时,结合系统省电策略、应用后台权限及日志排查,避免把系统停止后台进程误认为订阅失效。
前往下载 →v2rayN 提供 deb 与 rpm 安装入口,并区分 x64、arm64 架构。按发行版的软件包体系和设备架构选择,图形界面客户端还需要可用的桌面会话与相应运行依赖。
桌面环境的系统代理不等于所有进程都自动使用代理,命令行程序、容器与后台服务应分别检查。启用 TUN 前先了解当前网络管理方式与已有虚拟网卡,保留原始配置;遇到路由异常,先恢复基础代理方式,再逐项核对权限、DNS 与路由接管范围。
前往下载 →同一份订阅未必在不同内核中完整等价。导入前确认协议、传输与安全选项均被目标客户端支持;可见的节点名称并不能代替兼容性检查。
查看全部客户端 →SETTINGS / 设置画廊
按“配置来源 → 流量去向 → 接管范围”的顺序理解设置。下列界面是静态示意,选项名称与位置可能随客户端界面调整;示意开关不改变当前设备的网络。
订阅分组用于保存配置来源与更新选项,不是连接模式。添加分组时先填写便于识别的别名,再粘贴完整订阅地址,保存后执行更新订阅。第一次更新建议保持过滤项为空,确认配置确实返回后再按名称筛选。是否通过代理更新取决于订阅地址的访问条件,应使用已经可用的代理,避免形成依赖尚未导入配置的循环。与逐条导入分享链接相比,分组更适合持续接收来源端的配置变更。
路由规则决定已经进入内核的流量走代理、直连还是被阻止,不负责让应用自动进入代理。规则通常按顺序匹配,较具体的域名或地址条件应放在较宽泛条件之前。先使用能够理解的基础规则,再逐条添加例外,避免同时更换规则集与 DNS 设置。与系统代理的区别在于,系统代理负责入口,路由负责出口;浏览器未使用本地代理时,修改内核规则并不能改变它的连接路径。
TUN 通过虚拟网卡接收符合接管条件的流量,适用于不读取系统代理的应用。它扩大的是流量入口范围,并不自动把所有连接都改成代理出口;最终去向仍受路由规则影响。开启前先确认基础连接可用、运行权限满足要求,并检查其他 VPN 或虚拟网卡是否冲突。与单纯开启系统代理相比,TUN 对路由和 DNS 的影响更广,遇到异常应先关闭并恢复原网络,再根据日志定位。
局域网共享允许同一可信网络里的其他设备访问电脑的代理监听端口。开启后,还需在目标设备填写电脑的局域网地址与实际端口,并检查主机防火墙;不能把回环地址填到另一台设备上。与本机系统代理相比,共享增加了可连接的来源范围,必须限制入站访问,避免在公共网络长期开放。电脑休眠、地址变更或客户端退出都会中断共享,因此应先确认主机保持运行再排查目标设备。
系统代理把本地代理地址写入操作系统提供的代理设置,主要影响愿意读取该设置的应用。选择服务器配置后,可先使用自动配置系统代理测试浏览器,再确认浏览器扩展没有覆盖设置。终端与部分应用可能需要独立配置,这不一定意味着客户端连接失败。与 TUN 相比,系统代理的影响范围更容易核对;退出客户端前应清除不再使用的代理设置,避免应用继续访问已经停止监听的端口。
内核负责执行连接、传输与路由,图形客户端负责组织配置。可选内核及设置位置取决于安装包与客户端实现,不能仅根据协议名称推断全部功能都可用。切换前先确认服务器要求的传输与安全参数,保留原配置,再用同一目标进行验证。与修改界面主题不同,内核切换可能改变参数支持和日志输出;出现不支持的字段时应检查兼容性,而不是反复更换订阅地址或随意删除安全选项。
导入成功只表示客户端读到了配置,不表示目标服务器一定可达;开启系统代理也不表示所有程序都已被接管。建议每次只改变一类设置:先更新订阅并选中配置,再让浏览器使用本地代理,最后确认路由与 DNS。基础链路可用后,再逐步加入 TUN、局域网共享或应用级例外。
测试时区分连接建立、域名解析和目标服务响应。某个网站无法打开,可能与解析结果、规则命中或目标服务本身有关;单次节点测速也不能覆盖全部使用场景。记录报错时间与客户端日志,比连续切换多个开关更容易找到原因。
ECOSYSTEM / 项目与内核
客户端、内核、协议和订阅是四个不同层次。先明确各层负责的事情,再判断某个设置是否适用于当前设备与配置。
订阅 / 分享链接
v2rayN · v2rayNG · v2flyNG
Xray / V2Fly
具体组合以客户端实现和所含内核为准。图中的层级表示职责,不代表所有客户端可任意切换内核。
Project V 是理解 V2Ray 技术生态的背景,其中的模块化思路将入站、出站、路由和传输拆开处理。日常所说的“V2Ray 客户端”通常指图形管理程序,而不是单一协议。一个客户端可以展示多种协议配置,也可以调用不同的连接内核,因此产品名称相似并不意味着内部能力完全相同。
V2Fly 延续 V2Ray 核心项目的社区维护,Xray 则由相关代码基础发展为独立的技术分支。二者共享一部分历史与配置概念,但功能演进不再完全一致。阅读教程时,需要同时核对客户端与内核,不能把某个分支的参数原样套到另一个分支,也不能把“能识别配置”当成“全部字段都已生效”。
v2rayN 面向桌面环境,集中管理订阅分组、服务器配置、路由与本地监听;v2rayNG 面向安卓环境,主要基于 Xray 内核组织连接;v2flyNG 则为偏向 V2Fly 内核的安卓使用场景提供备选。三者都是开源图形客户端,界面操作最终需要转换成内核可以执行的配置。
对用户而言,选择依据应依次是操作系统、订阅所需的协议能力、常用的接管方式以及维护状态。没有必要为了名称统一而在不同设备上强求同一种内核。相反,保留清晰的订阅来源与可回退的设置,更有利于跨设备排查;同一分组在电脑可用、手机不可用时,应先比较协议参数与权限,而不是立即判断服务器故障。
v2rayN 采用 GPL-3.0 开源协议。开源协议规定软件使用、修改与再分发的条件,不等同于对网络服务质量的保证;客户端免费使用,也不意味着远程服务器、订阅或带宽免费提供。软件项目、配置来源与本站文档分别承担不同角色,遇到账号状态或订阅配额问题,应从配置提供方的信息中核对。
开源代码可以被审阅,但实际运行结果仍取决于安装来源、运行权限、内核配置与远端服务。本站围绕图形界面操作和技术概念整理说明,不提供可用订阅或服务器账号。示意窗口中的地址仅用于解释字段格式,不应当作真实连接信息。
客户端更新、内核更新与订阅更新是三件事:前者改变界面和配置生成逻辑,内核更新改变协议执行能力,订阅更新则重新取得来源端配置。遇到导入失败,先检查格式与地址;遇到连接参数不支持,再核对内核能力。把三种更新混为一谈,往往会掩盖真正的问题。
升级前记录当前能够工作的接管方式、本地端口和自定义路由,按客户端功能备份配置,并妥善保管其中的敏感字段。升级后先验证单个配置,再测试订阅更新与日常应用。若协议组合包含 VLESS、TLS 或 REALITY,还应分别理解身份验证、传输与安全层的职责,避免只更换协议标签而遗漏对应参数。
NOTES / 设置与排错
基础连接之后,按现象查找对应设置。文章分别讨论应用入口、端口监听与虚拟网卡接管,避免用同一套操作处理不同层次的问题。
浏览器方向排查扩展接管、PAC 与例外列表;终端方向说明它为什么默认不读系统代理,以及如何用环境变量指定本地 HTTP 端口。
先判断应用是否使用本地代理,再检查代理后端是否连通。把“应用绕过代理”和“代理连接失败”分开,能够减少不必要的路由修改。
阅读说明 →客户端启动失败或提示端口占用时,先用系统命令找出占用端口的进程,再在参数设置里改用空闲端口,并同步更新依赖该端口的软件。
不同客户端的监听方式可能不同,先确认当前使用的是混合端口还是独立端口。仅修改客户端,而不修改应用中的代理地址,连接仍会失败。
阅读说明 →讲清 TUN 虚拟网卡与系统代理的区别,以及哪些程序需要借助虚拟网卡接管,同时给出开启前的权限要求、操作顺序和常见冲突。
重点区分流量进入内核的方式与最终出口。开启 TUN 后仍然需要合适的路由与 DNS 配置,不能把接管范围扩大等同于所有流量使用同一出口。
阅读说明 →若还不能确定问题属于哪一层,可先在 FAQ 中核对订阅有效性、运行权限与代理模式,再进入对应专题,保留每次调整前后的现象记录。