Windows
Windows 用户可选择 v2rayN 桌面版或经典 WPF 版。前者采用跨平台界面架构，后者适用于希望延续传统 Windows 操作习惯的场景。下载页同时说明安装选择、系统代理入口与两条发行线的定位差异。
前往下载
READING ORDER / 01
从客户端选择进入配置结构
V2Ray 客户端承担界面、订阅与系统代理管理，Xray 或 V2Fly 内核负责协议处理、传输与路由。将两者分开理解，可以减少把界面选项、内核字段和服务端参数混为一谈的情况。
首页按“选择平台—导入配置—确认路由—检查连接”的阅读顺序组织资料。需要直接安装时进入客户端页，需要逐步操作时进入入门指南，需要核对字段时进入配置大全。
FEATURE LEDGER / 02
客户端能力与配置边界
以下条目把常见界面功能映射到内核概念。选择条目后可阅读其操作顺序、字段边界与排查重点。
规则顺序、匹配范围与出站标签
路由排查应从输入条件开始：先确认流量进入哪个 inbound，再核对域名、IP、端口或进程条件是否能够命中，最后检查目标 outbound 的标签与定义。规则数组通常按顺序匹配，因此宽泛条件放在前面可能遮蔽后续细分规则。客户端提供的“全局”“规则”或“直连”等模式，本质上是对一组入站、路由和出站关系的界面化管理，而不是相互独立的协议。
导入、更新与活动配置
订阅导入后，先确认条目是否进入预期分组，再执行一次手动更新并阅读客户端给出的状态信息。更新只负责取得和解析内容，不会自动证明其中每个配置均可连接。切换节点后还要确认该条目已设为活动配置，并根据平台检查系统代理或移动端连接开关。迁移设备时，建议先记录自定义路由和 DNS 设置，因为这些本地规则未必属于订阅内容。
解析入口、查询策略与规则联动
设置 DNS 前应明确解析链路：应用把域名交给系统，还是由客户端的入站接收后交给内核。内核配置中的服务器列表、hosts 静态映射、查询策略和基于域名的服务器选择承担不同职责。若启用按域名或 IP 分流，还需关注解析结果是否进入路由判断。故障排查时可先恢复较简单的单一路径，确认基础查询正常后再逐项加入分流条件。
连接字段与传输字段分层核对
VMess、VLESS 等协议名称描述的是连接语义，WebSocket、gRPC、mKCP 等名称描述传输承载方式。导入链接或 JSON 后，应分层检查服务器地址、端口、用户参数、加密或安全选项，再核对路径、服务名、主机名等传输字段。不要用切换系统代理模式的方法修正协议参数；接入层只能决定哪些流量进入客户端，无法替代两端参数的一致性检查。
系统代理、虚拟接口与应用范围
桌面系统代理主要覆盖遵循系统设置的应用，部分软件可能保留自己的网络配置。移动端连接由系统 VPN 服务承载，并可通过分应用代理控制纳入范围。遇到“浏览器可用但其他应用无响应”时，优先确认目标应用是否读取系统代理、是否被分应用规则排除，以及客户端是否启用了与当前场景相符的接入方式，再继续检查内核日志与路由。
PLATFORM INDEX / 03
四个平台的客户端入口
桌面平台统一以 v2rayN 为主要入口，Android 可在 v2rayNG 与 v2flyNG 之间按内核需求选择。安装包与处理器架构说明集中放在下载页。
macOS
macOS 使用 v2rayN 桌面版，并按 Apple Silicon 与 Intel 处理器选择对应安装文件。若不确定芯片类型，可先在系统信息中查看处理器或芯片名称，再进入下载页选择，避免把架构问题误判为应用启动故障。
前往下载Android
Android 可使用采用 Xray 内核的 v2rayNG，也可按配置与内核偏好选择采用 V2Fly 内核的 v2flyNG。下载页分别提供 arm64 与通用安装文件，并说明 VPN 服务、后台运行和分应用代理的基本关系。
前往下载Linux
Linux 桌面可使用 v2rayN，并按 Debian、Ubuntu、Fedora 等发行版的软件包体系选择 deb 或 rpm 文件。下载页同时列出 x64 与 arm64 的入口；安装后可继续参考教程完成桌面集成、订阅导入与登录会话自启动设置。
前往下载
QUICKSTART / 04
三步完成基础配置
快速上手只处理最短路径。首次连接稳定后，再逐步加入自定义 DNS、复杂路由与分应用规则，便于在出现问题时定位变更来源。
-
01
安装与平台确认
根据操作系统、处理器架构和桌面环境选择客户端。Windows 与 Linux 还需区分发行形式，macOS 需要辨认芯片架构，Android 则在 arm64 与通用安装文件之间选择。首次启动后先确认界面能够正常打开、内核能够载入，再继续导入配置，避免把安装问题和连接参数混在同一步排查。
-
02
导入订阅或单条配置
订阅适合集中管理多个条目，单条链接或手工 JSON 适合核对具体参数。导入后检查分组、协议、地址、端口和传输类型是否按预期显示，然后手动选择活动配置。若客户端提示解析失败，应优先确认内容格式与复制范围，不要通过反复切换代理模式掩盖导入阶段的问题。
-
03
连接、接入系统与验证
启动客户端连接后，根据平台启用系统代理或移动端 VPN 服务。验证时先使用一个遵循系统网络设置的应用，再观察客户端日志是否出现对应请求。确认基础链路后，才加入绕行规则、DNS 分流和分应用范围。这样的顺序能够区分连接参数、系统接入和路由条件分别处于哪一层。
ECOSYSTEM NOTES / 05
Project V、V2Fly 与 Xray 内核家族
图形客户端、内核与配置格式属于相互协作但职责不同的层次。理解项目关系，有助于判断某个选项来自界面、内核能力还是协议本身。
生态来源与配置模型
Project V 形成了以入站、出站、路由、DNS、策略和传输设置为核心的配置模型。它并非单一图形程序名称，而是协议实现、内核分支、客户端界面与文档实践共同构成的技术生态。许多客户端把 JSON 字段转换成表单、菜单和模式选择，使日常操作更直观，但底层逻辑仍可回到 inbounds、outbounds、routing 与 dns 等结构进行解释。
阅读配置文件时，适合先从数据流向建立整体认识：应用流量通过本地入站进入内核，路由规则决定采用哪个出站，出站再依据协议与传输字段建立连接。DNS 和 policy 等部分则为解析、资源策略及特定行为补充条件。按照这条链路阅读，比逐个记忆孤立字段更容易发现引用标签错误或规则范围冲突。
持续维护的内核分支
V2Fly 延续 Project V 相关技术体系，并围绕协议、路由、传输和平台适配持续维护。v2flyNG 采用 V2Fly 内核，为 Android 场景提供另一套图形客户端组合。选择它时，应关注订阅内容与目标内核支持范围，并以客户端实际呈现的配置项为准，而不是仅依据相似的链接外观判断兼容性。
内核更新通常涉及协议实现、依赖组件、传输行为与问题修复。客户端更新则还包含界面、订阅解析、系统接入和平台打包。两者的发布节奏可能不同，因此排查某项能力时，需要同时辨认客户端名称与其所搭配的内核家族，避免把界面没有暴露的选项误认为内核完全不具备相应能力。
协议与传输能力的另一分支
Xray 是同一技术生态中的内核分支之一，围绕协议、传输与路由能力形成独立维护路径。v2rayNG 通常与 Xray 内核组合，v2rayN 也可在其支持范围内管理相应内核。配置迁移时应核对具体字段，而不是假设不同内核的所有扩展项都具有完全相同的名称、默认值与可用范围。
涉及 VLESS、Reality、gRPC 或精细路由时，内核差异会比基础系统代理操作更重要。较稳妥的处理方式是先保留可工作的最小配置，再依据当前内核文档逐项加入传输安全、嗅探、DNS 与路由条件。若一次同时改变多个字段，即使最终失败，也难以判断问题来自协议参数、传输设置还是本地接入。
客户端、许可与更新机制
v2rayN、v2rayNG 与 v2flyNG 均属于代码公开维护的客户端项目。代码开放使界面行为、配置转换与内核调用方式可以被技术社区讨论和复查，也使不同平台能够围绕相同配置概念形成各自的操作界面。开源属性是一种开发与协作方式，不应被替代为对任意配置来源或网络环境的笼统判断。
更新时应区分客户端程序、内核组件和订阅内容三个对象。客户端程序更新可能改变界面与解析逻辑，内核更新可能改变协议或传输实现，订阅更新则只替换配置条目。记录变更对象与时间顺序，能够在异常出现后缩小回溯范围。本站的下载页负责平台与安装文件选择，配置大全负责字段含义，博客则追踪架构差异和常见维护问题。
SELECTED QUESTIONS / 06
常见问题精选
以下问题按排查顺序给出简要判断。涉及具体按钮与字段位置时，可继续进入入门指南或配置大全。
v2rayN 桌面版与 WPF 版应该如何选择
桌面版采用 Avalonia 跨平台架构，可用于 Windows、macOS 与 Linux；WPF 版只面向 Windows，并延续经典界面与操作路径。新安装可先从桌面版开始，已经形成固定 Windows 使用流程的用户可对照两版界面、依赖和迁移方式后再决定。下载页分别保留两条入口。
订阅导入成功后为什么仍然没有连接
导入成功只表示客户端读取了订阅内容。还需要选择活动配置、启动连接，并按平台启用系统代理或 VPN 服务。若仍无响应，应依次查看地址与端口、协议和传输字段、系统时间、接入范围及客户端日志，不宜直接把所有问题归因于订阅地址。
全局模式、规则模式与系统代理有什么区别
系统代理描述应用流量如何进入客户端，全局或规则模式描述进入内核后的流量如何选择出站。前者属于系统接入层，后者属于路由层。某个应用若不读取系统代理，即使路由设为全局，也可能没有流量进入客户端；反之，流量进入后仍会受到所选路由模式影响。
V2Ray DNS 设置应从哪里开始检查
先确认域名由系统解析还是交给内核，再检查 DNS 服务器、查询策略和静态映射。若同时启用了多个接管方式，可先缩减为单一路径，确认基础解析后再恢复分流。使用域名与 IP 组合规则时，还要核对解析结果是否参与路由匹配。
LATEST PAPERS / 07
客户端与配置研究笔记
文章区记录发行线差异、平台运行策略与代理模式边界，作为下载页和配置文档之外的专题补充。
v2rayN 桌面版与 WPF 版怎么选：Avalonia 跨平台架构差异逐项对照
梳理 v2rayN 两条发行线的定位，比较平台范围、界面渲染、系统依赖、更新节奏与配置迁移注意事项。
阅读全文 →v2rayNG 耗电异常排查：安卓后台保活设置与省电策略整理
从 VPN 服务常驻、厂商后台限制与分应用代理范围三个方向解释耗电变化，并整理可逐项复查的后台设置。
阅读全文 →系统代理、全局模式与绕过大陆模式区别详解：三种模式如何选择
区分系统接入与内核路由两个层次，说明三种常见选项的流量范围、适用边界和切换判断方法。
阅读全文 →