桌面首推 v2rayN · Xray / sing-box

V2Ray Mac客户端 v2rayN 下载与配置

下载v2rayN 查看教程

按系统选择客户端，从订阅导入到系统代理，再到TUN 模式。

免费开源 中文配置指南 订阅与路由管理

订阅、系统代理与路由设置

先区分配置层次，再决定需要改哪一项。下方是只读界面示意。

查看完整文档 →

v2rayN 是管理配置的图形界面，内核负责建立连接与执行规则。订阅把节点资料交给客户端，系统代理决定哪些应用会把请求交给本地代理，路由则决定这些请求最终直连还是经过远端节点。三者处在不同环节：更新订阅不会自动修复系统代理，切换路由也不会让所有程序开始遵循系统网络设置。

初次使用时，建议只导入一个订阅分组、选择一个节点，再开启系统代理验证浏览器访问。这个顺序便于观察每次修改的影响。若同时打开 TUN、改写 DNS、添加自定义规则，连接异常时就很难确定原因。各平台的界面文字可能略有差别，具体入口以安装的客户端为准。

v2rayN · 配置项目说明

订阅分组与更新

订阅地址是一份可更新的节点清单，不是客户端安装包。进入订阅分组设置，填写备注与地址，保存后更新当前分组，再回到服务器列表选择节点。按用途分组，可以减少个人配置与订阅配置混在一起的情况。v2rayN 与 v2rayNG 都有订阅入口，但对原生配置的识别方式不同，导入前应确认格式。更新失败时先看请求错误与地址有效性，不要反复删除本地分组；订阅地址可能包含访问凭据，也不应贴到公开页面。

启用订阅更新
分组操作更新当前订阅
导入来源订阅地址 / 分享链接
了解订阅格式 →

按系统选择 V2Ray 客户端

桌面选 v2rayN；Android 优先了解 v2rayNG，再按内核需求考虑 v2flyNG。

查看全部客户端 →

Windows

 桌面首推

v2rayN 提供 Desktop 桌面版与经典 WPF 版。Desktop 使用跨平台界面，WPF 保留经典桌面操作方式。选择时先看系统与运行环境要求，不必为同一订阅同时安装两套客户端。

安装后先确认客户端能够启动、内核能够运行，再导入订阅。若启动即退出，应先查看运行库与权限提示，而不是修改节点参数。已有配置需要迁移时，先备份订阅地址和自定义路由，再进行替换。

前往下载

macOS

 v2rayN

Mac 先在“关于本机”查看芯片信息。Apple Silicon 对应 arm64，Intel 处理器对应 x64。下载安装后按系统提示完成首次打开，再配置订阅和系统代理；遇到拦截应先核对来源与系统提示。

日常浏览可先用自动配置系统代理。终端工具若没有随之使用代理，需要单独检查工具的网络设置。只有明确需要覆盖更多应用时，再了解 TUN 的授权、DNS 与路由行为，不必一开始就开启所有功能。

前往下载

Android

 v2rayNG / v2flyNG

v2rayNG 采用 Xray 内核，适合需要相应协议与传输功能的配置；v2flyNG 采用 V2Fly 内核，可作为匹配该内核需求的备选。常见手机通常选择 arm64，不确定处理器架构时再查看通用安装包说明。

导入订阅后更新分组，选中节点并确认系统连接授权。后台运行受电池管理影响，连接一段时间后中断时，应同时检查省电策略与网络切换情况。两款客户端不宜同时启动连接，避免争用系统网络通道。

前往下载

Linux

 v2rayN

根据发行版选择 deb 或 rpm，再区分 x64 与 arm64。包格式对应系统的软件管理方式，处理器架构对应运行平台，两者需要同时匹配。桌面图形环境、依赖和权限要求应在安装前一并确认。

Linux 桌面环境对系统代理的处理方式并不完全一致。若浏览器可连接而其他程序仍直连，应先检查应用是否读取桌面代理设置。需要 TUN 时再处理虚拟接口与权限，不要把网络管理器的配置问题误判为订阅失效。

前往下载

v2rayN 连接前的三步配置

先完成一条可验证的连接，再增加路由规则或 TUN 设置。

查看完整教程 →
步骤一 · 准备配置

导入并更新订阅

客户端本身不提供可连接的远端节点。准备合法可用的订阅地址或分享链接，在订阅分组设置中保存后执行更新。若只有一条链接，可以通过客户端支持的剪贴板导入入口添加；不要把网页地址当作订阅地址。

更新完成后查看服务器列表是否出现预期节点。列表为空时，先核对订阅格式、有效期与更新日志。地址包含的查询参数可能用于身份验证，复制时要完整保留，分享截图时则应遮挡这些内容。

