DESKTOP / WPF
Windows
Windows 用户可选择 v2rayN 新一代桌面界面或经典 WPF 界面。两者都用于订阅管理、系统代理、路由规则和内核控制；新安装可先从桌面版开始，已有稳定配置的用户可继续使用熟悉的 WPF 操作路径。
前往下载CLIENT OPERATIONS
订阅、线路与本地流量处理
客户端配置不是只填入一条链接。订阅更新、服务器筛选、路由匹配、DNS 出站和 TUN 接管会共同决定连接结果。
MODULE / 01
订阅导入与服务器整理
订阅地址用于批量取得服务器配置。导入后应先执行一次更新，再按协议、地区或自定义备注整理服务器，避免在一长串名称里反复寻找。v2rayN 可建立订阅分组并使用筛选条件，v2rayNG 则适合在移动端维护少量常用分组。更新失败时，先区分链接失效、更新请求需要经过代理、响应格式不兼容与客户端权限问题，不要直接删除现有配置。完成更新后再选中服务器并设为活动项，订阅存在并不等于线路已经投入使用。
查看订阅导入步骤 →MODULE / 02
路由规则与流量分流
路由规则根据域名、IP、端口、网络类型和进程信息决定流量走向。常见做法是先设置局域网与必要直连项，再处理代理规则，最后保留一个明确的默认出口。规则顺序会影响结果：前面的匹配项通常先被采用，因此范围较窄的规则应放在范围较宽的集合之前。GeoIP 与 GeoSite 是匹配数据，不是连接协议；更新数据后还要确认规则名称和客户端内核能够识别。调整前导出当前配置，修改后用具体域名逐项验证。
阅读路由规则实战 →MODULE / 03
DNS 查询与域名判定
DNS 配置决定域名如何解析，也会影响按域名建立的路由规则。客户端通常可分别指定本地 DNS、远程 DNS、查询策略和 DNS 出站。若系统解析结果与代理连接使用的解析结果不一致，可能出现域名规则命中异常、连接目标变化或应用反复重试。配置时应明确哪些查询走本地出口、哪些查询交给代理侧处理，并检查 IPv4、IPv6 策略是否符合当前网络。启用 FakeDNS 前还要确认应用兼容性及 TUN 模式的接管范围。
查看 DNS 配置章节 →MODULE / 04
TUN 模式与系统流量接管
TUN 模式通过虚拟网络接口接管更多系统流量，适合无法读取系统代理设置的应用，也适合需要统一执行路由规则的场景。它与普通系统代理的覆盖范围不同，启用时通常需要额外权限，并可能与其他网络过滤工具、虚拟网卡或安全策略发生冲突。首次配置应保持规则简洁，确认网页、命令行工具和常用应用都能正常连接后，再逐步加入进程规则、DNS 劫持或 FakeDNS。停止客户端前先恢复相关网络设置，可减少下次启动时的排查成本。
继续阅读 TUN 模式 →MODULE / 05
客户端更新与故障定位
出现无法连接、订阅更新失败或规则不生效时，先把问题拆成客户端、订阅、服务器、内核、DNS 和本地网络六个层次。日志中的时间、出站标签、域名和错误类型比单一的测速结果更有判断价值。更新客户端前可导出订阅分组、路由与 DNS 设置，更新后先使用原配置验证，再决定是否启用新增选项。若只有某个应用异常，应比较系统代理与 TUN 模式的接管差异；若所有线路同时异常，则优先检查本地网络、订阅状态和内核启动日志。
打开进阶排查手册 →PLATFORM DOWNLOADS
四个平台的客户端入口
桌面端以 v2rayN 为主，Android 可在 v2rayNG 与 v2flyNG 之间按内核需求选择。具体安装包类型、处理器架构和系统要求在下载页分组列出。
DESKTOP / DMG
macOS
macOS 使用 v2rayN 桌面客户端，下载时需要按设备处理器选择 Apple Silicon 或 Intel 安装包。安装完成后可导入订阅、切换系统代理并编辑路由；若系统阻止首次运行，应在系统安全设置中确认应用权限。
前往下载MOBILE / APK
Android
Android 首选 v2rayNG，它以 Xray 内核处理常见协议和路由配置；需要 V2Fly 内核时可选择 v2flyNG。主流设备通常使用 arm64 安装包，不能确定处理器架构时再选择通用安装包，避免下载与设备架构不匹配的文件。
前往下载DESKTOP / DEB · RPM
Linux
Linux 桌面可使用 v2rayN，根据发行版的软件包体系选择 deb 或 rpm，并按 x64、arm64 架构继续区分。安装后需要关注桌面环境、系统代理写入方式与 TUN 权限；服务器环境则应优先理解配置和服务管理，而不是照搬桌面操作。
前往下载-
STEP 01
导入订阅并执行更新
复制完整订阅地址，在客户端的订阅分组中新增记录，然后手动执行一次更新。更新结束后检查服务器列表是否出现、备注是否可读、协议字段是否被正确识别。若列表为空，应先处理订阅响应，而不是继续调整系统代理。
-
STEP 02
选择服务器与代理模式
从服务器列表中选择一个配置设为活动项，再根据用途选择系统代理或 TUN 模式。首次连接建议保持路由规则简单，先验证浏览器和常用应用；确认基础连接成立后，再切换规则模式并添加自定义直连或代理条件。
-
STEP 03
连接后检查日志与出口
启动连接后查看客户端状态和内核日志，确认本地监听端口已经建立，随后分别测试域名访问与需要代理的应用。若连接按钮已开启但应用仍无法访问，应检查应用是否读取系统代理、DNS 是否按预期出站，以及规则是否把目标流量送往正确出口。
PROJECT V / CORE FAMILY
Project V、V2Fly 与 Xray 的关系
客户端负责图形界面与系统集成，内核负责协议、传输、路由和出站处理。理解这层分工，才能看懂客户端更新说明与配置兼容范围。
从协议工具到客户端生态
Project V 是围绕代理协议、传输层、路由和网络工具形成的开源技术生态。它并不等同于某一个图形客户端：桌面或移动客户端提供订阅管理、连接按钮、系统代理、日志查看与配置编辑，真正执行网络处理的是客户端调用的内核。用户在界面中看到的服务器、路由规则和 DNS 选项，最终会被整理成内核能够读取的配置。
V2Fly 延续了 V2Ray 体系中的核心能力，强调开放的协议组合、传输配置和路由机制。Xray 则从同一技术家族发展出独立内核，在 VLESS、XTLS、REALITY 等能力上形成自己的实现方向。两类内核在不少基础配置上存在共同概念，但功能支持、字段细节与更新节奏并不完全一致，因此不能只看配置文件外观判断兼容性。
v2rayN 是桌面图形客户端，可管理不同内核与多组订阅；v2rayNG 主要在 Android 上配合 Xray 内核使用；v2flyNG 则面向 V2Fly 内核。三款客户端都以开放源代码方式维护，界面项目与内核项目各自发布更新。遇到协议不识别或新字段无法保存时，应同时检查客户端支持范围和所选内核能力。
开源协议与代码审阅
v2rayN、v2rayNG、v2flyNG 及其常用内核都有明确的开源许可。开源许可规定代码使用、修改和再分发条件，也让功能变化能够通过源代码、提交记录和发布说明被技术社区审阅。站内以客户端实际功能与公开文档为依据，不用下载量、评分或无法核实的测试数字替代技术说明。
客户端与内核分别更新
客户端更新通常涉及界面、订阅管理、系统代理写入和配置生成；内核更新则可能增加协议能力、调整配置字段或修复网络处理问题。两者版本节奏不同。排查连接异常时，应记录客户端名称、当前内核家族、使用模式和日志错误，而不是只描述连接按钮是否点亮。
配置兼容需要逐项确认
VMess、VLESS、Trojan、WebSocket、gRPC、TLS、REALITY 等名词分别位于协议、传输和安全层，不能互相替代。订阅转换或跨客户端迁移时，需要确认目标客户端是否识别全部字段。若转换过程丢失流控、传输参数或服务器名称，连接结果就可能与原客户端不同。
COMMON QUESTIONS
常见配置问题精选
以下问题覆盖首次导入、客户端选择、更新失败和连接后无流量四个高频环节。完整操作步骤放在使用指南与进阶手册中。
订阅导入后为什么没有服务器？
先确认新增的是订阅分组而不是单个服务器，再执行手动更新。若更新提示响应为空或格式无法识别，应检查地址是否完整、链接是否仍有效，以及是否需要开启经代理更新。不要在订阅尚未取得内容时继续修改路由规则。
查看导入步骤 →v2rayNG 与 v2flyNG 如何选择？
需要 Xray 内核相关能力时选择 v2rayNG；明确需要 V2Fly 内核或已有对应配置时选择 v2flyNG。两者界面操作相近，但内核支持范围和部分字段不同。迁移订阅后应检查协议、传输、安全层与路由设置是否完整保留。
查看 Android 客户端 →连接已开启但应用没有流量怎么办？
先确认应用是否读取系统代理；不读取时再考虑 TUN 模式。随后检查活动服务器、路由默认出口、DNS 解析方式和本地监听状态。若只有单个应用异常，重点比较该应用的代理能力与网络权限，不必立即重建全部订阅。
按层次排查 →路由规则修改后为什么没有命中？
检查规则顺序、域名匹配类型、出站标签与 GeoIP、GeoSite 数据是否一致。已有连接可能继续沿用旧路径，修改后应重新建立连接再测试。日志若能显示目标域名和匹配出站，可直接判断问题发生在规则条件还是后续连接阶段。
阅读路由章节 →TECH NOTES
配置与排查文章
围绕 FakeDNS、DNS 泄漏和内核差异继续展开，内容包含适用边界、操作路径和排查顺序。