桌面与安卓 · 客户端操作笔记

V2Ray手机版客户端下载与配置

设置界面示意;具体菜单名称与位置随客户端构建有所调整。

V2Ray 客户端安装选择

先看操作系统,再看处理器架构。桌面与安卓的接管方式不同,订阅能够导入,也仍需分别完成本机设置。

Windows

v2rayN · 桌面版与经典 WPF 版

下载页提供桌面版与经典 WPF 版入口。桌面版采用新一代跨平台界面,经典 WPF 版保留熟悉的桌面操作方式。已有配置时,先记录订阅分组、路由与监听端口,再考虑更换界面分支;不同分支的菜单位置可能不同,不宜仅凭截图判断设置是否存在。

首次连接先使用系统代理,确认浏览器能够访问目标服务,再决定是否开启 Tun 模式。系统代理只影响读取这项设置的应用,不能据此推断整台电脑的流量都已经被接管。退出客户端前清除系统代理,可以减少本地端口关闭后留下的连接问题。

前往下载 →

macOS

v2rayN · 按芯片选择安装入口

系统菜单 → 关于本机,先确认显示的是芯片名称还是 Intel 处理器。Apple Silicon 与 Intel 对应不同安装入口,选对架构后再处理启动授权与网络权限。安装完成并不等于代理已经启用,还要检查当前网络服务是否采用了客户端设置的本地代理。

更换无线网络、连接有线网或恢复休眠后,若只有浏览器不能访问,先回看系统网络设置与客户端运行状态。不要同时修改节点、路由和 DNS;保留一个已知可用的配置,逐项恢复,才能分清问题发生在网络切换、权限还是代理接入环节。

前往下载 →

Android

v2rayNG 首推 · v2flyNG 备选

v2rayNG 使用 Xray 内核,适合先按常规安卓流程配置;需要 V2Fly 内核环境时,再考虑 v2flyNG。主流设备通常选择 arm64,拿不准时先查看系统信息和下载页的通用版说明。安装包架构与节点协议是两个不同维度,不能通过订阅里的协议名称判断手机架构。

首次使用 VPN 模式时,确认系统连接授权,再检查省电策略是否限制后台运行。安卓通常只允许一个此类 VPN 连接同时工作,若另一个网络工具正在占用连接,需要先处理冲突。分应用代理放在基础连接验证之后设置,避免一开始就把测试应用排除在代理范围之外。

前往下载 →

Linux

v2rayN · 按发行版与架构选择

先确认发行版使用 deb 还是 rpm 软件包,再选择 x64 或 arm64。桌面环境的代理设置与单个应用的代理设置可能各自独立:浏览器可用而其他程序不通时,优先检查程序是否读取桌面代理,而不是反复重新导入订阅。

Tun 模式还涉及权限、虚拟网卡和现有网络规则,不能把它当作所有连接问题的统一修复开关。建议先用普通代理方式建立可复现的连接,再按实际需要扩大接管范围。如果系统中已有其他代理或虚拟网络工具,记录原有设置后逐一停用对照,避免多个接管入口互相覆盖。

前往下载 →

三个客户端负责读取配置、启动内核并提供本机代理入口,服务器地址与访问凭据仍需由实际使用的服务提供。安装后先核对订阅来源,再继续配置。

查看全部客户端 →

v2rayN 与 v2rayNG 设置分组

按设置职责查找入口,不把“开启代理”和“选择路由”混为一步。下方窗口是操作位置示意,切换分组可查看对应说明。

订阅分组 → 添加或编辑订阅,先确认地址来自可信来源,再执行更新。分组用于把不同来源的配置分开管理,不会自动改变当前选中的连接。更新后检查是否出现协议解析错误,并重新确认活动配置。相比把所有配置混在同一列表,分组更方便定位哪一条订阅更新失败,也便于保留手动添加的配置。订阅地址常含访问凭据,分享截图时应遮盖完整地址;遇到更新失败,先检查地址是否失效,再判断是否需要通过现有代理更新。

验证顺序保持一致:先确认订阅内容能够解析,再确认内核正常启动,然后确认应用进入本地代理,最后检查路由结果。前一步没有成立,后一步的开关再多也难以说明问题。教程按这条顺序展开,故障文档则按无法上网、订阅失败、DNS 异常等症状反向定位。

阅读 v2rayN 配置教程 →

Project V、V2Fly 与 Xray

客户端名称、内核名称与协议名称分别指向不同层次。先分清各自职责,再判断一份配置能否使用。

客户端负责操作,内核负责连接

Project V 是理解 V2Ray 生态的起点。图形客户端把订阅、路由和本地代理选项整理成界面,内核则读取配置并处理实际网络连接。日常说的“安装 V2Ray”,往往实际指安装能够管理这些内核的客户端,而不是直接编辑内核配置。

