CLIENT / CONFIG / ROUTING

V2Ray代理客户端 v2rayN 下载与配置

围绕 开源客户端、订阅导入与路由分流,整理四平台安装入口、内核选择与配置字段参考。

NET
{VMess} {VLESS} {Trojan} {Shadowsocks}

01 / CLIENT SHELF

V2Ray 客户端平台入口

先确认操作系统和处理器架构,再选择安装包。桌面端使用 v2rayN;Android 优先查看 v2rayNG,需要 V2Fly 内核时再比较 v2flyNG。安装包选择与连接参数是两项独立检查,装好客户端之后仍需导入可用配置。

Windows

v2rayN / Desktop · WPF

桌面版采用跨平台界面,WPF 版保留经典桌面操作方式。下载前先看清包的类型,不要把两个入口理解为两套不同协议。已经有配置的用户,迁移前应保留订阅分组、路由设置与本地监听端口记录。

首次使用可先导入一条配置,选择活动服务器,再设置系统代理。若浏览器能连接而其他程序不能,先检查程序是否读取系统代理,而不是连续更换服务器。两版界面细节可能不同,操作时以当前菜单名称为准。

前往下载 Windows 客户端

macOS

v2rayN / Apple Silicon · Intel

在系统的“关于本机”中查看芯片信息。Apple Silicon 与 Intel 对应不同安装包,不能只按文件扩展名判断。将应用放入应用程序目录后,再处理系统给出的打开确认与网络权限提示,避免从临时位置反复启动。

系统代理与流量接管权限分别检查。若升级后出现连接行为变化,先看客户端是否启动内核,再看系统代理是否指向当前监听端口。需要处理开发者提示时,按系统设置中的安全提示操作,不建议为了启动应用而整体关闭系统安全机制。

前往下载 macOS 客户端

Android

v2rayNG / v2flyNG

v2rayNG 以 Xray 内核为主要使用方向,v2flyNG 提供 V2Fly 内核选项。两款应用的名称相近,但协议字段支持范围不能直接等同。选择前先确认配置是否包含 REALITY、特定传输方式或其他内核相关参数。

按设备架构选择 arm64 或通用包,安装后导入订阅,并确认系统 VPN 授权。这里的 VPN 授权用于应用接管设备流量,不代表客户端附带远端服务。若应用切到后台后连接中断,再检查电池优化、后台活动限制与其他 VPN 类应用是否冲突。

前往下载 Android 客户端

Linux

v2rayN / deb · rpm

先看发行版的软件包体系,再区分 x64 与 arm64。deb 与 rpm 是安装包格式,不是连接协议;选择错误通常发生在安装阶段,而不是路由阶段。图形会话下的代理设置还可能受桌面环境影响,不能假定所有应用都会自动继承。

安装后确认本地监听端口与内核运行状态,再配置浏览器或桌面系统代理。终端程序可能需要单独设置代理参数。若只有某个程序失败,应先核对该程序的代理入口;需要更广的流量接管范围时,再评估当前客户端的 TUN 能力与权限要求。

前往下载 Linux 客户端

02 / CONFIG INSPECTOR

订阅、路由与 内核配置

客户端负责整理界面设置,内核负责执行连接与分流。下面将两层设置分开说明:订阅分组属于客户端管理数据;入站、出站、路由和 DNS 才是内核配置中的常见部分。代码均为局部示例,不应直接覆盖整份运行配置。

config.json / outbounds 节选

订阅用于批量获取连接配置,分组用于在客户端中区分来源。先建立分组,再填入订阅地址并更新,确认返回内容能被当前客户端解析。更新后检查节点名称、协议与传输字段,不要只看列表是否出现条目。分组名与自动更新间隔属于客户端设置,并不是通用内核字段。下方仅展示导入后可能生成的出站结构;示例不含远端凭据,不能据此建立代理连接。需要整理多个来源时,再设置过滤条件并保留原始分组。

{
  "outbounds": [
    { "tag": "direct", "protocol": "freedom" },
    { "tag": "block", "protocol": "blackhole" }
  ]
}

03 / OPEN-SOURCE ECOSYSTEM

Project V、V2Fly 与 Xray

客户端、内核、协议与远端服务是不同层次。理解这些边界,可以解释为什么相同订阅在不同应用中表现不同,也能减少把权限问题、解析问题和服务端参数混在一起排查的情况。

ORIGIN / PROJECT V

生态名称与执行内核

Project V 是理解 V2Ray 生态的起点。V2Ray 围绕入站、出站、传输、路由与域名解析组织代理能力,配置文件把这些模块连接起来。日常搜索中的“V2Ray 客户端”通常指负责管理这些能力的图形应用,并不总是指某一个固定内核。下载客户端之前,先分清正在选择的是管理界面,还是执行连接的程序。