步骤二 · 选择出口

选节点，配置系统代理

从列表选中节点并设为当前使用项，确认内核启动成功。桌面端再选择自动配置系统代理，路由先使用与当前用途相符的预设。Android 则按客户端流程启动连接，并确认系统弹出的网络连接授权。

路由中的直连与代理是出口策略，不是节点是否在线的证明。初次验证时保留简单设置；如果另一个网络工具正在运行，应先停止其中一个，再观察连接结果，避免多层代理影响判断。

步骤三 · 验证范围

检查应用与连接日志

使用一个明确遵循系统代理的应用访问目标服务，再查看客户端日志是否出现对应连接。能打开客户端界面，并不代表请求已经进入内核；能够连通某个网站，也不代表所有应用都采用相同路径。

如出现异常，按订阅、节点、内核、系统代理、DNS 的顺序逐项检查。每次只改一项并记录结果。确认普通连接稳定后，再配置 TUN、局域网访问或更细的规则，后续回退也更容易。

保存配置时，建议同时记录节点来源、所用内核和自定义规则的用途。订阅更新通常会调整分组中的节点条目，手动修改的内容未必会保留；确实需要长期维护的配置，可在了解客户端行为后单独管理。离开当前网络或结束测试后，检查系统代理是否已恢复，尤其是准备退出客户端时。

首次连接失败不宜直接重装。先看错误属于订阅请求、内核启动还是远端握手，再到对应章节排查。日志中若包含订阅地址、节点域名或身份字段，应先处理敏感内容再用于交流。具体操作路径见使用文档，按平台展开的安装与权限说明见完整文档。

Project V、V2Fly 与 Xray

分清生态、内核与客户端，才能判断一份配置应交给哪个程序。

查看客户端对比 →
Project V · 代理工具生态
V2FlyXraysing-box · 独立内核项目
v2rayN · 桌面配置界面v2rayNG · Android / Xrayv2flyNG · Android / V2Fly

生态名称与协议名称不是一回事

Project V 是一组代理相关工具与组件的生态背景，V2Ray 是其中广为使用的名称。后续社区发展出不同的内核与客户端项目，因此搜索“V2Ray 客户端”时，往往会同时看到 V2Fly、Xray、v2rayN 等名字。它们不处在同一层：协议描述通信方式，内核实现协议与路由，图形客户端则帮助用户管理订阅、选项与运行状态。

V2Fly、Xray 与 sing-box 的边界

V2Fly 延续 V2Ray 的社区开发，Xray 从相关技术基础发展出自己的协议实现与功能演进，sing-box 则是另一个独立的代理内核项目。三者存在部分功能重叠，但原生配置结构和功能支持并不完全相同。看到 VMess、VLESS 或 Trojan 名称相同，也要继续核对传输层、安全参数与客户端生成配置的方式，不能仅凭名称认定整份配置通用。

三款开源客户端的分工

v2rayN、v2rayNG 与 v2flyNG 都以开源方式提供客户端代码。v2rayN 面向桌面，着重把订阅、系统代理、路由与内核运行集中到一个界面；v2rayNG 面向 Android，使用 Xray 内核；v2flyNG 则围绕 V2Fly 内核提供另一种选择。开源说明代码具有可查看和按许可使用的条件，不意味着所有项目共享同一套许可，具体条款需要分别阅读。

客户端更新与订阅更新分别进行

更新客户端解决的是界面、适配和程序功能问题，更新内核关系到协议实现与运行行为，更新订阅则刷新远端节点资料。规则数据库还可能有独立更新入口。升级前记录当前设置并保留配置备份，升级后先验证原有连接，再尝试新增功能。遇到兼容问题时，应同时记录客户端、内核与节点参数，而不是只描述“V2Ray 不能用”。

选择客户端时，先看设备平台，再看节点需要的协议与内核，最后确认操作方式是否适合当前用途。Mac 用户通常可以从 v2rayN 的订阅与系统代理功能开始；移动设备则通过 Android 客户端管理连接。这里的下载与文档用于说明工具配置，不提供订阅服务，也不代替订阅提供方对账户、流量与节点可用性的说明。

REALITY、Vision、DNS 和 GeoSite 等名词应放回各自的技术层次理解。REALITY 属于连接安全相关配置，Vision 是相关流控机制，DNS 影响名称解析，GeoSite 用于域名集合匹配。修改其中一项，不会自动修复其他环节的问题。先保留能够工作的基础配置，再通过日志和对照测试逐项扩展，通常比一次性复制一整套陌生配置更便于维护。

V2Ray 配置专题

从系统代理到规则数据库，按实际遇到的问题继续阅读。

查看全部文章 →