客户端下载与参数配置

Xray官网 · 客户端下载v2rayN 配置指南

按操作系统选择开源客户端,从订阅导入开始,再配置路由与 DNS。桌面端使用 v2rayN,移动端对照内核选择客户端。

按平台选择
内核与图形界面分层客户端管理配置,内核处理连接

先确认协议与内核兼容,再调整路由、解析和流量接管方式。

XrayV2Fly
桌面配置v2rayN

订阅、路由与系统代理集中管理。

移动端选择v2rayNG / v2flyNG

根据服务端参数与内核需求选择。

阅读顺序安装 → 导入 → 分流

先建立基本连接,再逐项修改参数。

CLIENT SETTINGS

v2rayN 常用功能与参数位置

订阅决定服务器条目的来源,路由决定连接去向,DNS 提供解析结果。先区分这三个层次,再处理系统代理与 TUN 的接管范围,排查时可以减少交叉修改。

订阅分组

按来源保存订阅地址,在更新时分别检查结果。分组与服务器过滤可以缩小列表范围,但过滤条件也可能隐藏已导入的条目。更新后列表为空时,先检查分组选择和过滤表达式,再判断订阅是否失效。

路由规则

按 domain、ip、端口与协议匹配连接,再交给指定出站。规则从上向下检查,具体条件应放在宽泛条件之前;规则中的出站标签必须与实际配置对应。

DNS

为不同域名选择解析服务器。内核 DNS 与系统 DNS并非同一个入口,实际查询路径取决于应用是否提交域名、路由策略以及接管方式,不能仅凭服务器地址判断是否生效。

TUN 模式

通过虚拟网卡接收符合接管条件的 IP 流量,适合处理不读取系统代理的程序。启用前应确认权限和其他网络工具的状态,并检查默认路由、DNS 与局域网访问是否发生变化。

多内核

图形界面负责生成配置,Xray 与 V2Fly负责执行各自支持的协议和传输设置。切换内核不是通用修复手段,应先核对服务端要求,再检查生成配置是否包含不兼容字段。

系统代理

把系统代理地址指向本地监听端口。设置、清除与保持不变影响系统代理项,不等于改变所有程序的网络路径。浏览器扩展和应用自己的代理配置仍需分别检查。

自定义出站

用 outbounds 与标签引用表达连接去向。标签是规则与出站之间的关联,不是服务器显示名称。修改时应同时检查引用关系、认证字段和连接方向,避免形成回环。

SETTINGS REFERENCE

路由、DNS 与订阅分组设置示意

下面是参数关系示意,不是可编辑表单。不同客户端界面的名称可能调整,判断配置时以字段含义与实际生成的配置为准。

在路由设置中先确定连接该走哪个出站,再填写域名、IP 或端口条件。具体域名规则放在宽泛规则前面,避免提前被其他条件命中。IPIfNonMatch 表示域名未匹配时再尝试解析 IP 并检查规则,不代表所有请求都会提前解析。保存后重新加载配置,用同一个目标地址复测,并查看日志中的出站标签。它与系统代理的区别在于:系统代理负责把请求交给客户端,路由负责决定进入客户端之后的去向。

阅读路由规则实战
PLATFORM ENTRIES

V2Ray 客户端平台入口

先核对操作系统和处理器架构,再选择安装包。客户端提供本地配置与连接能力,安装完成并不等于已有可用服务器;还需要从可信来源取得订阅或完整的连接参数。

Windows

桌面端首选 v2rayN。下载中心提供桌面版与经典 WPF 版入口,前者使用跨平台界面,后者保留经典界面。根据现有使用习惯选择,不必同时运行两套客户端。

首次启动先保持默认监听设置,导入订阅并选择服务器,再设置系统代理。若内核启动失败,应查看启动日志与端口占用;不要先把路由、DNS 和 TUN 全部改动。

前往下载

macOS

使用 v2rayN 的桌面界面管理订阅与路由。安装前在“关于本机”中确认芯片类型,Apple Silicon 与 Intel 对应不同安装包,不能只根据设备外观判断。

