Windows
v2rayN 提供 Desktop 桌面版与经典 WPF 版。Desktop 使用跨平台界面,WPF 面向该系统的桌面环境。两种界面的菜单位置可能不同,教程中的设置名称比窗口外观更适合作为定位依据。
首次安装先按下载页要求选择适用安装包;已有配置的设备先备份,再决定是否迁移界面版本。不要把两个实例同时运行造成的本地端口占用误认为订阅失效。
前往下载 Windows 客户端V2Ray 图形客户端 · 桌面与安卓
用 订阅分组整理来源,用 路由分流决定出口;从客户端安装到 TUN 配置,按设置项查阅。
客户端界面结构示意;菜单与字段名称可能随平台和发布版本调整。
先管理配置来源,再区分系统代理、路由与虚拟网卡。三个层次分别决定配置从哪里来、流量如何进入内核,以及最终使用哪个出口。
订阅分组把地址、别名和更新策略放在同一处,适合同时维护多个配置来源。先在订阅分组设置中填写地址,再执行更新,并从对应分组选中服务器。自动更新间隔以分钟计,启用后仍需客户端具备访问订阅地址的网络条件。相比把所有条目混在单个列表里,分组便于定位失效来源,也便于控制更新范围。订阅内容由提供方决定;更新失败时先核对地址和证书错误,不要反复删除现有配置。
订阅分组 → 订阅分组设置订阅分组设置
路由按域名、目标地址或其他匹配条件,把已经进入内核的请求交给指定出站。初次配置可从绕过大陆预设开始,再检查局域网、工作域名等例外。规则通常按顺序匹配,宽泛条件提前可能覆盖后面的精细条件。与只改变系统代理的入口开关不同,路由作用于内核处理阶段,也会影响 TUN 接入的流量。引用 GeoIP 或 GeoSite 分类时,还要确认数据库存在且适配当前内核,避免把数据库缺失误判为服务器故障。
主窗口 → 路由路由预设
自动配置系统代理会把系统的代理入口指向本地客户端;清除系统代理用于撤销系统层的代理设置;不改变系统代理则保留现状。三种模式管理的是系统设置,不代表三套分流规则。浏览器通常会读取系统代理,一些命令行工具和独立网络程序则需要单独配置。因此,出现浏览器可用、其他应用不可用时,应先检查应用的代理入口,而不是直接更换服务器。与 TUN 相比,系统代理更适合先验证基本连接,排查范围也更容易控制。
主窗口 → 系统代理系统代理
TUN 通过虚拟网卡与路由接入流量,适用于不读取系统代理的应用。开启前,先在普通代理模式下确认服务器配置有效,再根据系统要求授予管理权限。启用后重点检查 DNS、局域网访问以及与其他虚拟网卡的路由冲突。TUN 接入范围更广,但不等于所有请求都走代理,最终仍由内核路由决定出口。与逐个应用填写代理相比,它能减少入口配置;同时也扩大了排障范围,出现异常时应先关闭 TUN,对照普通模式定位问题。
主窗口 → 启用 TunTUN 接入
示意开关,实际操作在客户端内完成。
v2rayN 提供图形管理界面,实际连接由所选内核执行。选择 Xray-core 或 sing-box 时,应结合协议、传输方式和所需功能,而不是只比较名称。不同内核的 DNS 与路由字段并不完全相同,自定义配置尤其不能直接混用。相比固定单一内核的客户端,多内核管理便于适配不同配置,但切换之后需要重新检查日志和出口行为。排查时记录当前内核、入口模式及路由预设,一次只调整一个变量,才能判断问题究竟来自哪里。
设置 → 参数设置 → Core:基础设置Core:基础设置
Xray-core / sing-box
具体可选项以客户端设置与安装内容为准。
一条请求的处理顺序可以概括为:应用发起连接,系统代理或虚拟网卡把流量交给本地入口,内核读取规则,再选择直连或代理出站。订阅分组并不参与这条实时链路,它负责提供服务器配置。把这些职责拆开后,更新订阅、修改系统代理和调整路由就不再是可以互相替代的操作。
首次使用建议保持默认参数,先完成一次可复现的连接,再逐项增加自动更新、分流例外和 TUN。需要修改 JSON 时,先阅读配置大全中的入站、出站与路由说明;只需完成图形界面设置时,直接按使用指南操作即可。
桌面设备选 v2rayN,安卓设备在 v2rayNG 与 v2flyNG 之间按内核需求选择。先确认系统与处理器架构,再进入对应平台下载。
v2rayN 提供 Desktop 桌面版与经典 WPF 版。Desktop 使用跨平台界面,WPF 面向该系统的桌面环境。两种界面的菜单位置可能不同,教程中的设置名称比窗口外观更适合作为定位依据。
首次安装先按下载页要求选择适用安装包;已有配置的设备先备份,再决定是否迁移界面版本。不要把两个实例同时运行造成的本地端口占用误认为订阅失效。
前往下载 Windows 客户端选择 v2rayN 跨平台桌面版。Apple Silicon 与 Intel 处理器对应不同安装包,可在系统的“关于本机”中确认芯片信息。架构选对之后,再按下载页说明完成安装与首次启动。
系统代理与 TUN 的权限路径并不相同。建议先用系统代理完成连接验证,再处理虚拟网卡相关授权;迁移桌面配置时,也要复查文件路径和本地监听端口。
前往下载 macOS 客户端优先查看使用 Xray 内核的 v2rayNG;需要 V2Fly 内核时再考虑 v2flyNG。多数较新的手机适用 arm64 包,不确定设备架构时可查看通用包及下载页的选择说明。
移动端通常通过系统 VPN 接口接入流量,首次连接需确认系统授权。桌面的系统代理模式不能直接等同于手机端开关;分应用设置和后台运行限制也会影响实际连接范围。
前往下载 Android 客户端v2rayN 桌面版提供 deb 与 rpm 安装入口,并区分处理器架构。根据发行版的软件包体系选择格式,再确认设备使用 x64 还是 arm64,避免只看文件后缀就直接安装。
桌面环境对系统代理与托盘的支持存在差异,部分应用需要自行指定代理入口。使用 TUN 前应确认权限和路由环境,尤其留意已运行的虚拟网卡与容器网络。
前往下载 Linux 客户端客户端负责配置与操作界面,内核负责连接、传输和路由。理解两者分工,比仅凭软件名称判断功能更准确。
Project V 是理解 V2Ray 生态的起点,其核心思路是把入站、出站、传输与路由组合成可配置的网络工具。后来围绕 V2Ray 形成了不同的社区项目。V2Fly 延续了 V2Ray 的社区维护路线,Xray 则从相关代码基础发展为独立演进的内核项目。两者有历史联系,但不能据此认为所有字段、协议特性与默认行为始终一致。
这里的“内核”不是操作系统内核,而是执行代理连接的核心程序。图形客户端把服务器信息与用户选项转换成内核可读的配置,再启动并管理相应进程。因此,界面能保存一个选项,并不必然代表当前选择的内核可以执行它;判断功能是否可用,需要同时看客户端支持和内核能力。
VMess、VLESS 等名称通常对应协议,TLS、REALITY 等涉及连接安全与握手机制,路由规则则决定请求交给哪个出站。这些概念位于不同层次。选择客户端时先确认平台,配置连接时再核对协议与内核,最后处理入口和分流,能减少在多个设置页面之间反复试错。
v2rayN 以桌面图形管理为主,整合订阅、服务器列表、系统代理和路由操作。跨平台桌面界面与经典 WPF 界面属于界面实现的差别,不应与协议名称混为一谈。可选内核中还包括 sing-box,它是另一个独立项目;它的配置格式不能被当作 Xray 配置直接套用。
v2rayNG 面向安卓设备,使用 Xray 内核;v2flyNG 同样面向安卓,但采用 V2Fly 内核。两者名称接近,选型依据仍应是现有配置的兼容性与所需功能,而不是把其中一个简单视为另一个的替代安装包。首次使用可以先按下载页推荐顺序选择,有明确内核需求时再调整。
v2rayN、v2rayNG 与 v2flyNG 均为开源客户端,客户端项目采用 GPL-3.0 协议;Xray-core 与 V2Fly 核心采用 MPL-2.0 协议。图形界面和内核是不同项目,授权范围也应分别理解。开源意味着代码可以依协议被查看、使用和修改,并不等于所有网络配置都天然适合当前设备。
客户端、内核以及附带组件可能分别提供许可证说明。个人使用时可以从项目的开源属性了解其技术来源;需要修改或再分发时,则应阅读对应许可证正文,并按实际涉及的代码与组件履行义务。本站提供下载入口与配置文档,不把客户端项目的维护工作归属于本站。
客户端更新主要改变界面、配置管理与集成方式;内核更新可能改变协议处理、配置解析和连接行为;GeoIP、GeoSite 等规则数据库更新则改变分类数据。三者更新目的不同,不能用更新订阅代替内核更新,也不能指望升级界面自动修正所有路由匹配问题。
订阅更新只是在重新获取配置来源中的内容。更新后服务器条目可能增加、删除或修改,原先手动编辑的条目也可能受到订阅管理方式影响。执行更新前先确认分组,再检查更新结果。遇到证书错误或无法访问地址时,应沿着系统时间、网络连通性、订阅有效性依次排查,而不是一次性改动所有代理参数。
有自定义配置的设备,升级前应保留设置备份,并记录使用的内核与路由预设。升级后先验证基本连接,再检查 DNS、局域网与业务应用。日志适合帮助判断失败阶段,但分享日志前要移除订阅地址、认证信息与可识别的服务器资料。更详细的字段关系见V2Ray 配置文件参考。
从具体设置进入:规则数据库、桌面界面选择,以及 TUN 接入方式。每篇围绕一个问题展开,适合在基本连接完成后继续阅读。
介绍 GeoIP 与 GeoSite 两个规则数据库的作用、在 v2rayN 中的更新入口和存放位置,并用路由规则示例演示国家与域名类别的引用写法。
对比 Avalonia 跨平台桌面版与 Windows 专用 WPF 版在界面、系统托盘、平台覆盖上的差异,按操作系统给出安装包的选择建议。
解释系统代理与 TUN 虚拟网卡的区别,讲清哪些程序需要 TUN 接入。分步说明启用 Tun 开关、管理员权限要求与 DNS 劫持相关设置。