开源客户端 · 中文配置指南

V2Ray免费下载 配置教程

下载v2rayN 查看教程

桌面选择 v2rayN，安卓选择 v2rayNG。围绕免费开源客户端，按顺序完成订阅导入与路由分流。

VMess VLESS Trojan Shadowsocks
Windows Android macOS Linux
客户端v2rayN · v2rayNG · v2flyNG 内核生态Xray · V2Fly · sing-box 配置顺序订阅 → 代理 → 路由

订阅、代理与路由设置

先让配置可用，再决定哪些流量进入代理。五项设置分别处理不同环节，不必一次全部开启。

订阅管理 · 设置示意

保存来源，再更新配置

添加订阅分组
更新订阅（不通过代理）
更新订阅（通过代理）

按地址的实际可达性选择更新方式。

这五项不是互相替代的连接方式，而是配置链路的不同层次。订阅提供节点参数，系统代理或 TUN 负责接入流量，路由决定请求的去向，内核最终执行连接。排查时按这个顺序检查，可以把“没有配置”“应用未接入”“规则选错出口”和“协议不兼容”区分开。完整步骤见 v2rayN 配置教程，需要了解术语时再查阅 术语表。

按系统选择 V2Ray 客户端

先确认操作系统与处理器架构。桌面端统一从 v2rayN 开始，安卓端优先选择 v2rayNG。

Windows

v2rayN · 桌面首推

下载页提供 Desktop 与经典 WPF 两种入口。Desktop 使用跨平台界面，WPF 保留经典桌面操作习惯；先按系统要求和使用偏好选择一种，不需要同时安装。首次运行后确认数据目录可写，再添加订阅，避免把程序放进受限目录导致配置无法保存。

已有配置时，更新前先备份订阅分组与路由设置。切换界面版本后应检查数据是否正确导入，再测试系统代理，不要直接覆盖仍在运行的程序文件。

前往下载 Windows 客户端 →

macOS

v2rayN · 按芯片选择

先在系统的“关于本机”中查看芯片信息，再选择 Apple Silicon 或 Intel 对应安装入口。相同客户端也需要匹配处理器架构；选对安装包后，再按系统提示完成应用安装与首次启动。系统代理与 TUN 所需权限不同，应分别理解其作用。

浏览器能够连接不代表所有应用都已使用代理。对不遵循系统代理的应用，先检查应用自身网络设置；确有接管需求时，再参考进阶教程评估 TUN。

前往下载 macOS 客户端 →

Android

v2rayNG 优先 · v2flyNG 备选

v2rayNG 对接 Xray 生态，适合大多数安卓入门配置；需要 V2Fly 路线时再考虑 v2flyNG。下载时按设备架构选择 arm64 或通用包。安装完成后，先导入订阅并选择节点，再确认系统弹出的 VPN 连接授权，这项授权用于建立本地流量接管接口。

若锁屏后连接中断，应检查后台运行与电池优化限制。分应用代理可以缩小接管范围，但调整后要重新验证实际应用，不要仅依据通知栏图标判断连接是否正常。

前往下载 Android 客户端 →

Linux

v2rayN · deb / rpm

根据发行版的软件包体系选择 deb 或 rpm，再区分 x64 与 arm64。安装与日常配置可以围绕图形界面完成；不同桌面环境读取系统代理的方式可能不同，遇到浏览器可用、其他程序不可用时，应先确认应用的代理来源，而不是重复安装客户端。

启用 TUN 前还需检查运行权限与本机已有的网络服务。保留原有网络设置的记录，改动后分别测试域名解析、局域网访问与目标应用，便于出现问题时恢复。

前往下载 Linux 客户端 →
查看全部客户端 →查看三款客户端选型指南 →

首次配置，按三步完成

客户端安装只是起点。准备有效配置、设置流量入口、验证应用访问，三步依次进行。

步骤一 · 准备配置

导入订阅或分享链接

确认拿到的是订阅地址还是单节点分享链接。订阅地址添加到订阅分组后执行更新；分享链接使用剪贴板导入入口。导入完成后检查节点列表是否出现预期内容，并选中一个节点作为当前配置。

客户端本身不提供远端服务，安装成功也不等于已经具备连接条件。若更新结果为空，先核对复制是否完整、地址是否有效以及更新请求是否可达。不要把订阅凭据粘贴到公开讨论区，也不要为了测试随意导入来源不明的配置。

