CLIENT / 客户端与内核配置

Xray官网 · v2rayN
客户端下载与内核配置

从开源客户端开始,完成订阅导入,再按应用需求配置路由分流。

Xray / V2Fly VMess / VLESS Trojan / Shadowsocks

界面为设置结构示意。菜单名称、监听端口和可用选项以实际客户端配置为准。

SECTION 01 / 剖面档案

客户端配置。从界面看到处理路径。

图形客户端负责管理连接参数,内核负责处理流量。导入一条链接只是配置的起点:协议字段决定如何连接服务器,代理模式决定应用流量能否进入客户端,路由规则再决定流量从哪个出站离开。把这三层分开检查,比同时修改多个开关更容易定位问题。

协议、传输与内核分层

v2rayN 用图形界面管理服务器参数,再交给所选内核执行。VMess、VLESS、Trojan 与 Shadowsocks 的字段不能互换;传输方式与 TLS 设置也必须和服务端一致。导入后先核对协议类型、地址、端口及安全设置,再确认内核是否支持对应组合。相比直接编辑整份配置,图形管理便于保存多组连接,但并不消除字段之间的约束。REALITY 属于安全传输相关配置,不应当作独立代理协议随意替换。

inboundsoutboundsstreamSettings

SECTION 02 / 平台入口

客户端下载。先选系统,再选架构。

安装包需要与当前设备匹配。桌面平台的界面形态、处理器架构与发行包格式是三个独立选项,不必仅凭文件大小判断。下载页集中列出各客户端入口和选择说明;本页的平台链接会直接打开对应的平台分组。

Windows

桌面端首推 v2rayN。Desktop 使用新一代跨平台界面,经典 WPF 版保留传统桌面界面,可按操作习惯选择。两者的界面布局可能不同,导入、选择服务器与配置系统代理的基本流程相近。

安装前查看系统类型,确认下载包面向的架构。首次启动后先检查内核能否正常运行;如果窗口可以打开但连接失败,应继续查看日志,不能据此直接判断服务器参数有误。

前往下载 Windows 客户端 →

macOS

选择 v2rayN,并在“关于本机”中确认芯片信息。Apple Silicon 与 Intel 对应不同安装包,优先选择与设备原生架构匹配的入口,而不是把所有磁盘映像都当成通用包。

系统代理主要服务于遵循系统网络设置的应用。需要更广的流量接管时,再阅读 TUN 配置要求。权限确认与连接配置是不同环节,应先完成启动和导入,再测试应用访问。

前往下载 macOS 客户端 →

Android

优先选择使用 Xray 内核的 v2rayNG;需要 V2Fly 内核配置时,可考虑 v2flyNG。多数较新的设备适合 arm64 包,不能确定架构时可查看设备信息,再参考下载页的通用包说明。

首次连接需要确认系统 VPN 授权。后台运行还会受到设备电量管理策略影响;只有锁屏后断开时,应检查后台限制,而不是立刻更换协议。不同网络之间切换后也需要重新验证连接。

前往下载 Android 客户端 →

Linux

桌面环境可选择 v2rayN。先按发行版选择 deb 或 rpm,再确认 x64 或 arm64 架构。软件包格式对应系统包管理方式,处理器架构对应运行环境,两项都需要匹配。

系统代理设置是否被应用读取,与桌面环境及应用自身实现有关。需要单独配置代理的程序,应填写客户端实际监听地址和端口。启用 TUN 前先了解权限要求,并避免与已有网络管理规则冲突。

前往下载 Linux 客户端 →

Linux 企鹅图形:Font Awesome Tux,依 CC BY 4.0 使用。

SECTION 03 / 首次连接

v2rayN 快速上手。导入、接管、验证。

