桌面客户端 · 中文配置参考

V2Ray for Macv2rayN 下载与配置

下载v2rayN 查看教程

从订阅导入到路由分流，按步骤设置开源客户端，区分系统代理、TUN 与内核配置。

永久免费 代码开源 Xray-core · sing-box

客户端操作

订阅、代理与路由
分别设置，逐项验证

图形客户端负责管理连接资料与运行状态，内核负责实际处理流量。导入成功、内核启动、应用使用代理，是三个不同的检查点。先让一条连接正常工作，再增加规则与接管范围，排查时更容易找到发生变化的环节。

订阅分组设置

分组名称个人订阅
订阅地址使用自己的订阅链接
更新订阅获取服务器配置
更新后检查活动服务器与协议

以上界面为操作结构示意。实际菜单名称随平台与构建变化，端口也可由用户调整。需要核对字段时，先确认客户端正在使用哪一种内核，再查对应配置结构；不要把图形界面的选项名称直接当作 JSON 字段复制。

阅读配置文件参考 →

安装包选择

按系统与处理器选择客户端

桌面端选择 v2rayN，安卓端优先查看 v2rayNG，v2flyNG 作为 V2Fly 内核方案的备选。系统名称相同并不代表安装包通用，下载前还要确认处理器架构和软件包格式。安装完成后，使用已有的服务器资料或订阅开始配置。

Windows

v2rayN · Desktop / WPF

提供新一代跨平台界面的桌面版与经典 WPF 版入口。初次安装可先阅读下载页的界面差异说明，再按运行环境选择；已有稳定配置的用户，更新前应备份订阅分组、自定义规则与相关设置。

将程序放在当前用户可写的目录，避免直接在压缩包中运行。若启动时出现运行环境提示，先根据提示处理依赖，不要把窗口未启动误判为服务器故障。系统代理生效后，仍需检查浏览器是否使用了独立代理扩展，以及本地监听端口是否被其他程序占用。

前往下载

macOS

v2rayN · Apple Silicon / Intel

在“关于本机”中查看芯片信息：Apple Silicon 对应 arm64，Intel 处理器对应 x64。按芯片选择安装包，比根据电脑外观或购买年份判断更准确。安装后从应用程序目录启动，并按系统提示处理应用打开权限。

菜单栏入口可用于切换系统代理与查看运行状态。需要 TUN 时，再核对当前构建的支持情况及权限要求；不要一开始就同时开启多个流量接管工具。若关闭主窗口后连接仍然有效，先检查菜单栏中的客户端是否继续运行，退出时再确认网络代理设置已恢复。

前往下载

Android

v2rayNG · v2flyNG

v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核。大多数较新的手机可选择 arm64；设备架构不明确时，可查看下载页的通用版入口。客户端名称相近，但内核能力与配置支持应分别确认，不能只按图标判断。

首次连接需要系统的 VpnService 授权。授权后再验证连接，后台容易中断时检查电池优化和厂商后台限制。分应用代理决定哪些应用进入接管范围，设置前先读清“选中应用”的含义，避免将放行与绕行理解反向。同一时间运行其他网络接管应用，也可能影响授权与实际流量路径。

前往下载

Linux

v2rayN · deb / rpm

先确认发行版使用的软件包体系，再区分 x64 与 arm64。deb 与 rpm 是不同的安装格式，不能仅修改扩展名互换使用。下载页按格式提供入口，适合通过图形软件管理器安装的桌面环境。

不同桌面环境对系统代理的读取方式存在差异，浏览器可用不代表所有程序都会跟随。初次运行先查看内核启动日志，再验证需要联网的具体应用。启用 TUN 前核对权限与网络管理方式，遇到冲突时先停用其他虚拟接口或同类接管程序，保留能够复现问题的最小配置，避免同时改动 DNS、路由和服务器。

前往下载

安装包入口与系统要求集中在下载页。更换客户端前保留原始订阅资料；客户端导出的运行配置可能包含自动生成字段，不宜直接迁移到另一种内核。

查看全部客户端 →

开源生态与配置边界

Project V、V2Fly 与 Xray