安装后先测试系统代理路径,再处理需要额外权限的接管功能。浏览器能够连接而其他应用失败时,检查应用自己的代理设置,以及该应用是否读取系统代理。

前往下载

Android

优先对照 v2rayNG 的 Xray 内核支持范围;需要 V2Fly 内核时,可查看 v2flyNG。主流较新设备通常选择 arm64,无法确认架构时再阅读下载中心的通用包说明。

首次建立连接需要确认系统 VPN 授权。若切到后台后中断,检查电池优化和后台活动限制;若所有应用均无法连接,再核对服务器参数、网络环境与客户端日志。

前往下载

Linux

v2rayN 提供桌面图形界面,安装包按发行版包管理体系区分 deb 与 rpm,并分别提供对应架构。先确认系统发行版和处理器类型,再选择相应入口。

桌面环境的代理项与终端程序的代理环境变量属于不同配置。图形应用可用但命令行失败时,应先确认命令行工具读取哪一种代理来源,而不是立即更换服务器。

前往下载

查看全部客户端 →

PROJECT V ECOSYSTEM

Project V、V2Fly 与 Xray 的关系

把生态名称、代理内核和图形客户端分开理解,才能判断教程中的选项适用于哪里。名称相近不代表配置可以原样互换,实际支持范围应结合所选内核与客户端界面确认。

Project V:配置模型的背景

Project V 是 V2Ray 相关工具与技术文档所处的开源生态。入站、路由与出站构成常见的配置理解路径:入站接收应用请求,路由检查条件,出站执行连接。这套模型比记住某个开关的位置更稳定,界面变化后仍可用于定位问题。

阅读旧教程时,还要区分协议、传输与安全层。VMess、VLESS、Trojan 是不同的协议选择,WebSocket 等属于传输配置,TLS 则涉及连接安全参数。把这些名称混在一个“模式”里理解,容易漏填服务端要求的字段。

V2Fly 与 Xray:内核的演进分支

V2Fly 社区延续了 V2Ray 的开发维护,Xray-core 则从相关代码基础发展出自己的实现与功能。两者共享部分配置概念,但协议扩展、字段支持和默认行为会随各自开发而变化。某个配置能被其中一个内核读取,不代表另一个也能读取。

选择时先查看服务端提供的完整参数与内核要求。不要仅凭服务器名称判断兼容性,也不要把切换内核当成速度优化按钮。出现未知字段或不支持的传输提示时,优先确认配置适用范围,再决定是否需要更新或更换内核。

三款客户端:开源界面与内核组合

v2rayN、v2rayNG 与 v2flyNG 都属于开源图形客户端。v2rayN 面向桌面系统,负责订阅管理、参数编辑与内核调用;v2rayNG 面向 Android,使用 Xray 内核;v2flyNG 则提供基于 V2Fly 内核的移动端选择。客户端名称与实际负责连接的内核名称需要分别核对。

开源许可证规定代码的使用、修改与分发条件。Xray-core 与 V2Fly 内核采用 MPL 2.0 许可,图形客户端则各有自己的许可证要求。内核的许可证不能直接替代整个客户端的许可说明,涉及二次分发或修改时应分别阅读对应项目的声明。

更新顺序:先备份,再复测

图形客户端和内核可能分别更新,设置界面、配置生成方式与协议支持也可能分别变化。升级前先备份订阅分组、路由规则和自定义配置,记录当前代理模式;升级后先验证一条已知可用的连接,再逐步恢复额外规则,便于定位行为差异。

下载中心集中提供按平台选择的入口,首页不固定具体版本。订阅更新与程序更新也不是同一件事:前者刷新服务器条目,后者改变客户端或内核程序。遇到某个条目失效时,先看订阅更新结果与连接日志,不必直接重装整个客户端。

FIELD NOTES

客户端使用心得与配置记录

围绕具体设置位置和故障现象展开,先说明判断条件,再给出检查顺序。初次使用可从新手十问开始,已有可用配置后再阅读节点选择与路由器部署。

查看全部文章 →