开源客户端与配置指南

V2Fly官网v2rayN 客户端

按系统选择开源客户端,从导入订阅开始,再设置路由分流并验证连接。

协议
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks

按设备选择安装包

桌面设备用 v2rayN,手机和平板可在 v2rayNG 与 v2flyNG 之间选择。先确定操作系统,再核对处理器架构;同一客户端在不同系统上的安装方式不通用。换设备时,保留原订阅地址即可重新导入,不必把旧设备的端口、代理模式和规则照搬过去。

Windows

安装 v2rayN 时,在桌面版和经典 WPF 版之间选择。桌面版采用跨平台界面;从旧教程找菜单时,先核对截图对应的是哪个界面,再找订阅分组与系统代理入口。

从便携目录迁移前先退出正在运行的实例,备份配置,并记录原先的本地监听端口。若新旧实例同时运行,第二个实例可能无法绑定同一端口;换版本前先排除这种冲突。

前往下载

macOS

打开「关于本机」确认芯片,再选对应的 v2rayN 安装包:显示 Apple 芯片选 Apple Silicon,显示 Intel 处理器选 Intel。安装后从应用程序目录启动,避免一直在磁盘映像内运行。

浏览器未跟随客户端时,核对当前网络服务的代理设置,并检查浏览器是否自带代理配置。退出客户端后若访问异常,先恢复原有网络设置,再重试同一个页面。

前往下载

Android

优先查看采用 Xray 内核的 v2rayNG;配置明确要求 v2fly 内核时,再看 v2flyNG。多数近年的手机适合 arm64 包;设备架构不确定时,可查看通用包与系统要求。

第一次连接时留意系统弹出的 VPN 授权提示。同一用户环境下,已有 VPN 应用可能与新连接互相替换。若只是息屏后掉线,先排查后台运行和电池优化,再判断是否要更换配置。

前往下载

Linux

按发行版选择 v2rayN 的包格式。Debian、Ubuntu 系通常选 deb,Fedora 等系统通常选 rpm。包格式和架构要分别核对:同一种格式也可能有 x64 与 arm64 两种入口。

安装完成不等于所有应用都会读取桌面代理。图形应用和从终端启动的工具可能各有设置;若只有一个程序不通,优先查该程序的代理入口,不要一开始就重装客户端。

前往下载

v2rayN 配置项

订阅负责更新配置列表,路由决定请求走哪条路径,系统代理和 TUN 决定哪些请求会进入客户端。把这几件事分开检查,比同时改多个设置更容易找到问题。

给每个订阅来源单独建立分组,用能识别来源的别名保存。粘贴地址后先手动更新当前分组,确认列表确实写入,再决定是否启用定时更新。相比把链接逐条导入,分组更新更容易核对是哪个来源发生变化,但更新成功只说明客户端读到了配置,并不代表列表里的每项都能连接。若列表为空,先确认当前选择的分组,再检查订阅地址是否过期、返回内容是否能被客户端识别。分享截图时遮住完整地址。

Project V、内核与客户端

配置说明里经常把客户端、内核和协议简称为 V2Ray。排查时把这三层分开:界面负责管理设置,内核负责解析设置与建立连接,协议定义通信双方如何交换数据。先找出是哪一层出了问题,再决定改什么。

对比三款客户端 →

Project V 与 V2Fly

Project V 是理解这个生态的起点,V2Ray 是其中用于处理代理连接和路由的核心程序。V2Fly 社区延续了相关核心与文档的维护,桌面和移动图形客户端则由各自的项目维护。读到针对核心的说明时,不必在图形界面逐字寻找同名字段:同一项配置可能在客户端中被放进订阅、路由或传输设置,也可能根本没有单独的控件。

判断文档适不适用,先看它描述的是图形界面还是核心配置,再看操作系统和核心家族是否一致。比如,核心文档里提到的入站端口,是客户端在本机接收请求的入口,不是订阅配置里远端服务的端口。这两处填错,表面上都可能表现为打不开网页,日志位置却不一样。前者应先查本地监听,后者要回到连接参数核对。

V2Fly 与 Xray 的兼容边界

