开源客户端与配置文档

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

从客户端选型和订阅导入开始,再沿一条流量的路径理解路由与 DNS各自负责什么。

Xray V2Fly VMess
01平台索引

V2Ray 客户端下载入口

先确认操作系统,再核对处理器架构与安装格式。同名客户端可能提供多个安装包;包的差别不等于可用节点的差别。

Windows

首次安装可从 v2rayN 桌面版开始;已经熟悉经典界面的用户可选 WPF 版。两种入口主要对应不同的界面实现,菜单名称和位置可能有差异。阅读教程时先辨认界面,再找订阅、路由和系统代理的对应入口。

若只是从旧版迁移,先保留原配置和订阅信息,再用新客户端验证一条曾经可用的节点。这样遇到异常时,可以先区分界面变化、导入问题和连接问题。

前往下载 →

macOS

在系统信息中查看芯片或处理器:Apple Silicon 选 arm64,Intel 选 x64。不要只凭电脑的外观、系列名或购入时间判断,同一产品系列可能同时存在不同架构的机型。

应用能够打开只说明安装环节已经通过。首次连接时,再分别确认订阅列表能否刷新、节点是否已选中,以及用于测试的应用是否采用当前系统代理设置。

前往下载 →

Android

v2rayNG 使用 Xray 内核;需要 V2Fly 内核时可选 v2flyNG。确认系统支持 arm64 后选对应安装包,无法判断时可对照下载页的通用版说明。先选能处理目标配置的客户端,再比较体积和安装格式。

首次启动连接时,系统可能弹出 VPN 连接授权。授权后再打开一个测试应用确认流量是否经过客户端;如果设备已有其他 VPN 服务在运行,先检查它是否占用了系统的 VPN 连接。

前往下载 →

Linux

桌面环境可使用 v2rayN。通常 Debian、Ubuntu 系选择 deb,Fedora 系选择 rpm;包格式确定之后还要核对架构,不能把发行版名称当成处理器类型。安装失败时先读包管理器的报错,区分架构、依赖和权限问题。

安装成功后也要单独验证应用接入:各桌面环境对系统代理的实现不尽相同,有些应用使用自己的网络设置。若浏览器正常而另一应用不通,先检查后者的代理设置。

前往下载 →
查看全部客户端 →
02配置编目

路由、DNS 与订阅管理

客户端先取得节点配置,应用流量进入之后,内核才会解析目标并按规则选择出站。排查时沿这条路径寻找第一个出现异常的环节。

能看到节点列表,说明至少取得了一份配置;能连上节点,说明该节点在当前条件下可用;目标应用能访问,则还要求它的流量确实进入客户端,并命中了期望的规则。这三个结果不能相互替代。

初次设置时,先用一条节点和一个应用建立可重复的测试。记录接入模式、目标地址和测试结果,然后再加路由规则或调整 DNS。保留这份记录,后续才能判断异常来自新设置还是网络环境变化。

路由规则适用于同一设备要让不同目标走不同出口的场景。系统代理主要决定哪些应用把请求交给客户端;路由决定已经进入内核的流量往哪里走。编辑规则时,先写清匹配条件和目标出站,再将范围较窄的例外放在会覆盖它的通用规则之前。测试时各选一个应该命中的目标和一个不应命中的目标,并对照客户端可用的连接日志检查实际出站。规则生效但结果不符时,先查顺序,再查节点。

内核
Xray / V2Fly
平台
桌面 / 移动端
适用场景
按目标地址选择出站
查看教程 →
03开源生态

Project V、V2Fly 与 Xray

辨认项目、内核与图形客户端三类名称,可以解释为什么同一份教程不能逐字套用到每个应用,也能缩小排查问题的范围。

界面层
订阅、节点列表、配置管理
内核层
入站、路由、出站
系统层
应用接入、网络权限

Project V 的入站与出站模型

Project V 是相关代理工具的项目体系,V2Ray 是其中用于处理连接的核心组件。后来,V2Fly 社区延续了 V2Ray 的开发,Xray 则从这一代码家族分出并独立演进。两者共享一批基本概念:入站接收流量,路由判断走哪一路,出站负责把连接交给下一站,或者按配置拒绝连接。首屏的四个出站名称是示意标签,实际名称与行为由配置定义。

