客户端选择 · 配置手册

V2Ray使用教程下载与配置

v2rayN 客户端下载与配置手册:从开源客户端选择开始,按顺序完成订阅导入与路由分流,理解每一项配置的作用。

  • VMess
  • VLESS
  • Trojan
  • REALITY

V2Ray 配置章节索引

先区分客户端与内核,再处理订阅、流量入口和出口规则。按当前遇到的问题选择章节,不必一次修改所有设置。

客户端界面与代理内核

v2rayN 等客户端负责订阅、配置编辑与运行控制,实际处理连接的是所选内核。V2Fly 延续 Project V 的技术体系,Xray 则在相关基础上独立发展。选择时应核对服务端使用的协议、传输方式与安全设置,而不是仅看客户端名称。涉及 REALITY 或 XTLS Vision 的配置,需要确认所用内核的支持情况;替换内核前应保留原配置,并先用一个已知可用的连接完成验证。

{
  "log": {
    "loglevel": "warning"
  },
  "outbounds": [
    { "tag": "direct", "protocol": "freedom" }
  ]
}
阅读内核家族章节

阅读配置片段时,应把它们视为对应章节的局部示例,而不是可以直接替换的完整配置。连接配置还包含服务端地址、认证信息与传输参数;这些字段必须与服务端一致。客户端自动生成的内容也可能随所选内核改变,修改之前先导出备份,避免把两个不同内核的字段拼接到同一份文件中。

排查时采用固定顺序:先确认内核能够启动,再确认本地应用确实连接了监听端口,最后检查请求命中了哪个出口。每次只改变一项设置并记录结果,可以区分“连接没有建立”和“规则没有按预期匹配”。如果只是浏览器能访问而另一个程序不能访问,应优先检查流量入口,而不是立即更换订阅。

完整配置路线:核心概念、客户端安装、订阅管理、路由分流与日常维护。

阅读系统教程

V2Ray 客户端平台入口

桌面设备优先查看 v2rayN,安卓设备优先查看 v2rayNG。先确定操作系统与处理器架构,再选择对应安装形式。

选择安装包时,处理器架构比设备外观更有参考价值。桌面设备应在系统信息中确认芯片类型;安卓设备则需要区分 arm64 与通用包。不能因为同一款客户端在另一台设备上能够运行,就直接复用它的安装文件。安装失败时先检查包格式和架构,再查看系统提示,通常比连续尝试不同文件更容易确定原因。

桌面版与经典 WPF 版属于 v2rayN 的不同界面路线,不代表服务端协议有两套相互独立的标准。现有用户迁移界面时,应重点核对订阅分组、活动节点、系统代理状态以及自定义规则是否保留。首次使用则可以从下载页的说明开始选择,先完成基础连接,再逐步添加分流和网络接管功能。

跨设备使用时,可以复用兼容的订阅来源,但不应直接复制所有本地设置。本地端口、网络权限、虚拟接口和系统代理机制都与运行环境有关。安卓客户端建立网络连接时会请求相应系统授权;桌面端启用网络接管时也可能需要提升权限。遇到权限提示,应先理解当前启用的功能,再决定是否继续。

Project V、V2Fly 与 Xray 生态

理解项目之间的职责,比把客户端、内核和协议统称为同一个名称更有助于选型与排查。

技术体系Project V
围绕代理内核、传输与路由能力形成的项目生态。
连接处理V2Fly / Xray
负责协议处理与连接转发;功能边界需分别核对。
图形界面v2rayN / v2rayNG / v2flyNG
负责用户配置、订阅组织与运行控制。

从 V2Ray 到内核家族

V2Ray 是 Project V 生态中广为使用的名称。随着项目发展,V2Fly 延续相关内核的维护,Xray 也在共同技术基础上形成了独立演进路线。因此,“V2Ray 客户端”通常是在描述一类配置工具,而不是保证它们运行着完全相同的内核。查看教程时,应把客户端名称、内核名称和协议名称分别记录,才能准确判断某个字段是否适用。

VLESS、VMess 与 Trojan 是连接协议层面的概念,REALITY 则涉及连接安全机制;这些名称并不处在同一层级。服务端给出的配置可能同时包含协议、传输、安全层以及额外参数,缺少其中一项就可能导致连接失败。选择支持某个协议的客户端只是第一步,还需要确认其实际使用的内核能够处理整组参数。

三款客户端的使用边界