客户端不自带可用的远端连接。开始前准备有权使用的订阅地址或分享链接,并确认当前网络能够获取订阅内容。首次配置只保留一个客户端运行,先建立可重复的基础连接,再加入自定义分流与 TUN 等设置。

  1. STEP 01 / IMPORT

    导入订阅或分享链接

    在 v2rayN 的“订阅分组”中保存订阅地址,再执行更新;单条分享链接可通过剪贴板导入。导入后检查协议、地址、端口与传输设置是否完整。条目出现在列表中,只说明客户端识别了内容,不代表远端服务已经连通。若更新结果为空,先检查地址、网络请求与订阅格式,不要反复删除所有分组。

    订阅地址可能包含访问权限信息,应像账户凭据一样保存。向他人提供排错截图时,隐藏完整地址、身份字段和个人备注。迁移设备前分别备份订阅来源与本地规则,避免误以为复制服务器列表就包含了全部设置。

  2. STEP 02 / PROXY

    选择服务器与代理模式

    将需要使用的服务器设为活动项,再选择“自动配置系统代理”。初次测试可从清晰的路由预设开始,确认哪些目标会直连、哪些目标会交给代理。浏览器自带代理扩展、手动代理设置或其他网络工具可能覆盖系统设置,测试前应检查这些额外入口。

    如果某个应用不读取系统代理,先查看它是否提供独立的代理设置。确实需要更广的接管范围时,再启用 TUN 并处理权限与 DNS。一次只改变一个环节,保留上一组能够复现的配置,方便判断问题从何处开始。

  3. STEP 03 / VERIFY

    验证真实请求与应用行为

    Tcping 主要反映目标端口的 TCP 可达性,真连接测试会进一步涉及代理握手和测试请求;两者不能互相替代。测试结果还受测试目标与当时网络影响。选择服务器后,通过浏览器访问预期经代理处理的页面,并对照客户端日志中的连接与路由信息。

    若测试通过但应用仍不可用,沿着“应用代理设置、本地监听、路由命中、远端握手”的顺序检查。不要只凭任务栏图标或开关状态确认代理生效。测试结束后记录使用的模式与例外规则,下一次切换网络时便能按同样路径复查。

SECTION 04 / 开源生态

Project V 与内核家族。区分项目、协议和客户端。

从 V2Ray 到 V2Fly、Xray

Project V 是理解 V2Ray 生态的起点。V2Ray 将入站、路由、出站与传输等能力组合在一起,让代理不只是单一协议的连接程序。用户日常接触的服务器列表和开关,则往往来自外层图形客户端。讨论“V2Ray 客户端”时,需要先确认指的是界面程序、运行内核,还是连接采用的协议;这三个概念有关联,但不是同一层东西。

V2Fly 延续 V2Ray 的社区开发,Xray 从相关代码基础发展出自己的功能路径。两者具有共同的配置背景,也存在各自实现与演进的部分。因此,部分基础字段看起来相似,并不意味着任意配置都可以原样互换。涉及 VLESS、REALITY、传输扩展或特定安全选项时,应确认实际内核的支持情况,而不是仅依据客户端名称判断。

三款客户端的职责边界

v2rayN 是开源桌面客户端,面向服务器管理、订阅更新、代理模式与路由配置提供图形入口。v2rayNG 是安卓平台的开源客户端,使用 Xray 内核;v2flyNG 同样面向安卓设备,以 V2Fly 内核作为另一种选择。选择哪款客户端,应先看操作系统,再看已有连接需要的协议能力,不宜把“能导入”直接等同于“全部字段都得到支持”。

图形客户端会把界面设置转换为内核运行配置,因此界面中的名称不一定与原生 JSON 字段一一对应。内核能够支持的选项,也未必全部暴露为图形控件。遇到高级配置时,应先阅读当前客户端的设置说明,再核对内核字段含义;直接套用其他客户端的界面教程,容易把相似名称误认为相同功能。

开源协议与配置责任

开源意味着代码可依相应许可证查阅、使用和再分发,不代表所有相关项目都采用同一许可证。Xray-core 与 V2Fly 的 V2Ray-core 使用 MPL-2.0;客户端界面、内核及附带组件的授权条款应分别阅读。需要修改、分发或集成软件时,以对应项目的许可证文本为准,不能只沿用整个生态的概括性称呼。

开源属性也不替代对配置来源的判断。订阅发布者决定连接参数,远端服务器决定服务可用性,本机客户端决定流量入口与分流行为。对未知配置,先理解路由目标、DNS 设置与监听范围,尤其不要为了排错而把本地代理监听随意开放到其他设备可访问的地址。

客户端、内核与规则分别更新

客户端界面更新、内核更新与规则数据更新属于不同层次。界面更新可能改变菜单位置,内核更新可能调整字段支持或运行行为,规则数据更新则可能影响域名及地址集合的匹配结果。排查更新后的变化时,先记录发生变化的层次,再比较连接参数和路由结果,避免将所有异常都归因于服务器。

更新前保留必要的本地设置,更新后用原先能够复现的应用请求做一次验证。自定义规则较多时,还应检查更具体的规则是否仍排在通用规则前面。下载页负责提供客户端入口,协议参考页解释设计取舍;涉及某个字段的具体行为,则应结合当前运行内核与日志一起判断。

阅读协议与内核参考 → 查看三款客户端选型 →