V2Ray 是生态与技术讨论中常用的名称，具体运行能力则由客户端、内核和配置共同决定。把这三层分开理解，有助于判断安装包、教程与协议参数是否适用于当前环境，也能减少“能导入却不能连接”的误判。

Project V 的模块化思路

Project V 以模块化网络代理工具为方向，V2Ray 是其中广为使用的实现。配置通过入站、出站、路由和 DNS 等部分组织行为：入站接受本地应用的连接，出站描述如何连接目标或代理服务器，路由负责选择出口。这种结构让协议和流量处理可以分别设置，也意味着一个完整连接往往涉及多个部分。排查时只检查服务器地址还不够，本地端口、传输参数与路由目标同样需要对应。

V2Fly 与 Xray 的关系

V2Fly 延续 V2Ray 的社区维护与实现演进，Xray 则从相关代码基础发展为独立演进的内核项目。两者有共同的技术背景，但后续功能与参数支持并不完全相同。看到 VMess、VLESS 或其他协议名称时，还应继续确认传输方式、安全设置和内核实现要求。不能因为配置外观接近，就认为任何字段都能在不同内核间直接复用。sing-box 也有自身的配置体系，应查对应语法，而不是把 Xray 的路由片段直接粘贴过去。

三款图形客户端的分工

v2rayN 面向桌面使用，提供服务器管理、订阅分组、系统代理与内核相关设置入口；v2rayNG 面向安卓环境，结合 Xray 内核与系统的网络服务接口处理连接；v2flyNG 则为需要 V2Fly 内核的安卓使用场景提供另一种选择。三款客户端均为开源软件，源代码可供社区审阅与协作。图形界面降低了手写配置的成本，但不能代替有效的服务器资料，也不会自动修正错误的认证信息或服务端传输设置。

开源协议与服务来源

开源协议描述代码的使用、修改与分发条件，不等同于代理服务的使用条款。客户端、内核以及打包依赖可能分别适用不同许可，涉及再分发时应阅读对应项目的许可文本与声明。客户端免费使用，也不表示其中的服务器连接资料由客户端项目提供。订阅服务的可用性、访问凭据与使用范围，应向资料提供方确认。公开分享配置前，需移除订阅地址、用户标识、密码和其他能够访问个人服务的信息。

客户端更新与内核更新

界面更新、内核更新和规则集更新解决的是不同问题。界面更新可能调整交互与配置生成方式；内核更新可能改变协议实现和参数约束；规则集更新则影响域名或地址的分类。更新前先记录可用配置，阅读变更说明，更新后用原有测试流程验证。遇到解析失败时，优先查看日志指出的字段与文件位置，不要一边升级、一边切换协议、一边替换路由。每次只改变一个变量，才能判断故障来自哪里。

从连接验证到分流验证

先确认内核能够启动，再检查本地监听，随后验证应用是否真正进入代理。网页能打开只是结果之一，不能单独说明所有应用或所有请求都采用了相同出口。建立基本连接后，再测试局域网访问、指定域名规则和 DNS 行为。延迟测试反映的是某一种探测路径，不代表完整业务连接一定成功。持续超时时，应按系统时间、端口、防火墙、认证及传输设置的顺序排查，而不是只根据一次测试结果删除全部服务器。

配置参考的阅读顺序

已经能连接的用户，可从 outbounds 的出站标签与 routing 的规则关系开始阅读；需要排查本地接入的用户，先看 inbounds 的监听地址、协议与端口；涉及域名解析时，再结合 dns 与路由的解析策略。policy 等策略项通常不是初次运行的必要修改项，只有明确需要时才调整。示例片段用于解释字段关系，合并前仍需对照当前内核的完整配置结构，并保留一份能恢复工作的原始设置。

教程与排查记录

最近更新的使用文章

按实际使用环节补充客户端说明。遇到后台断连、局域网共享或启动异常时，先找到对应症状，再沿文章中的检查顺序操作。涉及权限与防火墙的修改，应理解影响范围，并保留恢复原设置的方法。

查看全部文章 →
下载v2rayN