跳到正文
桌面客户端配置手册从安装到分流

V2Ray Mac客户端 v2rayN macOS 下载与配置

下载v2rayN 查看教程

按芯片选择安装包，完成订阅导入、系统代理与路由分流，再逐项调整 DNS 和 TUN。

PROTOCOLS VMessVLESSTrojanShadowsocks
DESKTOPv2rayN桌面配置入口
ANDROIDv2rayNG / v2flyNG按内核需求选择
CORE FAMILYXray · V2Fly协议能力以所选内核为准

客户端下载

按系统与芯片选择安装包

查看全部客户端 →

桌面端从 v2rayN 开始，安卓端优先查看 v2rayNG。先确认操作系统，再确认处理器架构；安装包名称中的 arm64 与 x64 不能只凭电脑外观判断。下载页集中列出各平台入口，版本信息也在对应客户端卡片中查看。

Windows

v2rayN · Desktop / WPF

桌面版采用跨平台界面，WPF 版保留经典操作布局。已有配置的用户先备份，再按使用习惯选择；首次安装先看下载页的系统要求，不要把两个版本同时设为系统代理。

前往下载 Windows 客户端→

macOS

v2rayN · Apple 芯片 / Intel

打开苹果菜单中的“关于本机”。显示 Apple 芯片时选择 arm64，显示 Intel 处理器时选择 x64。下载磁盘映像后，将应用放入“应用程序”再打开，避免一直从挂载的映像内运行。

首次启动如遇系统安全提示，先核对来源与应用名称，再到“隐私与安全性”查看对应提示。先用系统代理验证浏览器访问，确认订阅和节点参数正确后，再考虑启用需要额外权限的 TUN。

前往下载 macOS 客户端→

Android

v2rayNG · v2flyNG

主流手机先查看 arm64 包，架构不确定时可查看通用包。v2rayNG 使用 Xray 内核，v2flyNG 作为 V2Fly 内核备选。连接前阅读系统 VPN 授权提示，并留意省电设置对后台运行的限制。

前往下载 Android 客户端→

Linux

v2rayN · deb / rpm

按发行版的软件包体系选择 deb 或 rpm，再核对 x64 与 arm64。桌面环境是否读取系统代理会影响应用接管范围；安装成功后仍需检查代理设置、本地监听端口与应用自身的网络选项。

前往下载 Linux 客户端→

客户端用于管理本地配置，不附带可用订阅。安装前准备有权使用的订阅地址或完整节点参数，并妥善保存来源说明。订阅链接通常包含访问凭据，不要粘贴到公开评论或截图中。

v2rayN 设置索引

系统代理、分流与订阅管理

把“流量如何进入客户端”与“进入后走哪条线路”分开理解。系统代理和 TUN 负责接管，路由规则负责选择出站，DNS 影响域名解析结果。按下面的设置顺序逐项确认，比同时打开所有开关更容易定位问题。

系统代理：先让浏览器接入

系统代理把遵循系统网络设置的应用交给客户端本地端口。导入订阅并选择节点后，在状态栏选“自动配置系统代理”，再打开浏览器验证。“清除系统代理”用于恢复系统代理设置；“不改变系统代理”只是不主动修改现状，并不表示已有代理已经关闭。相比逐个应用填写端口，系统代理便于桌面端开始使用，但不会自动覆盖所有程序。遇到某个应用仍直连，先检查它是否读取系统代理，再决定单独配置或使用 TUN。

  • 检查客户端内核已启动，本地端口没有被占用。
  • 退出前先清除系统代理，避免留下不可达的本地入口。
  • 浏览器代理扩展可能覆盖系统设置，排查时先停用冲突项。

系统代理 · 状态栏选项

清除系统代理
自动配置系统代理
不改变系统代理

界面中的名称可能随客户端更新调整。遇到名称不同，先按“系统代理、路由、订阅、内核”四类功能寻找对应入口，不要直接套用其他平台截图中的按钮位置。窗口示意只说明设置关系，不代表安装后会自动获得可用配置。

查看全平台安装与配置指南 →

快速上手

从订阅导入到连接验证

查看完整教程 →

