客户端入口与中文配置文档

v2rayN下载站:客户端与配置教程

集中整理 v2rayN 桌面客户端Android 客户端中文配置路径。从订阅导入到系统代理、路由分流和内核选择,按真实设置项说明每一步的作用。

永久免费 代码开源 Xray · V2Fly 中文文档

平台入口

按系统选择 V2Ray 客户端

桌面端统一以 v2rayN 为主,Android 可在 v2rayNG 与 v2flyNG 之间选择。下载中心会按处理器架构、安装格式和客户端界面列出对应入口。

Windows

使用 v2rayN 管理订阅、服务器列表、系统代理与路由规则。下载中心同时列出新一代桌面界面和经典 WPF 界面,适合按使用习惯选择。

前往下载

macOS

使用 v2rayN 的桌面界面维护订阅、代理与路由配置。进入下载中心后先确认设备采用 Apple Silicon 还是 Intel 处理器,再选择对应安装包。

前往下载

Android

v2rayNG 采用 Xray 内核,适合常见协议与路由配置;v2flyNG 采用 V2Fly 内核,可作为内核生态不同的备选。主流设备通常优先选择 arm64 架构。

前往下载

Linux

v2rayN 提供常见桌面发行版所需的安装格式,并区分 x64 与 arm64 架构。安装后可在统一界面管理订阅、内核、路由和系统代理。

前往下载

核心设置

订阅、路由、内核与系统代理

功能入口按实际配置顺序组织。选择下方标签可查看对应设置的用途、操作路径和容易混淆的边界。

订阅管理

定时更新与分组维护

订阅功能用于把服务端提供的节点集合导入客户端,并在同一分组中完成更新、筛选与切换。首次添加时应确认链接完整,再为分组设置便于识别的名称。自动更新适合经常发生节点调整的订阅,但更新间隔不宜过短;请求失败时,应先检查链接是否仍可访问,以及更新请求是否需要经过当前代理。

v2rayN 可在订阅分组设置中分别管理更新行为,避免所有分组使用同一策略。手动修改过的节点需要注意覆盖关系:重新更新订阅后,服务端下发的内容可能替换本地副本。重要的自定义配置更适合单独保存,而不是直接改写订阅生成的条目。

快速上手

从订阅导入到连接验证

先完成最短配置链路,再逐步加入自动更新、路由规则和内核调整。这样更容易判断问题出在哪一层。

  1. 添加订阅并执行首次更新

    打开订阅分组管理,新增分组后粘贴完整的 V2Ray 订阅链接。名称应能反映用途,便于多个分组并存时快速定位。保存后手动执行一次更新,确认服务器条目能够正常生成。若列表为空,不要先修改路由或内核,应回到订阅层检查链接、访问条件和返回格式。

    首次导入阶段建议保留默认更新策略,只验证“链接可读取、客户端可解析、列表有内容”三个结果。自动更新间隔可以在连接成功后再设置。这样可以避免把订阅读取问题、代理问题和定时任务问题混在一起处理。

  2. 选择条目并设置代理模式

    在服务器列表中选中准备使用的条目,将其设为活动配置,然后启动内核。接着根据应用范围启用系统代理,并先使用规则模式处理日常流量。系统代理控制应用是否把请求送入客户端,路由规则控制请求进入内核后走哪个出口,两者需要分开检查。

    如果某个应用没有响应,应先确认该应用是否遵循系统代理;如果只有特定域名表现异常,再检查路由命中顺序。不要在尚未确定入口是否生效时连续更换内核、订阅和规则,否则日志中的原因会被多次配置变化掩盖。

  3. 验证连接并保存稳定配置

    连接后先查看客户端日志,确认配置已被内核载入,且没有字段解析、端口占用或路由格式错误。随后使用一个遵循系统代理的应用进行访问验证,再分别检查直连规则和代理规则是否符合预期。日志记录的是配置处理结果,比只看界面状态更适合定位问题。

    基础连接稳定后,再启用订阅自动更新、开机启动等长期设置。每次只调整一个变量,并在修改路由或内核后重新载入配置。将可用配置保留为独立副本,后续新增规则时就能快速回到已验证的基线。

开源生态

Project V、V2Fly 与 Xray 的关系

客户端、内核和配置格式属于不同层次。理解各自职责,有助于判断协议兼容、功能差异与更新影响。

生态来源与项目分支