步骤二 · 接入流量

选择代理与路由模式

桌面端先使用自动配置系统代理，再选择适合用途的路由预设。安卓端启动连接并确认 VPN 授权；如已配置分应用规则，检查待测试的应用是否包含在接管范围内。普通连接未验证前，先保留 TUN 的默认状态。

系统代理控制应用是否把流量送入客户端，路由控制进入后的去向。两个设置应分别确认。需要临时使用全局路由诊断时，测试结束后记得恢复日常预设，避免把诊断状态误当成长期配置。

步骤三 · 验证访问

测试实际应用并读日志

先测试一个确实遵循代理设置的应用，再观察运行日志。节点出现在列表中、延迟测试有结果，都不能单独证明完整访问链路可用。访问失败时，记录问题发生在哪个应用、使用什么模式，以及日志中的错误类型。

一次只修改一个设置，再重复相同测试。这样可以判断故障来自配置、网络、路由还是应用接入。结束使用前，桌面端清除系统代理，安卓端停止连接；下次出现异常时，也可以先回到这一套最小配置进行对照。

查看完整教程 →连接异常的排查入口 →

Project V 与开源内核生态

客户端、内核、协议是三个层次。分清各自职责，才能理解下载、配置与更新之间的关系。

Project V、V2Fly 与 Xray 的关系

V2Ray 来自 Project V 代理工具生态，其设计把协议、传输与路由等能力组合起来。V2Fly 延续 V2Ray 相关项目的社区维护，Xray 则从相关代码基础发展出自己的功能路线。它们存在技术渊源，但不能简单视为同一个产品的不同名称。阅读教程时，应同时确认教程讨论的是哪个内核、哪种协议，以及客户端提供了哪些对应选项。

图形客户端位于这一层能力之上，负责保存订阅、整理节点、生成运行配置和展示日志。用户通常不需要从内核配置文件开始学习，可以先在图形界面完成一条可用链路，再逐步理解底层参数。反过来，客户端按钮名称相似，也不代表不同内核生成的配置完全一致；迁移或切换时仍需要重新验证。

三款客户端的开源定位

v2rayN 是桌面端的开源图形客户端，覆盖不同桌面系统，并提供订阅、代理和路由等管理入口。v2rayNG 面向安卓端，使用 Xray 生态；v2flyNG 同样面向安卓端，提供 V2Fly 路线。选择依据首先是平台与配置兼容性，其次才是界面习惯。只为处理一个具体问题而更换客户端前，应先确定问题是否真的来自内核能力差异。

开源意味着代码与相应许可条款可供研究，项目的使用、修改和分发需要遵循各自许可证。它不等于订阅服务也免费，更不意味着任意导入的配置都值得信任。客户端、内核与远端服务分别承担不同职责；保存配置、授权网络权限和分享日志时，仍要留意敏感信息与实际接管范围。

更新时分别检查三个来源

客户端更新改变界面、配置管理或平台适配，内核更新影响协议执行与网络行为，订阅更新则刷新远端提供的节点参数。三者不是同一个操作。订阅成功刷新后仍然无法连接，可能需要检查当前节点参数与内核兼容性；界面更新成功，也不会自动修复已经失效的订阅地址。

日常维护以保留可恢复配置为先。更新前备份重要分组与自定义规则，阅读相关变更说明，更新后用熟悉的节点与应用重复测试。遇到异常先查看日志，而不是连续更换多个设置。日志中的配置解析错误、域名解析失败和连接超时，对应的排查方向并不相同。

从术语到进阶配置

VMess、VLESS 等名称描述协议，不是客户端；TLS、传输方式与服务端参数也需要正确组合。只有名称相同，仍不足以判断节点能否使用。初学时按已有配置导入，理解每一项的作用后再进行手动调整。需要系统学习时，可沿着核心概念、客户端选择、安装、订阅、代理模式、路由、TUN 与日常维护的顺序阅读，避免把零散片段直接拼成配置。

理解 VMess 协议 →理解 VLESS 协议 →阅读新手到进阶手册 →

客户端配置与排查文章

围绕安装、后台运行与连接测试补充细节。按当前遇到的问题阅读，不必一次调整全部选项。

查看全部文章 →
V2Ray客户端下载