客户端下载 · 配置参考

V2Ray中文教程网 v2rayN 客户端下载与协议配置

围绕订阅导入、路由分流与协议选型,说明客户端设置和内核支持的对应关系。

v2rayN 配置功能订阅、分流与连接模式

查看配置教程 →

客户端配置可以分成三层:订阅和节点决定连接到哪里,系统代理或 TUN 模式决定哪些应用进入客户端,路由与 DNS 决定进入后的流量如何处理。安装完成并不等于连接已经生效。先导入可用配置、选中节点,再设置流量入口,最后查看日志和实际访问结果,排查时就能定位到具体环节。

下方面板展示设置项的结构示意,字段名称可能随客户端界面调整,操作时以当前界面为准。不要一次修改订阅、传输、DNS 和路由四组参数;保留一份能工作的配置,每次只改一类设置并验证结果。这样既方便回退,也能避免把节点本身的问题误判成应用代理问题。

订阅分组设置界面示意
分组备注
工作设备
订阅地址
由订阅提供方填写
自动更新
关闭,先手动验证
更新方式
按分组管理

订阅把一组节点集中管理,适合地址或参数会调整的配置。先在订阅分组中添加名称和完整地址,保存后执行更新,再选择实际使用的节点;添加地址本身不会自动建立连接。相比逐条粘贴分享链接,分组订阅便于批量维护,但更新时也可能覆盖手动修改。建议把自建节点放入独立分组。订阅地址可能包含访问凭据,不应公开分享;遇到更新失败,先确认地址有效,再检查更新请求的连接方式。

协议字段:先核对组合,再调整模式

VMess、VLESS、Trojan 和 Shadowsocks 是代理协议,WebSocket 等是传输方式,TLS 与 REALITY 则属于安全传输相关配置。它们不是同一层级的选项。看到 VLESS 节点时,还需要继续确认传输类型、是否使用 TLS 或 REALITY、是否指定 flow,不能只选一个协议名称就保存。上方卡片展示的是字段结构,不是可以直接连接的完整节点配置。

VLESS 的 encryption 通常填写 none,这不等于连接可以省略安全层。Trojan 需要正确的密码和服务端身份验证设置;遇到证书错误,应检查系统时间、SNI 与服务端证书,而不是直接打开跳过证书验证。Shadowsocks 的加密方法必须与服务端一致,带有年份前缀的方法还涉及特定密钥要求,不能把普通字符串密码任意套用到每一种方法中。

选择节点时,优先保留提供方给出的完整参数。若手动录入,按地址、端口、用户凭据、传输、安全层的顺序核对,再测试连接。客户端显示节点名称只说明配置已经入库,不代表内核能够解析全部字段,也不代表远端已经可达。需要进一步比较各协议的设计取舍、移动端电量影响和配置兼容性,可继续阅读协议与内核技术参考。

客户端下载入口按系统与处理器架构选择

查看全部客户端 →

桌面平台优先查看 v2rayN,安卓设备优先查看使用 Xray 内核的 v2rayNG,需要 V2Fly 配置兼容时再考虑 v2flyNG。客户端名称相近,但平台、内核和安装包格式并不相同。下载前先确认操作系统,再确认处理器架构;安装以后再处理订阅与节点,避免把安装包不适配的问题混进连接排查。

下面的入口会打开下载页对应的平台,不在首页直接启动安装包下载。下载页集中说明不同包型的适用范围,便于在同一处比较桌面版、经典界面、芯片架构和发行版格式。更换设备时可以沿用订阅来源,但原设备的系统代理、权限和路由设置不会随订阅一起迁移,仍需要重新检查。

Windows

v2rayN 首推

Windows 用户可在 v2rayN 桌面版与经典 WPF 版之间选择。桌面版采用跨平台界面,WPF 版保留经典桌面操作方式;选包时应先确认系统架构,再按界面偏好和已有使用习惯决定。不同包型的配置目录与迁移方式需要分别查看,不能仅凭文件名称判断是否可以直接覆盖安装。

