桌面客户端 · 订阅与路由

V2Ray Windows客户端 v2rayN 下载与配置

下载v2rayN 查看教程

按菜单完成订阅导入、路由分流与 TUN 设置，从选择客户端开始。

  • VLESS
  • VMess
  • Trojan
  • Shadowsocks
  • REALITY

客户端选择

按系统选择下载入口

先确认操作系统与处理器架构，再选择客户端。桌面使用 v2rayN；安卓优先查看 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。

Windows

桌面首推

选择 v2rayN。桌面版使用跨平台界面，经典 WPF 版面向 Windows。先阅读下载页的系统要求与两版说明，再决定安装入口；不要把界面框架与代理内核混为一谈，它们负责的工作不同。

首次运行后，先完成订阅导入和服务器选择，再设置“自动配置系统代理”。普通浏览器访问可从这一步开始，只有目标应用不读取系统代理时，再评估是否启用 Tun 模式。

前往下载 Windows 客户端

macOS

选择 v2rayN 桌面版。打开系统的“关于本机”，确认设备显示 Apple 芯片还是 Intel 处理器，分别选择 Apple Silicon 或 Intel 入口。安装包架构应与设备匹配，不能仅凭外观或购买年份判断。

沿用订阅、服务器与路由的基本操作思路，但按当前系统显示的网络权限提示完成设置。桌面界面与 Windows 可能略有差异，遇到菜单位置变化时，优先寻找同名设置项。

前往下载 macOS 客户端

Android

Xray 内核

优先选择 v2rayNG，使用 Xray 内核；v2flyNG 使用 V2Fly 内核，作为对应配置的备选。较新的主流手机通常选择 arm64，无法确定设备架构时，先查看系统信息与下载页的通用版说明。

导入订阅后选择服务器，启动连接并确认系统 VPN 授权。安卓的流量接管方式与桌面系统代理不同。若锁屏后连接中断，检查电池优化和后台运行权限，再判断是否需要调整客户端配置。

前往下载 Android 客户端

Linux

选择 v2rayN 桌面版，按发行版的软件包体系查看 deb 或 rpm 入口，再核对 x64 与 arm64 架构。安装时使用系统的软件包管理方式处理依赖，避免混装不适合当前发行版的软件包。

运行后先验证客户端本地监听，再设置桌面环境或应用自身的代理。不同桌面环境读取代理设置的方式可能不同；需要虚拟网卡接管时，另行检查权限、路由与 DNS，不要直接套用其他系统的操作路径。

前往下载 Linux 客户端
查看全部客户端 →

设置项与能力

v2rayN 功能图谱

把协议、内核、订阅与流量入口分开理解。选中右侧主题，查看对应设置与使用边界。

配置输入 → 内核处理 → 流量路径

VLESS / VMess / Trojan协议 Xray / sing-box内核 订阅分组 geosite:cn → direct 系统代理 TUN 模式接管

按服务器提供的配置选择 VLESS、VMess、Trojan 或 Shadowsocks，不要仅凭协议名称判断连接效果。导入链接后，核对地址、端口、认证信息与传输设置；使用 REALITY 时，还要核对服务器名称、公钥等对应字段。REALITY 属于安全层相关技术，不等同于独立的代理协议。v2rayN 将这些字段集中到图形界面，但可用组合仍取决于内核支持和服务端设置。修改前保留原配置，验证成功后再替换日常使用项。

继续阅读：路由分流手册 · TUN 权限与排错。图谱表示功能关系，不代表固定执行顺序。

首次连接清单

从订阅导入到连接验证

首次设置只调整必要项目。先让一条配置在基础代理模式下正常工作，再增加分流例外或虚拟网卡接管。这样出现问题时，可以判断变化来自订阅、服务器、应用设置还是路由。

  1. 导入订阅并选定服务器

    启动 v2rayN，打开“订阅分组设置”，新增分组并填写来源提供的订阅地址。保存后执行“更新当前订阅(不通过代理)”，等待列表更新，再选中需要使用的服务器并设为活动服务器。已有单条分享链接时，也可使用“从剪贴板导入批量 URL”等导入入口，菜单名称以当前界面为准。

    区分订阅地址与服务器分享链接：前者用于获取一组配置并持续更新，后者通常描述具体连接参数。列表为空时，先检查分组筛选、地址是否完整以及更新错误。列表有内容但无法连接时，再检查活动服务器与日志，避免反复导入造成重复配置。

  2. 设置系统代理与基础路由

    在“系统代理”中选择“自动配置系统代理”，再到“路由”选择需要的预设。系统代理决定支持该设置的应用把请求交给哪个本地入口；路由决定进入内核后的请求走哪个出口。这是两个不同层面的设置，“全局”路由也不等于所有程序都会自动使用代理。

    先用浏览器验证基础链路。命令行工具、游戏或独立网络组件可能使用自己的代理选项，需要单独设置或评估 TUN。不要同时启动多个会改写系统代理的客户端。结束使用时，可选择“清除系统代理”，避免应用继续访问已经停止监听的本地端口。

  3. 核对访问结果与错误日志

    分别打开预期直连和预期代理的目标，观察是否符合路由设置，再测试实际需要使用的应用。能打开某个网页只说明这次访问成功，不能据此认定其他应用、DNS 或 UDP 流量都经过相同路径。需要确认出口时，对照目标服务显示的连接信息与客户端日志一起判断。

    出现错误时，按“内核是否启动 → 本地端口是否监听 → 应用是否使用代理 → 服务器是否可达 → DNS 与路由是否匹配”的顺序检查。每次只改一项，记录修改前后的结果。分享排错材料前移除订阅地址、认证信息和个人访问记录，保留必要的错误类型即可。