V2Fly 延续了 V2Ray 的社区开发路线;Xray 则形成了另一条内核分支,并发展了自己的协议与传输扩展。两者具有共同背景,一些基础配置概念也相似,但不能据此认为所有字段都兼容。对照说明时,除了看字段名,还要看示例对应哪个内核,以及客户端实际调用的内核是否与说明一致。

CLIENT / THREE APPLICATIONS

三款开源客户端的分工

v2rayN 面向桌面系统,承担订阅管理、服务器选择、路由编辑与本地代理设置等工作。跨平台界面让桌面用户可以沿用相近的操作思路,但操作系统权限、安装方式与系统代理机制仍有差别。迁移设备时,应先转移必要配置,再检查监听端口与接管模式,不要直接套用另一台机器的全部环境设置。

v2rayNG 与 v2flyNG 面向 Android,分别对应 Xray 与 V2Fly 的常见使用方向。它们都是开源客户端,主要差别应从内核能力、可识别字段和应用设置中判断。订阅地址可导入并不代表每条连接都可运行;解析成功之后,还需要检查协议、安全层、传输参数与系统授权。桌面和手机共享同一来源时,也应分别完成验证。

LICENSE / SOURCE CODE

开源协议与使用边界

V2Fly 内核采用 MIT 协议,Xray-core 采用 MPL-2.0 协议;客户端、内核与附带组件各自适用的许可应分别阅读。开源说明代码使用与分发的条件,不等于远端服务的资费说明,也不代表所有网络环境都具有相同表现。客户端可免费使用,连接所需的服务器与订阅则由用户自行准备。

开源生态的价值在于实现方式可以被讨论、检查与改进,问题也能围绕具体模块定位。不过,代码公开不能代替使用者对配置来源、网络权限与数据处理路径的判断。导入配置前,应了解服务器由谁提供;分享故障信息时,应移除订阅地址、身份标识与认证参数,只保留复现问题所需的字段结构。

UPDATE / COMPATIBILITY

应用更新与配置迁移

客户端更新、内核更新和订阅更新分别改变不同内容。客户端更新可能调整界面、配置生成方式或系统集成;内核更新可能改变协议支持与字段处理;订阅更新主要替换远端连接信息。因此,出现变化时先记录改动发生在哪一层,再决定回看日志、恢复设置还是重新导入订阅,避免同时执行多项操作后失去判断依据。

升级前保留可恢复的客户端配置与自定义规则,升级后先测试原来可用的一条连接。基础访问正常之后,再检查分流、域名解析和局域网共享。不要只以界面显示“运行中”作为验证结果:内核启动成功只说明进程已经工作,实际请求是否走向预期出站,还需要结合应用代理设置与日志中的路由结果判断。

READING / CONFIGURATION PATH

从连接参数到路由规则

第一次配置建议按固定顺序进行:先核对远端地址、端口和认证参数,再核对协议、传输与安全层;随后启动本地入站,选择一条连接测试。只有基础路径可用之后,才添加复杂路由。这样可以区分“连接本身失败”和“请求被规则送往错误出站”,也能避免把错误的 DNS 结果误认为协议不兼容。

阅读 JSON 时,先找入站和出站的标签,再顺着路由规则查看它们如何关联。规则中出现的域名列表和地址列表还可能依赖外部数据文件,文件缺失与规则写法错误是两种问题。需要逐字段对照时,查看配置大全;只需要完成首次导入和连接时,先按快速上手操作,不必一次启用所有高级功能。

配置前的四个常见问题

订阅地址和单条连接有什么区别?
订阅用于获取一组可更新的连接,单条分享链接描述一项连接参数。导入后先确认来源分组,再选择活动项,避免更新时混淆手动添加的记录。查看常见问题 →
VMess、VLESS 和 REALITY 是同一层设置吗?
VMess、VLESS 属于代理协议,REALITY 属于安全传输相关技术。不能只按某个名称选客户端,还要同时核对协议、传输方式和安全参数的组合。查看术语手册 →
系统代理开启后,为什么部分应用仍然直连?
部分应用不会读取系统代理,需要显式填写代理或采用其他接管方式。先确认应用请求进入本地监听端口,再分析出站和分流,不能从开关状态推断全部流量路径。查看连接检查步骤 →
内核启动失败,应该先检查哪一处?
先读第一条明确错误,区分 JSON 语法、端口占用、未知字段与数据文件缺失。日志中的后续连接错误可能只是启动失败的结果,排查时应从最早的原因开始。查看故障排查说明 →

04 / FIELD NOTES

客户端配置文章

按操作场景补充说明。修改前先定位当前问题属于监听、权限、配置生成还是远端连接,再进入对应文章。文章中的局部示例用于解释设置关系,实际参数仍需与使用环境一致。