开源客户端指南

V2Ray安卓版 v2rayNG 设置指南

按系统选用开源客户端,再按设置路径完成订阅导入、VPN 授权与分应用代理。

  • VLESS
  • VMess
  • Trojan
  • REALITY

PLATFORM / CLIENT

按平台下载 V2Ray 客户端

先确定操作系统,再确认处理器架构和安装包格式。客户端负责读取配置和建立连接;安装完成后,还需要导入已有的订阅或单条配置。已有可用订阅时,换设备通常可以重新导入,不必逐个复制节点,但分应用名单、本机端口和路由规则要在新设备上重新检查。

Windows

选择 v2rayN 桌面版或经典 WPF 版。初次使用可从桌面版开始;如果手头的教程按经典界面标注菜单,可以选 WPF 版对照。换版前先备份配置,保留订阅分组和自定义规则,再退出旧程序,避免两个窗口同时修改系统代理。

macOS

在「关于本机」查看芯片或处理器。Apple 芯片用 arm64 安装包,Intel 处理器用 x64 安装包。迁移配置后,先检查客户端的系统代理开关;旧设备上的系统代理状态和其他应用的代理设置不会随订阅一起迁移。

Android

通常先选 v2rayNG;配置明确依赖 V2Fly 内核时,再选 v2flyNG。设备支持 64 位 ARM 应用就选 arm64,架构不明可先查看通用版。已有客户端时,先区分覆盖更新与切换应用:切换应用后通常要重新授权 VPN。

Linux

v2rayN 提供 deb 和 rpm 入口。先按发行版的包管理体系选格式,再按处理器选 x64 或 arm64。安装后先用客户端测试连接;不同桌面环境和应用对系统代理的读取方式不同,个别应用未走代理时先检查它的网络设置。

拿不准三个客户端的区别?先对比平台、内核与路由能力,或直接前往查看全部客户端 →

SETTINGS / ANDROID

v2rayNG 设置项与配置路径

先分清三层:系统 VPN 决定哪些流量能进入客户端,分应用代理决定哪些应用纳入或绕过,路由规则再决定已进入客户端的连接走哪条出站。比如,浏览器被排除后,修改域名规则不会让它重新进入 VPN;要让路由规则对浏览器生效,先检查分应用名单。以下路径用于定位设置,不是一套必须照搬的开关组合。

VpnService 全局接管

首次在 v2rayNG 主界面启动连接时,系统会弹出 VPN 连接请求。确认应用名称后点「确定」。与桌面系统代理不同,安卓通过 VpnService 把符合条件的流量交给客户端,应用不必自己填写代理地址。系统状态栏出现 VPN 标记,只表示本机通道已经建立,不代表远端节点可用。若另一款 VPN 正在运行,先到系统设置断开它,再回客户端发起连接。

主界面 → 启动连接 → 系统「VPN 连接请求」→ 确定

需要同时调整多组设置时,按配置进阶中的主题逐项验证。先保留基础连接,再改路由或 DNS;这样出现异常时,可以回退最近一次改动,而不用重建全部配置。

QUICKSTART / THREE STEPS

订阅导入、连接与验证

第一次使用时,先完成一次基础连接,再处理分应用代理、路由与后台运行。以下以 v2rayNG 为例;桌面端的导入顺序相近,但启动服务和启用系统代理是不同操作。遇到断线或个别应用不可用,按这三步倒查,可以区分配置没读入、系统没接管和远端连不通。

  1. 导入配置并选中节点

    有订阅地址时,打开「订阅分组设置」,新建分组、粘贴地址并保存。回到配置列表,执行「更新订阅」,然后进入对应分组,选中一个节点。若拿到的是单条配置链接,从列表的添加菜单按来源导入,不要把它当订阅地址填写。列表为空时先确认地址是否粘贴完整、当前网络能否访问订阅来源,以及所查看的分组是否正确。

    已有一份手工维护的配置时,先确认新条目导入到了独立分组。给分组取有辨识度的名称,便于区分新旧来源。如果同一名称重复出现,先看条目所属分组,不要仅凭显示名决定删除哪一项。

  2. 启动连接并处理系统授权

    确认选中的条目后,从主界面启动连接。首次出现「VPN 连接请求」时,确认请求来自刚打开的客户端,再在系统对话框授权。若系统正在使用另一款 VPN,先在系统设置中确认现有连接的用途,不要为了测试把工作配置的策略关掉。桌面端则可先启动客户端,再按需要启用系统代理;读取系统代理设置的应用才会受该开关影响。

    如果客户端一启动就退回未连接状态,先看系统是否允许建立 VPN、当前节点是否还存在,再查启动日志。此时批量换节点或同时改 DNS,通常只会让故障原因更难区分。

  3. 用实际请求验证连接

    在一个应被纳入代理范围的应用里,访问平时能打开的页面,再查看客户端日志。VPN 图标只说明系统通道已建立;客户端能测试到某个远端端口,也不意味着应用的域名解析和页面请求都正常。出现异常时,先分清是所有应用都失败,还是仅有一个应用或一类域名失败。

    如果只有单一应用失败,先查它是否被分应用名单排除,再核对应用自己的代理设置。如果所有应用都失败,先确认基础网络能访问,再用同一个节点分开测试无线网络和移动数据。每次只换一个条件,记下测试时间和日志中的报错类别,复测才有可比性。

