开源客户端Project V

V2Ray中文版 客户端下载

按系统选择图形客户端,从订阅导入开始配置,遇到连接异常再按故障症状逐项检查。

V2Ray 客户端常用设置

看到节点只说明条目已导入。应用是否使用代理、内核能否与节点握手、请求是否按规则分流,分别由不同的设置决定。按症状切换下方刻度,先找到该查的那一层。

协议、传输与安全参数

节点导入正常却总是握手失败,先核对协议、传输方式和安全层是否与服务端一致。VMess、VLESS、Trojan 与 Shadowsocks 的参数不能互换,同一种协议也可能搭配不同传输方式。在支持多内核的桌面客户端里,打开节点编辑面板只读核对,再确认实际启用的内核。相比只提供单一协议的工具,多协议客户端方便集中管理,但切换内核不会自动改写已有参数;应只调整确认不一致的一项,再做一次真连接测试。

对应排查章节:无法上网 →
节点编辑 · 核对顺序
  • 协议类型
  • 传输协议(network)
  • 传输层安全(security)
  • 服务器名称(serverName)

按系统选择安装包

程序打不开时,先核对系统、处理器架构和包格式,不要先换节点。安装与连接是两个环节:至少能正常打开客户端、进入设置页之后,再导入配置排查网络。

Windows

选择 v2rayN 桌面版或经典 WPF 版。桌面版采用跨平台界面;已有操作习惯、正在对照旧版菜单的人,也可以查看 WPF 入口。先在系统信息中确认是否为 x64。

若发行包需要解压,先完整解压到有写权限的目录,再启动程序。遇到运行库提示,记下缺少的组件名称,按下载页说明补齐后再试。

前往下载

macOS

选择 v2rayN 的对应芯片包。在「关于本机」里查看芯片或处理器:Apple 芯片对应 arm64,Intel 处理器对应 x64。仅凭系统版本号无法判断架构。

从磁盘映像安装后,从「应用程序」重新启动客户端。若系统弹出提示,先区分架构不匹配、系统版本要求和权限提示,这几种情况的处理方式不同。

前往下载

Android

常用入口是基于 Xray 的 v2rayNG;已有明确的 V2Fly 配置需求时,再看 v2flyNG。先确认设备支持的应用架构;支持 arm64 选对应包,不确定时可查看通用包。

安装后先在前台完成首次 VPN 授权。如果连接只在切换网络或锁屏后中断,保留同一节点重测,再逐项检查其他 VPN 会话和后台电池限制。

前往下载

Linux

先看发行版使用哪种包格式:Debian、Ubuntu 系通常选 deb,Fedora 系通常选 rpm。再用系统信息判断 x64 或 arm64;包名中的体系架构不能互换。

该入口是图形客户端。能安装不代表当前桌面环境会接管所有应用的代理设置。配置后用浏览器建立对照,再检查实际出问题的程序是否继承桌面代理。

前往下载
查看全部客户端 →

订阅导入、连接与验证

首次配置只验证一条链路:用一台设备、一张网络、一个节点。记录每一步看到的结果,后续即使更换设备,也能复现成功条件或定位失败点。

  1. 导入订阅并确认节点入组

    在桌面 v2rayN 里新增订阅分组并保存链接,再手动更新该组;使用 v2rayNG 时,从订阅分组管理添加后也需要执行更新。节点列表出现条目后,核对条目属于刚才更新的分组,避免把旧节点误当成新订阅的结果。

    若节点数没有变化,查看更新时的提示。超时先查获取路径,提示格式不支持就核对订阅类型。订阅地址可能携带访问凭据,排障截图中应遮住完整地址。

  2. 选定节点并启用接入

    从刚导入的分组选一个与客户端内核兼容的节点,桌面端确认已选为活动配置,再启用系统代理;移动端启动连接并完成系统的 VPN 授权。首次测试先用默认规则,暂时不叠加自定义分流和 DNS。

    如果启动按钮很快回到未连接状态,先看日志中的首条错误。端口占用、配置不被识别和握手失败是不同问题;先处理启动错误,再做访问测试。

  3. 用同一应用核对请求路径

    在会读取系统代理的浏览器里发出新请求,记录连接前后的访问结果,必要时对照出口地址和客户端日志。节点延迟能测出,并不说明这个浏览器的请求走了同一条路径。

    若仅有一个网站失败,用同一浏览器另测一个预期走相同出站的目标,再检查规则命中和域名解析。若关闭代理也无法访问,先恢复基础网络,不要同时更换多个节点和规则。