V2Fly 延续 V2Ray 的社区开发,Xray 从相关技术基础上发展出自己的实现与功能演进。两者共享部分概念与配置习惯,但不能把名称相近理解为功能完全一致。特定传输、协议参数或扩展能力是否可用,应结合客户端实际调用的内核判断。

生态层次
操作界面

v2rayN · v2rayNG · v2flyNG

连接内核

Xray · V2Fly

配置内容

协议、传输、路由与 DNS

三款开源客户端的选择边界

v2rayN 面向桌面使用,重点是通过图形界面管理连接、订阅与路由。它的多内核使用方式意味着“界面能够添加某种配置”与“当前内核能够运行这份配置”需要分别确认。遇到启动失败,应查看具体错误中的字段与内核名称,而不是只比较客户端窗口长得是否一样。桌面上的代理监听地址也需要留意:本机使用与局域网共享是两种不同场景,开放范围越大,越需要同步检查防火墙和网络环境。

v2rayNG 是安卓上的开源图形客户端,使用 Xray 内核,通过系统提供的 VPN 接口或本地代理方式工作。v2flyNG 同样面向安卓,使用 V2Fly 内核,可作为需要该内核环境时的备选。两者界面和操作习惯存在相似处,但配置支持仍应以各自内核为准。已有可用配置时,不必只因为名称不同就迁移;需要切换时,先导出必要信息,并分别确认 VPN 授权、应用名单与后台运行限制。

开源协议与运行配置分开看

这些客户端以开源项目的方式开发,相关客户端项目采用 GPL 系列许可;V2Fly 与 Xray 内核项目采用 MPL 2.0 许可。客户端、内核及随包依赖的许可不应简单合并成一个标签,具体再分发义务需阅读对应组件的许可文本。对普通使用者而言,开源首先意味着代码与实现有公开讨论和审阅的基础,并不意味着每一条外部订阅都经过同样的审查。

订阅属于运行配置,可能同时包含服务器地址、用户标识、传输参数和访问凭据。软件的开源属性不能替代对配置来源的判断,也不能说明服务端如何处理数据。导入前确认来源,求助时只提供必要的错误信息,遮盖完整订阅地址和用户凭据;这比一次性贴出全部配置更有利于定位问题,也能避免把访问权限一并公开。

更新前先记录,更新后再验证

客户端更新、内核更新与路由资源更新是三个不同动作。界面更新可能调整菜单名称,内核更新可能改变配置支持,规则资源更新则会影响分流匹配。遇到行为变化时,先回顾实际改动了哪一层。把多项更新与多个开关修改叠在一起,往往会丢失可比较的基线,导致原本简单的问题变得难以复现。

更稳妥的顺序是记录活动配置、监听端口与自定义路由,阅读对应更新说明,再完成安装或替换。完成后检查订阅是否保留、内核能否启动、系统代理是否指向当前端口,并分别测试应当直连和应当代理的目标。如果需要保留退回方案,也要注意旧环境对新配置字段的支持情况;备份文件本身含有敏感信息,应存放在受控位置。

连接测试与实际访问一起判断

真连接测试能帮助排除部分不可用配置,但测试成功只说明测试目标在当时条件下能够完成连接。浏览器缓存、应用自己的代理设置、DNS 解析以及服务端策略,都可能让另一个目标表现不同。不要把单个测试结果当作整机代理状态,也不要把一次超时直接解释成客户端故障。

排查时保留最小场景:一个客户端、一份已确认的配置、一个明确的测试应用。先比较关闭代理时的基础网络,再比较开启后的变化;若只有某个应用异常,缩小到该应用的代理入口与分流结果。日志中出现错误时,记录发生动作和错误类别即可,避免为求完整而公开整份配置。按层检查通常比反复重装更接近问题本身。

连接前的常见问题

安装完成后,还需要准备什么?

需要有效的服务器配置或订阅地址。客户端提供配置管理和连接入口,不会在安装后自动生成可用的服务。先核对配置来源与协议支持,再按快速上手教程导入并验证。

系统代理和 Tun 模式需要同时开启吗?

不必把同时开启作为默认步骤。先用系统代理验证读取该设置的应用,再按其他应用的接管需要判断是否使用 Tun。两种方式各自涉及不同的网络层次,具体排查见故障排查文档。

安卓锁屏后断连,先查节点还是省电设置?

若亮屏时连接稳定、锁屏后反复中断,先检查客户端是否被限制后台运行,再对照网络切换情况。持续在前台也无法连接时,再检查配置与基础网络。更多说明见常见问题。

订阅导入成功,是否代表协议一定兼容?

不代表。导入只完成了解析和保存,实际启动时仍可能遇到内核不支持的参数、缺失字段或服务端不匹配。继续查看启动结果和连接日志,按故障排查流程逐项定位。

客户端配置笔记

从协议字段到局域网共享,补充那些不适合挤进首次连接流程的细节。需要动手修改时,先确认设置影响的是当前应用、本机还是整个局域网。

下载客户端