Xray 源自 V2Ray 生态,之后沿自己的方向维护。两类核心有共同支持的协议和配置概念,也有各自实现的传输和安全特性。仅看配置名称无法判断兼容性:都写着同一种协议,两条配置仍可能使用不同传输,或需要不同的安全层字段。优先保留订阅里下发的原参数,按提供方注明的组合选择核心,不要拿另一条连接的参数拼起来。

如果更换内核后应用还没开始联网,检查启动日志里最先出现的异常。字段不识别通常是兼容问题,本地地址无法绑定则优先查端口占用。只有在确认核心已正常启动、请求确实经过它以后,才继续排查远端连接和握手。这样可以避免把三个不同阶段的故障都归到订阅失效上。

协议名与实际连接条件

开源客户端和内核让配置字段及协议实现可以公开查阅。VMess、VLESS、Trojan 和 Shadowsocks 是协议名称,不是可以在任意配置上互换的选项。能不能连接,取决于通信两端对协议、传输方式及所需安全参数是否达成一致。尤其不要把 VLESS 这个名字当成加密方式:实际使用的安全层需要结合具体配置判断。

首次连接时,使用配置提供方给出的原始组合做基线。若出现握手错误,先确认地址、端口、传输以及安全参数,再核对设备时间。切换协议需要对端也提供相应配置;客户端单方面改一个选项,并不能把原连接转换成另一种协议。想了解哪种组合适合现有设备,先比较核心支持范围,再考虑网络与设备条件。

三款开源客户端的分工

v2rayN 把桌面端的订阅、路由和代理设置集中在图形界面。v2rayNG 是以 Xray 为主的移动端客户端,用系统 VPN 接口接入流量;v2flyNG 则给明确使用 v2fly 内核的配置提供另一个开源图形入口。用哪款客户端,先看设备能运行哪一款,再看手头这份配置的内核要求,不必因为图标相近或名称相似而混装。

跨设备使用同一订阅时,建议重新导入,再按平台检查代理接入方式。桌面的系统代理设置不会随着订阅转移到手机,手机的 VPN 授权和分应用设置也不会带到桌面。如果两个设备只有一个能连接,先在两边选择同一条配置,并对照当前核心和网络环境;不要仅凭分组的名称相同就认定两端正在用同一条连接。

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

界面发布、核心更新和订阅刷新是三件不同的事。界面更新可能改变菜单位置或安装要求;核心更新可能改变可识别的字段;刷新订阅则是从原地址重新读取配置列表。更换安装包前,先备份分组、路由与额外设置。更新后每次只验证一项变化:先确认程序能启动,再用一条已知可用的配置测试,最后恢复自定义分流。

如果问题紧接在更新之后出现,记下改动时间、所在平台和出现异常的操作,再收集相关日志。截取日志时保留第一条报错和附近几行,去掉订阅地址、身份参数以及不准备公开的目标地址。若只有一个订阅分组受影响,先检查该组的更新结果,不需要为此删除其他已能使用的分组。查看帮助中心 →

技术笔记

选型、排错和安装各有不同的检查顺序。如果连接已建立但个别应用异常,先读日志;如果还没装好客户端,从首次安装清单开始。只有确认配置和客户端都支持一组协议参数后,再比较协议选择。

选型建议

VMess、VLESS、Trojan、Shadowsocks 区别对比与使用场景选型

从加密方式、握手开销、传输层搭配与客户端兼容性四个维度横向对比四种代理协议,按日常浏览、移动网络、低配设备等场景给出选型建议。

阅读重点:先从可用的客户端与服务端组合缩小范围,再看网络变化时的连接表现。

故障排查

V2Ray 运行日志怎么看:常见报错含义与逐项定位方法

教你打开客户端日志、调整日志级别,并逐条解读握手失败、连接超时、端口占用、时间不同步等典型报错,配一套由近及远的定位顺序。

阅读重点:按时间找到第一次失败,区分启动、解析和握手阶段,不只看最后一行报错。

入门指南

v2rayN 首次安装设置清单:Windows 与 macOS 通用步骤和常见坑

解压目录、运行环境、核心类型选择、本地端口、系统代理与首次导入订阅,按顺序列出 v2rayN 初次上手的必改设置,附新手最常踩的几个坑。

阅读重点:第一次先打通一条连接,确认实际使用的端口与代理模式,再加入自定义规则。