Project V 形成了以配置驱动网络核心为基础的技术生态。随着社区维护路径演进,V2Fly 延续 V2Ray 核心及相关组件,Xray 则在相近配置体系上发展出自己的功能分支。两者共享不少概念,例如入站、出站、路由、传输和 DNS,但并不意味着所有字段、协议扩展与运行行为始终完全一致。

因此,“V2Ray 客户端”通常是生态类别的概括,不代表客户端内部只使用某一个固定内核。判断功能时,需要同时查看客户端负责的图形管理能力、所搭载内核的特性,以及订阅内容使用的协议字段。只比较客户端名称,无法完整解释实际兼容情况。

图形客户端与内核分工

v2rayN 主要负责桌面端的服务器列表、订阅分组、系统代理、路由设置、日志查看和内核管理。用户在界面中完成配置后,客户端会整理出内核可读取的运行配置,再由 Xray 或 V2Fly 处理连接。界面显示“已启动”只说明进程状态,协议握手、DNS 查询和路由命中仍应结合内核日志判断。

这种分层设计的实际价值是配置管理与网络处理可以分别演进。客户端更新可能调整界面、订阅解析或配置生成逻辑;内核更新则可能影响协议支持、传输实现和字段校验。排查更新后的异常时,应先区分变化发生在哪一层,再决定恢复设置、切换内核还是修正订阅内容。

三款客户端的定位

v2rayN 面向 Windows、macOS 与 Linux 桌面环境,适合需要集中管理多个订阅、编辑路由规则、切换系统代理和查看详细日志的场景。不同桌面平台的系统代理行为与安装格式存在差异,但客户端中的订阅、服务器和内核概念基本一致,迁移时仍需重新核对本机路径与平台权限。

v2rayNG 面向 Android,主要采用 Xray 内核,界面围绕移动网络切换、订阅更新、路由和连接控制组织。v2flyNG 同样面向 Android,但以内核选择差异提供另一条配置路径。两者都属于开源社区维护的图形客户端,选择时应以订阅协议、内核需求和配置习惯为依据,而不是把不同名称简单理解为同一应用的界面变体。

开源协议与更新判断

开源项目允许社区查看代码、讨论实现并持续维护功能。对普通使用者而言,开源属性更直接的意义是配置行为与问题记录能够被技术社区分析,客户端和内核也能独立发布修正。它不替代基本的版本选择、权限管理和配置审查,仍应根据设备平台与实际需求选择合适的软件入口。

更新时应先阅读功能变化,保留现有配置,再确认订阅解析、内核启动和系统代理三个基础环节。若当前配置稳定且没有明确功能需求,可以先了解变化再安排更新;若新协议字段依赖特定内核能力,则需要同时考虑客户端生成配置的能力与内核支持情况。站内教程按这一分层逻辑整理操作步骤和故障路径。

常见问题精选

连接前后的四个判断点

先判断问题位于订阅、内核、系统代理还是路由层,再进入对应设置检查。

订阅更新后没有生成服务器列表,先检查什么

先确认订阅链接完整且仍可访问,再检查更新请求是否需要经过代理,以及返回内容是否属于客户端可解析的订阅格式。列表尚未生成时,切换系统代理模式或修改路由规则通常不能解决订阅读取问题。可前往快速上手教程按导入顺序重新核对。

客户端已经启动,应用仍然无法连接怎么办

先查看内核日志是否成功载入配置,再确认目标应用是否遵循系统代理。若其他应用能够连接而只有单个应用异常,应检查该应用自己的网络设置;若所有应用都没有接入,再检查系统代理端口与客户端监听状态。详细流程可在问题诊断中按症状查找。

系统代理、全局模式和路由规则有什么区别

系统代理决定应用是否把请求交给客户端;全局或规则模式决定客户端收到请求后如何选择出口;具体路由规则则负责匹配域名、地址与网络类型。三个概念处于不同处理阶段,排查时应避免把“应用未进入客户端”和“路由选择不符合预期”混为同一问题。

什么时候需要切换 Xray 或 V2Fly 内核

当配置使用特定协议扩展、内核日志提示字段不受支持,或需要验证某项功能的内核兼容性时,再考虑切换。普通连接问题应先检查订阅内容、时间设置、系统代理和路由。切换前停止当前连接,切换后重新载入配置,并根据日志确认实际运行的内核与字段解析结果。