以浏览器为例,当它采用本地代理设置时,请求才会到达相应入站;内核随后用可获得的目标信息匹配规则。若浏览器绕过了代理,即使内核正在运行,也不会替它执行分流。理解这层边界,比记住某个版本的按钮位置更有用:设置界面会变,但流量需要先进入内核这一前提不变。

内核分支与配置兼容性

V2Fly 与 Xray 各自维护协议实现和配置功能。它们的文档可能都出现入站、出站等字段,但字段同名并不保证每个选项都可互换。VMess、VLESS 等名称描述协议的一部分;连接还会受到传输方式、安全设置以及两端实现的影响。服务端的配置决定了客户端需要满足哪些条件,不能根据节点备注中的地区或线路名称推断。

迁移时先保留旧环境,将同一条已知可用的配置单独导入新环境。若界面识别节点但内核未能启动,先读启动错误;若内核启动后只有该节点不通,再回到节点参数和网络可达性。用这个顺序排查,可以避免把传输参数不符误判为订阅过期,也能避免一开始就修改整套分流规则。

v2rayN、v2rayNG 与 v2flyNG 的开源属性

三款客户端各自公开源代码。v2rayN 面向桌面,提供订阅、节点和路由配置的管理界面;v2rayNG 以 Xray 为内核;v2flyNG 提供以 V2Fly 为内核的移动端选择。客户端与内核是不同层的项目,订阅列表的展示方式、界面菜单的布局、系统权限的申请流程,不能用来判断内核是否属于同一分支。

开源许可约束的是代码的使用、修改与再分发,不能代替对第三方订阅服务的判断。免费使用客户端与付费购买线路是两件事。配置中若包含订阅地址或节点凭据,不应把整份文件贴到公开讨论区。报告问题时,通常只需提供操作系统、客户端和内核名称、故障出现的阶段,以及去掉敏感字段的报错摘要。

客户端更新、内核更新与订阅刷新

客户端更新可能改变界面和系统接入方式,内核更新可能改变新增特性的支持范围或配置的解析行为,订阅刷新则会重取节点列表。安装包有时随附内核,因此一次升级可能同时影响前两层;但刷新订阅并不会把应用升级,也不会自动修复本地路由错误。排查更新后的故障,第一步是弄清这次实际改了什么。

保留旧设置后,可以用固定网络、固定节点和固定测试目标做前后对照。先确认应用能启动,再确认节点仍然可用,最后检查此前的规则是否命中。若只有规则结果变化,还要看域名和地址数据是否随更新一起更换。把几个动作拆开做,能保留明确的回退点,也能给维护者提供更有用的复现描述。

连接验证与故障分层

起步时先按订阅导入教程建立一个可用状态,再考虑更复杂的规则。列表未更新时,重点检查订阅来源和获取过程;列表正常而所有节点均失败时,先核对当前网络、接入模式与内核启动状态;如果只有个别应用失败,则检查该应用是否使用系统代理、是否有独立 DNS 设置,以及它的目标命中了哪条规则。

比较连接质量时,不要用一次延迟结果代替实际体验。网页短请求关注响应时间,文件传输更容易反映持续吞吐,两者受不同因素影响。使用同一网络和同一测试目标重复比较,把网络切换、节点更换和配置改动分别记录。若设置回退后请求仍不稳定,应重新检查节点和线路,而不是继续叠加本地规则。

04专题阅读

部署、节点选择与路由实践

从单机连接到局域网部署,这三篇文章分别处理接入范围、节点取舍与规则优先级。按现有问题选读即可。

/ 部署实践

路由器与旁路由运行 Xray 内核:部署方式概览与取舍

概览在主路由与旁路由上直跑 Xray 内核的几种方式,对比性能需求、透明代理接管与维护成本,帮助判断是否值得部署。

如果只有一台电脑需要专门配置,单机部署通常更容易测试和恢复。把配置放到网关前,先明确哪些设备应受影响、故障时由谁恢复网络,以及如何验证局域网服务仍能互通。部署的难点往往不是启动内核,而是让接管范围与预期一致。

/ 入门指南

节点怎么选:延迟、倍率、地区与协议类型的取舍对照

面对订阅里几十个节点,从延迟测试、流量倍率、地区用途到 VMess、VLESS、Trojan 协议差异,给出入门选择思路。

先按用途排除不合适的地区或计费方式,再在同一网络环境下比较候选节点。综合观察响应速度和稳定性,而不是单次测速的排名。

查看全部文章 →