首次使用先完成启动与订阅导入,再启用系统代理。部分应用不会读取系统代理设置,此时才考虑应用内代理或 TUN。若更换客户端后浏览器仍然使用旧端口,检查系统设置中是否残留其他代理程序的配置,并确保同一时间只有预期的程序管理入口。

macOS

v2rayN

macOS 安装包按 Apple Silicon 与 Intel 芯片区分。可在系统的“关于本机”中查看芯片或处理器信息,前者选择 arm64,后者选择 x64。优先使用匹配架构的包,不要把兼容运行当作默认选型;安装前也应核对下载页列出的系统要求。

桌面客户端的订阅管理与系统网络授权是两个步骤。导入成功后,仍需确认当前节点、代理入口和应用实际访问路径。需要启用 TUN 时,按界面和系统提示授予所需权限;如果设备受到组织策略管理,应先遵循设备管理要求,再调整网络设置。

Android

v2rayNG 首推

Android 优先选择 v2rayNG,v2flyNG 作为 V2Fly 内核备选。多数较新的主流设备适合 arm64 包,架构不确定时查看设备信息或考虑通用包。两款客户端的名称和图标容易混淆,安装前确认应用名称,导入后再核对协议支持,不要把两者的设置路径完全等同。

启动连接时的 VpnService 授权用于建立本地流量接管接口,并不意味着订阅自动变得可用。长时间待机后断连,除了节点状态,还应检查后台限制与省电策略。分应用代理适合控制接管范围,配置时先理解列表代表包含还是排除,避免所需应用被放在错误的一侧。

Linux

v2rayN

Linux 查看 v2rayN 的 deb 与 rpm 安装包,并区分 x64 和 arm64。包格式对应发行版的软件管理体系,架构对应处理器,两者都需要匹配。不要因为文件可以下载就认为适用于当前系统;安装依赖、桌面环境与权限要求应按下载页说明逐项确认。

Linux 的系统代理是否生效还取决于桌面环境和应用自身。浏览器可用但其他程序不通时,先检查该程序是否读取代理设置,而不是立即更换节点。启用 TUN 前确认权限与路由接管范围,尤其注意局域网、容器网络和已有虚拟接口,修改后保留能够恢复的原配置。

配置迁移只解决部分参数复用。新设备仍需确认内核支持、流量入口与 DNS 路径,具体操作见 快速上手教程。

Project V 开源生态客户端与内核分别选型

阅读协议详解 →
CLIENT

v2rayN · v2rayNG · v2flyNG

订阅管理、界面操作、配置生成
CORE

Xray · V2Fly

连接建立、协议处理、路由执行

生态背景:Project V 与 V2Ray

Project V 是围绕代理与网络工具形成的开源项目体系,V2Ray 是其中广为使用的核心名称。它的价值不只是某一种协议,而是把入站、出站、路由和传输设置组合到统一配置结构中。用户在客户端里看到的“节点”,通常只是其中一个远端出站的界面表达;系统代理、本地监听和 DNS 还属于其他配置部分,不能用一个节点名称概括整个运行环境。

日常交流中,V2Ray 也常被用作整个生态的泛称,因此下载时更应该看具体应用名称。v2rayN 是图形客户端,不等同于 V2Ray 内核本体;v2rayNG 与 v2flyNG 则面向安卓设备。明确这一层关系后,阅读文档时就能区分“界面增加了一个功能入口”和“内核增加了某个协议能力”,也能判断问题应该从客户端日志还是协议参数入手。

内核家族:V2Fly 与 Xray

V2Fly 延续 V2Ray 的社区开发,Xray 从相关代码基础发展出自己的功能路线。两者有共同背景,但各自维护和演进,不能理解成同一个程序的两种皮肤。即使某些配置字段相似,新增传输方式、安全机制、路由选项和默认行为也可能存在差异。选择内核的依据应是当前节点需要的功能与实际兼容性,而不是只比较名称或发布时间。

