Windows
Windows 桌面端首选 v2rayN。下载页分别说明新一代跨平台桌面界面与经典 WPF 界面的适用情况。首次安装应先确认系统版本和运行环境，再按日常使用习惯选择界面类型。若旧配置需要迁移，先备份订阅地址与自定义路由，再在新客户端中逐项恢复。
前往下载
站务公告栏
从客户端下载到连接排查
按操作阶段查看说明。左侧选择主题，右侧给出适用范围、处理顺序与对应文档入口。
先按操作系统确定客户端
桌面设备统一从 v2rayN 开始选择。Windows 可在桌面版与经典版之间判断，macOS 按处理器架构选择安装包，Linux 则按发行版的软件包格式进入对应入口。Android 以 v2rayNG 为主，使用 Xray 内核；需要 V2Fly 内核时再选择 v2flyNG。这样的排列把操作系统、客户端和内核三层信息分开，避免仅凭相似名称下载错误文件。下载中心同时列出架构判断方法与安装前提，适合首次安装和更换设备时查阅。
平台入口只负责把用户带到对应下载面板，不在首页直接分发文件。进入下载页后再阅读系统要求、安装包差异和处理器说明，可以减少在移动设备上误选桌面文件，或在桌面设备上选错架构的情况。
CLIENTS · v2rayN / v2rayNG / v2flyNG · WINDOWS / macOS / ANDROID / LINUX
订阅导入按分组、更新、选择执行
订阅地址通常包含一组由服务提供方维护的连接配置。复制地址后，应先在客户端中新建订阅分组，再执行更新，最后从当前分组选择需要使用的配置。仅粘贴地址但没有更新分组，不会产生可选择的连接项；更新完成后仍使用旧配置，也不会切换到新内容。教程页把桌面端与 Android 的菜单名称分别列出，并说明剪贴板导入、手动添加和订阅更新之间的区别。
完成导入后先核对当前选中的配置，再决定系统代理模式。订阅地址属于持续使用的配置信息，不适合放入公开页面、截图或共享文档。需要迁移设备时，可在新设备重新建立分组并更新，避免把客户端运行目录整体复制到不同系统。
WORKFLOW · GROUP → UPDATE → SELECT → CONNECT
路由决定出口，DNS 决定解析
路由规则根据域名、地址范围、入站标签和网络类型决定流量进入哪个出站。DNS 配置则负责把域名转换为地址，并可针对不同域名集合指定解析服务器。两者经常同时出现，但处理阶段并不相同：解析结果可能参与路由匹配，路由也可能决定查询请求从哪个出口发送。配置手册按 inbounds、outbounds、routing、dns 和 policy 的顺序拆解 JSON 结构，便于定位每个字段所在层级。
普通用户优先使用客户端内置的预定义路由，再根据实际需求增加少量规则。修改后应保存配置并重新载入，随后用明确的域名逐项验证。一次加入大量规则会提高冲突概率，也会让排序问题更难判断；规则越具体，越需要确认它在列表中的匹配顺序。
CONFIG · routing / dns / outbounds · XRAY / V2FLY
从状态、配置、端口到系统代理逐层检查
连接失败时先确认客户端是否已经启动当前配置，再检查订阅分组是否更新、配置是否被筛选隐藏、系统时间是否准确。随后查看本地端口占用、系统代理状态、防火墙权限和运行日志。分层排查比重复点击连接更容易找到原因：客户端未运行属于进程层，配置无法启动属于参数层，本地端口冲突属于系统层，只有部分应用无法访问则通常需要继续检查代理模式或分应用设置。
帮助页按“完全无法连接、浏览器未生效、订阅更新异常、DNS 解析异常”分类整理检查顺序。记录错误发生的时间、使用的平台和刚刚修改的设置，再对照日志中的同一时间段，可缩小问题范围。恢复设置时一次只调整一个项目，便于确认哪项改动产生了结果。
CHECK · PROCESS → PROFILE → PORT → SYSTEM PROXY → LOG
四个平台入口
按设备进入下载面板
首页不直接区分安装包文件。先选择操作系统，下载页会继续说明客户端、处理器架构和软件包格式。
macOS
macOS 使用 v2rayN 桌面客户端。安装包按 Apple Silicon 与 Intel 处理器区分，不能只根据设备外观判断。可在系统信息中查看芯片或处理器名称，再进入相应入口。安装完成后需要授予系统要求的网络相关权限，并确认客户端菜单栏状态与系统代理状态保持一致。
前往下载Android
Android 主入口为 v2rayNG，使用 Xray 内核；v2flyNG 作为 V2Fly 内核对应的备选客户端。多数近年设备可先查看 arm64 安装包，无法确认架构时再阅读通用版说明。安装后应允许客户端建立本地 VPN 连接，并根据系统后台策略调整运行权限，避免锁屏后连接被系统回收。
前往下载Linux
Linux 桌面端使用 v2rayN，并按发行版选择 deb 或 rpm 软件包。Debian、Ubuntu 及其衍生系统通常使用 deb；Fedora、RHEL 系及相应衍生系统通常使用 rpm。处理器架构仍需单独确认。安装后若系统代理没有生效，应检查当前桌面环境的代理设置，而不是只查看客户端连接状态。
前往下载
快速上手预览
下载、导入、连接三步
以下流程用于完成首次连接。具体菜单位置、系统权限和异常处理在完整教程中分平台说明。
-
选择客户端并完成安装
先确定操作系统，再选择对应客户端。Windows、macOS 与 Linux 使用 v2rayN；Android 优先使用 v2rayNG，需要 V2Fly 内核时选择 v2flyNG。桌面安装包还要继续区分处理器架构或软件包格式。安装完成后先启动客户端，确认主窗口、托盘图标或状态区域可以正常打开，再进行订阅操作。
首次启动出现权限请求时，应根据系统提示允许客户端执行网络连接和系统代理相关操作。不要在尚未完成安装时直接复制旧设备的整个运行目录，因为不同系统的路径、权限和运行环境并不相同。需要保留的核心内容通常是订阅地址、自定义路由思路和少量手动配置。
-
建立订阅分组并更新
复制有效的订阅地址，在客户端订阅管理中新增分组。填写便于识别的分组名称，保存后执行订阅更新。更新完成才会生成可选择的配置项。若列表仍为空，先检查当前查看的是否为刚建立的分组，再检查筛选条件、地址是否完整以及更新日志中的提示。
配置较多时可按用途建立多个分组，但不建议把同一地址反复添加到不同分组。更新后选择一个配置作为当前连接项，并核对协议、地址和端口等基础信息是否完整。订阅内容由提供方维护，客户端负责读取和转换；遇到字段不兼容时，应先确认客户端与内核类型是否符合订阅要求。
-
启动连接并验证代理范围
选中配置后启动客户端，再根据设备决定系统代理、全局代理或分应用模式。桌面端应同时查看客户端运行状态与系统代理状态；Android 则需要确认系统已经允许本地 VPN 连接。连接建立后先用浏览器进行基础访问测试，再检查其他应用，避免把单个应用的独立代理设置误判为客户端整体故障。
如果浏览器正常而其他应用未生效，重点检查该应用是否遵循系统代理、是否启用了独立网络设置，以及当前路由规则是否覆盖对应流量。如果所有应用都无法连接，则返回客户端日志，按配置启动、端口占用、DNS 解析和远端响应的顺序定位。每次只修改一项设置，验证后再进入下一项。
开源生态说明
Project V、V2Fly 与 Xray 的关系
客户端、内核和协议属于不同层次。分清三者后，安装包选择与配置排查会更直接。
Project V 是协议与工具生态的来源
Project V 形成了以 V2Ray 配置模型、代理协议、传输方式和路由能力为核心的开源生态。用户日常接触到的图形客户端并不是全部能力本身，而是对配置、内核进程和系统代理操作的界面封装。订阅导入、配置选择、日志查看和系统代理切换由客户端负责；连接建立、协议处理、路由匹配与 DNS 查询等工作通常由内核完成。
因此，界面名称相似并不代表使用同一个内核，使用同一内核也不代表各客户端拥有完全相同的菜单。排查问题时应先记录客户端名称和平台，再确认内核家族与配置协议。仅写“V2Ray 不能连接”通常不足以判断故障位置。
V2Fly 与 Xray 属于相关的内核家族
V2Fly 延续并维护 V2Ray 生态中的核心实现、配置结构与相关组件。Xray 在相近配置思路上发展，并加入自身支持的协议、安全层与传输能力。两者存在大量共同概念，例如入站、出站、路由、DNS、策略和日志，但具体字段、可用协议与默认行为可能不同。使用配置示例前，应先确认示例面向哪个内核，不能只看文件扩展名相同就直接套用。
v2rayNG 主要配合 Xray 内核，v2flyNG 对应 V2Fly 内核。v2rayN 可在桌面端承担客户端界面和配置管理角色，具体可用能力取决于所选内核与当前配置。本站在文档中会明确标注内核范围；通用概念放在基础章节，存在差异的字段则在配置手册中分别说明。
三款客户端均按开源项目方式维护
v2rayN、v2rayNG 与 v2flyNG 都以公开代码、版本记录和许可文件为基础进行维护。图形客户端的职责是把内核参数、订阅内容和系统网络设置整理成可操作界面。桌面端侧重多窗口、托盘状态、系统代理与配置编辑；Android 客户端侧重本地 VPN 接口、分应用代理、后台运行和移动网络切换。
开源属性意味着功能变化可以通过发布记录、文档和代码演进得到解释，但不同项目的发布节奏并不要求同步。客户端更新可能调整界面或订阅处理，内核更新可能增加协议能力或修正连接行为。遇到升级后的设置差异，应先阅读对应客户端的变更说明，再决定是否迁移旧配置。
更新顺序按需求和兼容性决定
日常更新不需要同时替换全部组件。出现明确兼容需求、协议支持变化或已知问题修正时，再根据发布说明更新客户端。更新前记录当前客户端名称、配置分组、自定义路由和系统代理模式；更新后先载入原有配置，验证基础连接，再恢复复杂规则。这样的顺序可以区分安装问题、配置问题和内核行为变化。
订阅由服务提供方更新，客户端与内核由各自项目维护，本站负责整理下载入口和中文操作资料。三类更新来源彼此独立。看到订阅内容变化时不必直接重装客户端；看到客户端界面变化时也不代表订阅本身失效。先判断变化来自哪一层，再选择相应文档处理。
最新文档文章
协议、安装与故障处理
文章按实际操作问题组织。协议文章说明选择依据，安装文章覆盖首次设置，排查文章给出逐项检查顺序。
VMess 和 VLESS 有什么区别？普通用户一分钟看懂选哪个
从加密方式、传输开销与服务端要求三个角度说明 VMess 与 VLESS 的实际差别。普通用户通常不需要手动改写协议参数，应以订阅提供的信息和服务端配置为准；需要手动选择时，再根据客户端支持范围与安全层要求判断。
阅读文章 →v2rayNG 耗电太快怎么办：后台保活与省电策略排查步骤
逐项检查分应用代理范围、连接心跳、Mux 设置、系统省电白名单和厂商后台限制。文章区分客户端持续运行、频繁重连与系统重复唤醒三类现象，帮助确认耗电来自网络活动、配置策略还是后台管理规则。
阅读文章 →VMess、VLESS、Trojan、Shadowsocks 横向对比：四种代理协议怎么选
按握手方式、传输开销、服务端要求和客户端支持范围整理四种协议。内容面向需要读懂订阅信息或部署参数的用户，重点说明协议层、传输层和安全层不能混为一个选项，也不以单一指标判断全部场景。
阅读文章 →