查看完整教程 →

开源生态与维护

Project V、V2Fly 与 Xray 内核

把项目生态、代理内核与图形客户端分开看。下载客户端只是开始，理解组件关系能减少选型和排错中的误判。

理解内核与界面的分工

Project V 是围绕代理通信工具形成的开源生态，V2Ray 是其中的重要项目。V2Fly 延续了 V2Ray 相关开发；Xray 从相关代码基础发展出独立的内核路线。它们共享部分技术背景，但功能演进、配置字段和兼容范围并非始终一致。选择配置时，应核对实际运行的内核，而不是仅看“V2Ray”这个统称。

内核负责连接、传输、解析和路由等工作，图形客户端负责把服务器管理、订阅更新与系统设置组织成可操作的界面。v2rayN、v2rayNG 与 v2flyNG 都属于图形客户端，并不是同一个软件在不同系统上的简单改名。桌面与安卓的系统能力不同，因此权限提示、流量入口和后台运行方式也会不同。

协议名称同样不能代替完整配置。一个连接还涉及传输方式、安全层、认证参数及服务端约定。看到相同的 VLESS 或 Trojan 名称，不代表任意内核与参数组合都能互换。先保留来源提供的原始设置，按兼容要求选择内核，再对照日志定位具体字段，比按名称反复尝试更容易缩小问题范围。

按客户端定位选择

v2rayN：面向桌面使用场景，集中管理订阅分组、活动服务器、本地监听与路由。Windows 可按界面偏好和系统要求选择桌面版或经典 WPF 版；macOS、Linux 查看相应桌面入口。需要比较界面框架时，阅读Avalonia 与 WPF 版选择说明，不要把界面差异理解为协议能力的直接差异。

v2rayNG：面向安卓，使用 Xray 内核，适合作为安卓配置与使用教程的起点。首次启动连接时需要处理系统 VPN 授权；长期使用还涉及系统的后台限制。若问题仅在锁屏或切换应用后出现，应先检查运行权限与电池策略，再核对网络和配置变化。

v2flyNG：同样面向安卓，使用 V2Fly 内核，可作为需要该内核配置的备选。不要假设它与 v2rayNG 的每个字段、导入结果和协议能力完全一致。切换客户端时，先导入一条明确兼容的配置验证，再迁移常用分组，避免一次迁移过多内容后难以定位差异。

按组件理解开源许可

三款客户端都以开源项目形式维护。客户端、代理内核及依赖组件可能分别采用不同的开源许可；使用、修改或再分发时，应阅读对应组件的许可文本及随附说明。开源意味着代码和协作过程可供审阅，不意味着所有第三方订阅、服务器或网络环境都具有相同的可靠性。

客户端免费使用与服务器资源是两件事。安装客户端不会自动提供可连接的服务器，也不会自动生成有效订阅。连接地址、认证参数和服务可用性取决于配置来源。管理配置时保留必要的来源说明，但不要把完整订阅地址发布到公开页面、工单截图或共享文档中。

把更新拆成四项检查

分别记录客户端、内核、订阅和路由数据的变化。界面更新可能调整菜单位置，内核更新可能影响参数兼容，订阅更新可能替换服务器配置，路由数据更新则可能改变分类匹配结果。一次只处理一种变化，出现异常时更容易回到之前可用的状态。

更新前备份必要配置，记录自定义规则与本地监听设置；恢复配置后，重新核对活动服务器、系统代理和 TUN 状态。备份中可能包含认证信息，应放在受控位置。若某次更新后出现故障，先看错误日志与设置差异，再决定是否回退，不必立刻重装全部组件。

保持一套简短的日常检查顺序：确认分组更新结果，检查活动服务器，测试常用应用，再验证直连目标和局域网访问。需要新增路由例外时记录用途与匹配范围，定期清理不再使用的规则。完整的阶段式练习收录在新手到进阶手册；遇到陌生字段，先用概念速查确认含义，再修改设置。

技术笔记

客户端设置与专项排查

基础连接完成后，再按具体问题阅读。涉及权限、后台运行与流量接管的设置，分别对照对应系统处理。

查看全部文章 →