v2rayN 面向桌面使用,适合集中管理订阅、切换活动配置并维护路由。v2rayNG 面向安卓设备,使用 Xray 内核;v2flyNG 则是采用 V2Fly 内核的安卓备选。三者均以开源方式提供代码,但界面布局、参数入口和系统接入方式不同。教程中的操作应以相同功能为对应依据,而不是要求不同设备上出现完全一致的按钮文字。

多内核选择也不等于任意配置都能互换。某个内核支持的扩展字段,另一个内核可能并不识别;同一个分享链接经不同客户端解析后,也应再次核对传输参数。已有可用连接时,可以先保留它作为参照,再测试新配置。这样的迁移方式能把兼容性问题与本地网络问题分开,避免同时失去所有可用的排查入口。

开源协议与使用责任

开源说明源代码按相应许可证公开,用户可以在许可范围内查看、使用和研究实现。它并不意味着所有组件使用同一份许可证,也不意味着订阅提供方与客户端项目属于同一主体。例如,Xray-core 采用 MPL-2.0,v2rayN 采用 GPL-3.0;涉及代码再分发或修改发布时,应分别阅读对应项目及依赖的许可要求,而不是仅凭“免费”推断使用边界。

客户端、内核和连接服务承担的职责也不同。客户端负责运行本地配置,连接是否成功还受服务端参数、账户状态与网络条件影响。免费获取客户端不代表自动获得订阅或远端服务。首次安装前准备好有权使用的连接信息,导入时不向他人公开订阅地址、认证字段或完整配置截图,能减少后续处理凭据泄露的风险。

更新机制与配置维护

客户端更新、内核更新、订阅更新和规则数据更新是四件不同的事情。订阅更新主要刷新连接列表,不会自动修复不兼容的内核字段;规则数据更新影响域名和地址集合,也不等于替换了客户端程序。遇到问题时,应先确认是哪一层发生变化,再决定更新对象,避免连续更换多个组件之后无法追踪原因。

日常维护可以保留一份可用配置备份,并简要记录所选内核、代理模式和自定义规则。升级后先测试基础连接,再验证局域网访问、直连目标与代理目标是否符合预期。日志可以帮助判断配置是否成功加载,但分享日志前应去除订阅地址与认证内容。需要长期维护复杂规则时,可继续阅读系统教程,把每条规则的目的与适用条件一并保存。

查看三款客户端的选型对比 →

初次配置常见问题

先建立可重复的基础验证,再增加规则和接管功能。以下问题可以帮助确定下一步应检查的位置。

安装客户端后,为什么还需要订阅或连接配置?

客户端提供本地配置与运行界面,并不自带你的远端连接信息。需要准备有权使用的订阅地址或分享链接,导入后选择一个活动节点,再启动连接。若导入后列表为空,应先检查返回内容和格式,而不是直接开启所有网络功能。查看订阅导入步骤 →

已经选择节点,为什么浏览器仍未使用代理?

选择节点只确定连接配置,流量是否进入客户端还取决于系统代理或应用自己的代理设置。先检查内核是否启动,再确认浏览器使用的地址和端口与客户端监听一致。若浏览器安装了独立管理代理的扩展,还应核对它是否覆盖系统设置。查看代理模式步骤 →

初次使用是否应直接开启 TUN?

建议先通过普通代理确认节点可用,再根据应用需求决定是否启用 TUN。这样可以把服务端连接问题与本地权限、接口路由问题分开。若目标应用本身支持设置代理,先使用明确的本地代理入口更便于验证;需要接管其他流量时,再按系统教程检查网络接口和 DNS。查看基础连接流程 →

连接慢时,应先换节点还是先改 DNS?

先确定慢发生在哪一步:域名解析、建立连接,还是持续传输。使用相同目标对比直连与代理,并在相同配置下测试另一个可用节点,比同时修改 DNS、传输和分流更有判断价值。只有观察到解析相关现象时,才进一步检查 DNS 配置;调整后保留记录并复测。查看连接验证步骤 →

如果准备向他人描述故障,可以先写清客户端名称、所选内核、发生问题的应用,以及问题是在导入、启动还是访问阶段出现。提供简短且去除敏感字段的错误文本,比只描述“无法使用”更容易定位。恢复配置时也应沿原步骤回退:先撤销最近修改的规则,再恢复代理入口,最后确认系统网络连接,避免把多个独立问题混为一谈。

配置与排查文章

围绕内核差异、连接速度与启动日志展开。已有基础配置后,可按具体症状阅读,不必重新安装客户端。