使用 VLESS、Vision 与 REALITY 组合时,应重点核对 Xray 的支持范围,以及服务端给出的 flow、服务器名称、公钥和 shortId。REALITY 是安全传输机制,不能简单当作与 VMess、Trojan 同层的独立代理协议。已有 V2Fly 配置也不应直接批量迁入另一内核:先选一个节点检查字段,再验证路由和 DNS,最后再迁移完整配置。

三款客户端:开源管理界面与平台差异

v2rayN、v2rayNG 和 v2flyNG 都是开源客户端,分别提供节点编辑、订阅管理和连接控制等图形操作。开源意味着源代码与许可条款可供查阅,但不代替对运行权限和配置来源的判断。订阅提供方、远端服务器与客户端是不同角色;安装客户端不会自动获得服务器账号,也不会保证每一个导入的节点都能使用。

v2rayN 面向桌面平台,适合在同一界面中管理订阅与路由,并按支持范围选择内核。v2rayNG 以 Xray 内核为主要基础,适合安卓用户使用相应协议能力;v2flyNG 采用 V2Fly 内核路线,适合需要对应配置兼容性的场景。跨应用迁移时,优先重新导入完整分享链接或订阅,再核对连接模式,不要只复制界面里的备注名称。

开源许可:看清分发与使用范围

Project V 相关项目、图形客户端、内核以及打包依赖可能使用不同的开源许可。不能把生态内的一份许可直接当成所有组件的统一规则。个人使用、再分发与修改后的发布涉及不同要求,需分别查看对应项目的许可文件和附带说明。页面上的“代码开源”描述的是开发与分发属性,不是对订阅内容或远端服务作出的保证。

对普通使用者,更实用的做法是记录应用名称、平台架构和所用内核,保留配置来源说明,并理解客户端申请的权限。对配置中的密码、用户标识和订阅地址保持谨慎;截图求助时应遮盖这些内容。节点的地址、SNI 与公钥虽然用途不同,也不宜把整份私人配置直接公开,描述字段是否一致通常已经足够帮助定位问题。

更新机制:客户端、内核与订阅分开管理

客户端更新主要影响界面和配置管理,内核更新主要影响连接实现,订阅更新则由配置提供方调整节点清单。这三类更新的来源和效果不同。订阅刷新后节点数量或参数发生变化,不一定是客户端升级造成的;客户端升级后无法启动某个配置,也不一定说明订阅地址失效。先辨别哪一层刚刚改变,再决定回退、重新导入还是调整字段。

更新前保留现有设置,记录正在使用的节点与路由模式;更新后先测试一个常用节点,再检查局域网访问、域名解析和需要代理的应用。自动更新间隔应结合订阅方的限制,不必频繁刷新。若持续失败,暂停反复请求,按地址有效性、请求路径、系统时间和错误日志逐项排查,避免多次修改让原始原因难以追踪。

连接验证:从入口到远端逐层检查

导入成功但无法访问时,先确认当前节点已选中、内核启动正常,再检查应用是否确实进入代理。浏览器能连接而其他程序不能连接,通常需要核对流量入口;只有域名访问失败,则优先检查解析路径;所有应用都失败,再回到节点参数和远端可达性。延迟测试只是某种测试请求的结果,不能单独证明全部协议与应用流量已经正常。

需要查词时使用术语表区分订阅、分享链接、入站和出站;需要按症状处理时查看常见问题。把错误发生的时间、最近修改的设置与日志类型整理清楚,比盲目切换协议更有效。完整的选型仍应结合服务端支持与应用需求,保持参数一致,比追逐某个协议名称更重要。

配置专题文章订阅格式、更新与部署

查看全部文章 →

完成基本连接后,再按需求阅读专题。订阅格式影响导入方式,更新失败需要检查请求路径,路由器部署则涉及与桌面客户端不同的网络角色。每篇文章集中处理一类问题,便于在改动前确认适用条件,也避免把旁路由、安卓授权和桌面系统代理的操作混用。