查看完整教程 →

Project V、V2Fly 与 Xray 的关系

项目、内核、客户端和节点协议不是同一级名称。阅读教程或提交问题前,先确认说的是哪一层;特别是报错出现在启动阶段时,界面名称不能替代实际运行的内核名称。

项目脉络
Project V
内核家族
V2Fly / Xray
图形客户端
v2rayN / v2rayNG / v2flyNG
概念速查 →
  1. 从 Project V 理解模块化代理

    V2Ray 源于 Project V。它把接收请求的入站、负责转发的出站,以及决定请求去向的路由拆成独立配置。入站负责把浏览器或其他应用的请求交给内核;路由按条件挑选出站;出站才负责直连、代理或其他处理。

    这三个位置也对应三类常见现象:内核没有收到连接,先看本地接入;连接进入内核但走错出口,查路由顺序;请求已到预期出站却失败,再核对服务端参数和网络可达性。把问题分到这三层,比单凭「网页打不开」判断原因更准确。

  2. V2Fly 与 Xray 都有各自的兼容范围

    V2Fly 社区延续 V2Ray 核心项目;Xray 从这一代码脉络派生后独立演进,两者由各自的社区维护。常见配置概念有重叠,但支持的传输方式、安全层和字段可能不同。标着同一种协议,不代表两边接受同一套完整参数。

    遇到「条目能导入,内核却无法启动」时,先看日志指到哪个字段,再判断是该内核未实现这个选项,还是客户端生成配置时该项缺失。切换内核前记下原选择;复测时保留同一节点和网络,才好判断差异来自哪一层。

  3. 协议的公开实现不等于参数通用

    VMess、VLESS、Trojan 与 Shadowsocks 都可以在开源代理生态中找到实现。协议规定两端如何交换数据,传输方式和安全层则决定这些数据如何承载、如何保护。以 VLESS 为例,不能从协议名本身推断连接已经配置了 TLS,也不能把 TLS 和传输方式当成同一项。

    读共享条目时先看协议,再看传输与安全层,把它们按各自字段与服务端设置逐项比对。若只从另一份教程抄一个参数,可能把两端原本相同的设置改成不一致。协议公开便于对照实现和排障,但不代表某份订阅或第三方服务属于客户端项目。

  4. 三个开源客户端分别负责图形配置

    v2rayN 是桌面图形客户端,提供节点、订阅与路由管理,可按配置选用相应内核。v2rayNG 以 Xray 为核心,提供移动端订阅和 VPN 接入;v2flyNG 以 V2Fly 为核心,适合需要确认 V2Fly 兼容性的移动端配置。三者是开源客户端,界面负责组织配置,真正建立连接的是底层内核。

    订阅服务与客户端也是两件事。安装客户端不会自动获得节点,客户端能打开也不代表订阅仍有效。远端返回错误、条目过期、应用缺少权限,分别要查订阅来源、节点配置和设备设置。先认清报错来自哪一方,再决定该查教程的哪一段。

  5. 软件、内核和订阅有不同的更新周期

    客户端更新可能调整界面、系统支持或打包方式;内核发行可能增加字段、修复连接行为;订阅刷新只同步来源所提供的节点列表。订阅更新成功不能代替软件升级,重新安装客户端也不能让失效的订阅重新可用。

    升级前备份自定义路由与配置,记下当前内核和正常使用的接入模式。升级后先验证原节点,再逐项恢复可选配置。如果出现回归,记录发生时间、平台与架构、所选内核、可复现的步骤和脱敏日志,比只提供一张连不上网的截图更容易定位。

订阅、连接与代理模式专题

先按故障发生的位置选文章:更新订阅失败,查获取与解析;节点已经出现但首次连接失败,查节点和出口;只有部分应用表现不同,再区分系统代理和路由。

查看全部文章 →