第一次配置先走最短路径：准备订阅、选定节点、启用系统代理并验证浏览器。基础连接可用后再加入自定义规则和 TUN。这样既能建立可复现的起点，也能在后续调整失败时回到已知可用的状态。

  1. 01 / IMPORT

    导入订阅并更新列表

    在“订阅分组”中新建分组，填写容易辨认的别名与完整订阅地址，保存后执行更新。检查列表是否出现配置，再选中一个节点作为活动配置。已有分享链接时使用客户端对应的导入入口，不要把分享链接误填进订阅地址栏。

    如果列表仍为空，先看更新反馈：地址失效、返回内容不兼容、连接超时分别需要不同处理。确认电脑时间正确，复制链接时没有混入引号、空格或聊天软件换行。无法访问来源时再比较直连更新和通过代理更新的路径，避免反复删除整个分组。

  2. 02 / ROUTE

    启用系统代理与基础路由

    选定节点后确认内核启动，再把系统代理设为“自动配置系统代理”。路由先使用适合当前访问需求的预设；不确定规则是否影响访问时，可以临时切换全局进行对照。注意全局路由不等于所有应用都被接管，应用仍需进入客户端的流量入口。

    这一阶段先保持 TUN 关闭，减少权限、虚拟网卡和其他 VPN 带来的变量。若有浏览器代理扩展，先停用或确认它与系统代理指向一致。工作网络存在专用代理时，先记录原设置，避免覆盖后无法恢复。安卓端则按系统提示确认 VPN 连接授权。

  3. 03 / VERIFY

    验证访问并保存可用配置

    打开浏览器访问需要验证的目标，同时查看客户端日志。测试应包含一个预期直连的目标与一个预期走代理的目标，观察规则是否符合设定。单次连通性测试或延迟结果只代表测试目标的情况，不能代替实际网页、登录与应用功能的检查。

    已连接却打不开网页时，依次确认系统代理、本地监听端口、路由与 DNS，不要立即重装。若只在某个应用失败，再检查该应用的独立代理设置。验证成功后保存配置；退出前清除系统代理，断开相关接管。完整操作与恢复步骤可继续阅读快速上手教程。

Project V 生态

客户端、内核与协议的分工

Project V 是理解 V2Ray 技术生态的起点。图形客户端将订阅、节点和规则整理成可操作的界面；内核读取配置并执行连接；VMess、VLESS、Trojan、Shadowsocks 等协议描述不同的通信方式。这三层各自承担不同工作，因此“安装了 V2Ray 客户端”并不能直接说明某项协议特性一定可用，还需要核对内核、传输方式与服务端参数。

V2Fly 社区延续 V2Ray 相关项目的维护，Xray 从相关技术基础发展出自己的内核功能与配置体系。两者共享一部分技术术语，但功能演进并不完全一致。阅读教程时应先确认文章针对哪个内核，再对照当前客户端界面。尤其是 DNS、路由以及传输安全参数，名称相近不代表可以原样复制；未知字段或不支持的组合可能让内核在启动阶段直接报错。

v2rayN：桌面图形入口

v2rayN 是开源桌面客户端，采用 GPL-3.0 许可证，提供配置管理与多内核使用入口。桌面操作的重点是区分窗口状态、内核运行状态和系统代理状态。主窗口能打开，不代表内核已经成功加载配置；选择了节点，也不代表系统代理已经指向本地监听端口。

从一台电脑迁移到另一台时，订阅和路由可以作为配置资料保存，但应用路径、权限与平台网络设置需要重新确认。先运行基础配置，再恢复自定义规则，通常比一次性搬入全部设置更容易查错。

v2rayNG：安卓与 Xray

v2rayNG 是采用 GPL-3.0 许可证的开源安卓客户端，使用 Xray 内核。安卓端通过系统 VPN 接口接管应用流量，操作方式与桌面系统代理不同。连接授权、后台限制、分应用设置以及其他 VPN 的占用，都可能影响实际使用。

同一份订阅在桌面可用、手机失败时，应先核对手机时间、当前网络和内核支持情况，再检查传输参数。不要仅凭客户端名称相似，就假定不同设备具有完全一致的协议能力与默认设置。

v2flyNG：V2Fly 内核备选

v2flyNG 是开源安卓客户端，采用 GPL-3.0 许可证，以 V2Fly 内核提供另一条配置选择。它适合需要对照 V2Fly 行为或使用对应配置的场景。选择备选客户端的依据应是协议兼容性和配置需求，而不是同时安装后反复切换连接。

比较结果时使用同一网络与同一组参数，并确认只有一个 VPN 连接在运行。不同客户端可能对订阅格式做不同转换；导入成功后，仍要检查节点详情是否保留了服务端要求的关键字段。

开源许可证与日常更新

开源许可证明确代码的使用、分发与修改条件，具体适用范围以各项目和所含组件的许可证为准。客户端、内核及附带组件可能分别采用不同许可证；开源不等于可以忽略授权条件，也不表示第三方订阅服务由客户端项目提供。本站整理下载与配置资料，客户端项目、订阅来源和目标网站各自承担不同角色。

更新也应分层处理：更新客户端调整界面和配置管理逻辑，更新内核可能改变协议能力，更新订阅则刷新来源中的节点信息，路由资源更新会影响规则匹配。出现问题时先记录改动的是哪一层，保留可用备份，再进行有针对性的恢复。不要把“更新订阅”当作升级客户端，也不要为了修复单个节点而同时替换全部组件。

跨平台操作可继续阅读全平台指南，按下载、安装、导入与验证的顺序完成配置。排查过程中保留错误类型与发生步骤即可；公开求助前移除订阅地址、认证信息和节点中的私人参数，避免把可复用的访问凭据一并分享。

配置与排查笔记

连接失败、网页访问与订阅更新

查看全部文章 →

先按现象选择文章。节点超时重点检查连接参数与日志；浏览器打不开网页重点检查流量入口和解析；订阅更新失败则先检查来源与请求路径。把三类问题拆开处理，避免在错误的设置层反复尝试。

V2Ray客户端下载