PROJECT V / CORE LINEAGE

Project V 生态与开源客户端

客户端、内核和服务端配置是三个不同的层次。客户端提供导入、切换和系统集成;内核负责实际的协议、解析与转发;服务端配置决定连接两端应该使用哪些参数。换一个图形客户端不会自动改变节点的协议,也不会转换原有的服务端设置。

从 Project V 到独立演进的内核

Project V 生态围绕可组合的网络代理工具发展。V2Ray 在其中承担核心转发工作,配置把入站、出站和路由拆开,使本地接收流量的方式可以与远端连接的方式分别调整。V2Fly 社区延续了 V2Ray 的维护与开发;Xray 则从既有的 V2Ray 核心演进出来,按自己的节奏维护。两者共享一些配置概念,但由不同社区独立发布,不能把一个项目的更新说明用来判断另一个项目的行为。

排障时,这层区分很实用:按钮找不到,应先查图形客户端的界面说明;日志显示某个字段不认识,应对照内核支持情况;两端都能读取配置、连接却失败时,再核对服务端地址、传输和安全参数。

协议名不等于完整配置

开源生态中可以查阅协议说明和实现,进而解释同一种配置为什么在两个内核上的表现不同。VMess、VLESS 与 Trojan 的配置方式各有区别;REALITY 处理的是传输安全,不能当作与这些代理协议互换的选项。选型时先看已有配置要求的协议、传输和安全机制,再去确认客户端与内核能否一起处理这些字段。

迁移时要区分「链接可以导入」与「连接可以建立」。前者表示客户端至少能解析输入,后者还取决于内核行为、双方参数和当前网络。遇到不熟悉的字段,建议先从概念速查厘清它属于哪一层,再决定应该查客户端设置还是内核说明。

三款客户端的分工

v2rayN、v2rayNG 与 v2flyNG 都是开源图形客户端。v2rayN 面向桌面,提供订阅管理、本地代理和系统代理入口,支持的内核与模式取决于具体构建与配置。v2rayNG 在安卓端用 Xray 内核连接,借助系统 VpnService 处理接管范围。v2flyNG 是安卓端的 V2Fly 内核选项,适合需要对照 V2Fly 配置和行为的使用场景。

在两款安卓客户端之间切换前,建议核对配置来源与内核要求,然后记录分应用名单与路由偏好。这些设置属于本地客户端,单独保存订阅链接不能复原它们。同一设备上若两款都装着,切换时先断开正在用的 VPN,再启动另一款,便于确认到底是哪款应用在接管流量。

客户端、内核与订阅分别更新

客户端更新可能改变菜单位置或系统兼容性,内核更新可能新增字段或调整默认行为,订阅更新则从来源读取配置条目。三个动作彼此独立。某个节点在更新订阅后消失,应先检查来源返回的列表;如果是更新客户端后才报配置错误,则要先检查内核和出问题的字段,而不是盲目覆盖原有分组。

改动前记下当前可用配置的分组、连接模式和关键路由规则。更新后先用原本可用的配置发起一次连接,再试新功能。如果仍需进一步排查,记录失败发生在导入、启动还是请求阶段。整理日志时遮住账户标识、完整订阅地址和节点凭据,只保留有助于定位问题的报错信息。

FIELD NOTES

V2Ray 技术笔记

查看全部文章 →