Windows · v2rayN
Windows 用户可在新一代桌面界面与经典 WPF 界面之间选择。完成安装后，先导入订阅并选择节点，再设置系统代理。若启动时提示本地端口被占用，应先定位占用进程，或修改监听端口后同步更新代理设置。下载页同时列出两种界面的用途差异，便于按现有系统环境选择。
前往下载
下载 · 配置 · 分流 · 排查
V2Ray配置教程
从客户端安装开始，依次说明订阅导入、路由分流与故障定位，覆盖桌面端和 Android 的常用操作路径。
中文文档
代码开源
Xray · V2Fly
图形客户端
从订阅入口到出口验证的配置链路
客户端配置不是一组彼此孤立的开关。订阅负责提供节点信息，路由决定流量去向，系统代理或 TUN 模式负责接管应用请求，日志与连通性测试则用于确认每一段链路是否按预期工作。
订阅链接导入、更新与节点确认
订阅链接是客户端获取节点配置的入口。桌面端通常在订阅分组中新增地址，再执行更新；Android 客户端则可通过剪贴板导入或扫描受信任来源提供的二维码。导入完成并不等于链路已经可用，第一步应查看节点列表是否出现、名称是否正常、分组是否对应预期来源。如果列表为空，需要先检查地址是否完整、网络请求是否成功以及客户端日志中的响应状态，而不是反复切换系统代理。
更新订阅时，客户端会重新读取远端内容，并可能覆盖同一分组中的旧节点。需要长期保留的手动配置应放在独立分组，避免与订阅更新混在一起。节点出现后再进行一次连接测试，区分“订阅读取成功”和“具体节点可连接”这两个结果。这样的检查顺序能够把问题限制在输入、解析或连接阶段，减少无目标地修改 DNS、端口和路由规则。
域名、IP 与进程规则的命中顺序
路由分流决定一条请求走代理出口、直接连接还是被阻止。规则通常会读取域名、目标 IP、端口、网络类型或进程信息，并按照客户端当前配置的顺序匹配。排查分流结果时，应先确认请求是否被客户端接管，再查看命中的规则和最终出站；只观察网页能否打开，无法判断请求究竟走了哪条路径。规则越多越需要明确优先级，范围较小、意图明确的规则通常应放在宽泛规则之前。
域名规则适合处理名称稳定的服务，IP 规则适合已知地址段，进程规则则可用于桌面应用的定向处理。启用新的规则集后，建议选择几个有代表性的目标分别验证直连、代理和阻止结果，并查看日志中的路由记录。若结果与预期不符，先临时停用最近添加的规则，再逐条恢复；不要同时更换节点、DNS 和代理模式，否则很难确认是哪一项配置改变了路径。
系统代理与 TUN 模式的接管范围
系统代理适合遵循操作系统代理设置的浏览器和常规桌面应用，配置清晰，停用后也容易恢复。部分程序会绕过系统代理，或直接建立网络连接，此时可以考虑使用 TUN 模式。TUN 通过虚拟网卡接收更广范围的流量，再交给内核执行路由与出站处理，因此涉及网络权限、路由表、DNS 解析和本地防火墙等更多环节。选择接管方式时，应根据应用行为决定，而不是默认同时开启所有选项。
从系统代理切换到 TUN 前，先记录当前本地监听端口与代理状态，并退出其他可能创建虚拟网卡的网络工具。开启后分别验证浏览器、目标应用和域名解析；如果客户端退出后网络没有恢复，优先检查系统代理残留、虚拟网卡状态和 DNS 设置。桌面端首次启用 TUN 可能需要提升权限，移动端则会显示系统级网络连接确认。完整步骤与回退路径可在使用文档中按平台查看。
按链路层级读取状态与日志
故障定位应沿着“客户端进程、本地入口、节点连接、远端出口、域名解析”的顺序进行。客户端无法启动时先看端口占用和权限；客户端已启动但应用不通时检查系统代理与接管范围；节点测试超时时再检查节点参数、网络环境和传输设置；只有域名访问异常而直接访问 IP 正常时，才把重点转向 DNS。把症状对应到链路层级，比连续更换节点或重装客户端更有效。
日志中的时间、级别和错误位置需要结合操作动作阅读。执行一次更新订阅、启动连接或打开目标应用后，立即查看新增日志，可以减少历史记录干扰。端口冲突通常指向本地监听阶段，连接超时多发生在节点或传输阶段，解析失败则要检查 DNS 请求走向。修复后应重复原来的触发步骤，确认错误记录不再出现，并检查系统代理是否恢复到预期状态。
Windows、macOS、Android 与 Linux 下载入口
桌面平台统一使用 v2rayN，Android 可在 v2rayNG 与 v2flyNG 之间按内核需求选择。平台入口会跳转到下载页对应标签，安装包类型、系统要求和芯片选择说明集中在同一位置。
macOS · v2rayN
macOS 下载需要先确认处理器架构，Apple Silicon 与 Intel 对应不同安装文件。首次运行时还可能遇到系统安全确认和网络访问权限请求，应通过系统设置完成授权，再返回客户端导入订阅。连接后先检查菜单栏状态和系统代理，再进行应用访问测试，避免把权限问题误判为节点异常。
前往下载Android · v2rayNG / v2flyNG
Android 主入口为采用 Xray 内核的 v2rayNG，偏好 V2Fly 内核时可选择 v2flyNG。多数较新的设备使用 arm64 架构；无法确认架构时，可在下载页查看通用安装文件。导入订阅后需要选择节点并启动系统网络连接，随后分别检查连接状态、分应用设置和电池后台限制，避免客户端在锁屏后被系统提前停止。
前往下载Linux · v2rayN
Linux 桌面端按发行版选择 deb 或 rpm 安装文件，同时需要确认 x64 与 arm64 架构。安装后可通过图形界面管理订阅、节点和路由规则。若系统代理没有影响目标应用，应检查桌面环境的代理设置，以及应用是否自行维护网络配置；需要更广接管范围时，再评估 TUN 权限和虚拟网卡状态。
前往下载Project V、V2Fly 与 Xray 内核关系
理解客户端、内核和协议之间的分工，有助于判断配置问题发生在哪一层，也能避免把图形界面名称、订阅格式和传输协议混为一谈。
从 V2Ray 工程到内核家族
V2Ray 源于 Project V 生态，核心思路是把入站、路由、出站与底层传输拆分为可组合的配置模块。随着社区维护方向演进，V2Fly 延续了 v2ray-core 体系，Xray 则在相近配置理念上发展出另一条内核分支。两者都可处理多种代理协议和传输方式，但具体字段、功能支持与默认行为可能不同。因此，导入配置前需要确认客户端采用的内核，以及订阅内容是否包含对应内核能够识别的参数。
图形客户端位于内核之上，负责订阅管理、节点选择、系统代理、日志查看和更新设置。v2rayN 面向桌面平台，可按软件提供的选项调用对应内核；v2rayNG 主要采用 Xray 内核；v2flyNG 则面向 V2Fly 内核路线。客户端名称不等于协议名称，选择某个客户端也不代表所有节点都使用同一种协议。实际链路由节点配置、传输层、TLS 设置、路由规则与客户端接管方式共同决定。
开源许可与代码边界
V2Fly 核心、Xray 核心和三款图形客户端分别维护自己的代码与许可文件。核心工程与客户端可能采用不同开源许可，发布包还会包含各自依赖组件。查看许可时应以对应软件发布内容附带的说明为准，而不是把整个生态视作一个单一项目。开放的代码与配置格式便于社区审阅实现、讨论兼容性并持续修复问题。
客户端与内核独立更新
图形界面和网络内核具有不同的发布节奏。客户端更新可能调整订阅管理、界面交互或系统集成，内核更新则更侧重协议实现、传输能力、路由与网络行为。遇到升级后的异常时，需要先分辨变化来自客户端还是内核，再结合日志和配置迁移说明处理。下载页集中提供当前安装入口，首页不固定展示可能快速变化的发布信息。
协议、传输与路由分层
VMess、VLESS、Trojan 等名称描述的是协议层配置；WebSocket、gRPC 等属于传输方式；TLS 与 REALITY 涉及连接认证和安全传输；路由规则则决定请求选择哪个出站。排查时应按层级核对，不应因为域名解析失败就直接修改协议参数，也不应在应用没有进入本地代理时反复调整远端节点。
桌面图形客户端
覆盖 Windows、macOS 与 Linux，集中管理订阅、节点、路由、系统代理和 TUN 设置。适合需要在桌面环境中查看日志、维护多个订阅分组并精细调整接管方式的用户。
Android · Xray 路线
以移动端操作为中心，提供订阅导入、节点选择、分应用代理、路由与系统网络连接管理。遇到后台断开时，还需要结合设备的电池策略与后台运行权限检查。
Android · V2Fly 路线
面向需要 V2Fly 内核实现的移动端配置，可作为 Android 平台的另一种内核选择。导入前应核对订阅参数与内核支持范围，避免将内核差异误判为订阅地址失效。
配置进阶与故障排查文章
文章围绕具体症状和配置环节展开，说明原理、操作路径、结果判断与回退方法。建议先完成基础安装和订阅导入，再按实际问题阅读对应专题。
TUN 模式开启方法详解：虚拟网卡接管全局流量的原理与配置步骤
解释 TUN 模式与系统代理的本质区别，梳理虚拟网卡、路由表、DNS 与应用流量之间的关系，并给出 v2rayN 与 v2rayNG 的开启步骤。文章同时列出权限不足、网络未恢复和其他虚拟网卡冲突时的检查路径。
阅读全文端口被占用怎么办：定位占用进程与修改 V2Ray 本地监听端口
客户端启动时出现端口冲突，需要先确认监听端口和占用进程，再决定结束旧进程还是修改配置。文章分别说明常见桌面系统的定位思路，以及端口变更后为什么必须同步更新系统代理和应用代理设置。
阅读全文DNS 泄漏检测与修复实操：让域名解析和流量走同一条链路
从域名解析路径入手，说明客户端已经连接时解析请求为什么仍可能走向其他网络接口。文章给出检测思路、v2rayN 与 v2rayNG 的 DNS 配置检查项，并通过修改前后的请求路径验证修复是否生效。
阅读全文