开源客户端 · 中文配置手记

V2Ray for Windows v2rayN 下载与配置教程

从订阅导入到路由分流,按真实设置项完成连接,再用代理生效验证检查流量路径。

  • 订阅管理
  • 系统代理
  • TUN 模式

配置索引 / 从入口到流量路径

v2rayN 参数设置索引

先让一个节点完成连接,再逐项增加分流与接管功能。下方片段用于解释设置与内核配置的对应关系,不是可整段替换的完整配置;不同内核的字段不能混用,界面名称也可能随客户端更新略有调整。

订阅分组 › 订阅分组设置 › 添加

订阅地址与节点列表分开管理

在“订阅分组设置”添加名称与订阅地址,保存后从“订阅分组”执行更新。先尝试不通过代理更新,只有地址确实需要代理访问时再切换更新方式。订阅管理比逐条导入链接更适合批量维护,但更新成功只代表取回内容,不代表每个节点都能连接。导入后选择一个节点设为活动服务器,再做真连接测试。订阅地址通常含访问凭据,不要发到公开截图或交给来历不明的转换页面。

{
  "outbounds": [
    { "tag": "proxy", "protocol": "vmess" }
  ]
}

片段只展示 Xray 出站结构;服务器地址、用户信息与传输参数由导入内容生成。

查看订阅导入步骤 →

首次配置的检查顺序

先保存原有配置,再导入订阅、选择活动服务器、执行真连接测试,最后启用系统代理。每完成一步就确认结果,避免把订阅下载失败、节点连接失败和浏览器未使用代理混成同一个问题。若已经修改过多项参数,可以先退出其他代理工具,关闭 TUN,回到单节点加系统代理的最小测试环境。

真连接测试会尝试经过节点访问测试目标,Tcping 则主要反映服务器端口的连接情况。两者测试对象不同,端口能连通不代表协议握手成功,测试目标暂时不可达也不必然说明节点完全失效。比较结果时保持网络、目标和测试方式一致,再打开实际需要使用的网站验证,不以单个数字判断全部体验。

按完整教程完成首次连接 →

客户端选型 / 系统与处理器

四平台客户端入口

桌面系统使用 v2rayN,安卓设备优先选择 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。下载页按系统和处理器整理安装入口;客户端安装完成后仍需要有效的节点信息,安装包本身不提供可用服务器,也不会自动生成订阅。

Windows

v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留经典窗口布局。先按下载页列出的系统要求选择,不把界面差异当作节点性能差异。

安装前退出正在运行的旧实例,避免两个进程争用本地监听端口。需要迁移时先备份订阅分组和路由设置,保留一个可工作的配置,再验证新环境。涉及 TUN 的权限问题,应在普通系统代理连接成功后单独处理。

前往下载 Windows 客户端

macOS

v2rayN 按 Apple Silicon 与 Intel 提供入口。在系统的“关于本机”查看芯片或处理器,再选择对应安装包,不根据电脑外观或购买年份猜测架构。

首次打开时按照系统安全提示确认应用来源与所需权限。连接验证先从浏览器开始,再检查系统代理设置;如需开启 TUN,另外核对网络权限和其他网络扩展。切换 Wi-Fi 后若连接异常,应重新检查默认网络路径。

前往下载 macOS 客户端

Android

首选使用 Xray 内核的 v2rayNG,v2flyNG 作为 V2Fly 内核备选。主流设备通常选择 arm64,不能确认架构或遇到安装不兼容时,再查看下载页的通用版说明。

导入节点后需要同意系统的 VPN 连接请求。系统通常只允许一个此类连接保持活动,启用其他网络接管应用可能使当前连接断开。若前台正常、锁屏后失效,优先检查电池优化和后台运行限制,再排查节点本身。

前往下载 Android 客户端

Linux

v2rayN 提供 deb 与 rpm 安装入口,并区分 x64 和 arm64。先确认发行版使用的包管理方式,再核对处理器架构;包格式和架构是两项独立条件。

图形桌面的系统代理设置未必会被终端程序继承。浏览器连接成功后,仍应检查目标应用是否读取桌面代理,或是否配置了独立的代理入口。TUN 还涉及网络权限与路由,远程维护环境下应先准备恢复原网络配置的方法。

前往下载 Linux 客户端

安装包选型与配置迁移

同一订阅可以包含多种协议,但客户端与内核不一定支持其中的每一项。安装后若部分节点无法导入,应先看报错中的协议或传输字段,再判断是否需要调整客户端或内核。不要为解决一个节点的问题反复重装整个系统,也不要覆盖尚未备份的路由配置。

迁移配置时只保留必要数据。订阅地址、节点链接与导出的配置文件可能包含账号信息,分享日志前先删除这些内容。首页用于选型和阅读操作路径,具体安装包与更新信息集中放在下载页,便于按当前系统重新选择。

查看全部客户端 →

开源生态 / 客户端与内核的边界

Project V、V2Fly 与 Xray

图形界面
v2rayN / v2rayNG / v2flyNG

连接内核
Xray / V2Fly

配置内容
入站 / 出站 / 路由 / DNS

Project V 是生态背景,不是单一安装包

V2Ray 源于 Project V 的模块化网络工具体系。日常搜索中的“V2Ray 客户端”常同时指图形界面和连接内核,实际使用时需要把两层分开理解:图形界面保存订阅、组织节点并生成配置,内核读取配置后处理入站、路由和出站。浏览器能否访问,还取决于操作系统与应用是否把请求送到这个入口。

这种分层解释了一个常见现象:主窗口可以正常打开,订阅列表也能显示,但内核可能因端口占用或配置错误而未能启动。因此“程序已打开”不是“代理已生效”的充分条件。排查时先确认内核日志,再核对本地监听和系统代理,最后检查网站访问结果,能少走许多重复重装的弯路。

V2Fly 与 Xray 同源发展,配置逐渐分化

V2Fly 延续 V2Ray 的社区维护路线,Xray 是从 V2Ray 发展而来的另一条内核路线。两者有共同的技术背景,也各自演进协议支持、传输能力与配置细节。理解共同概念有助于阅读配置,但不能据此假定所有新字段都能互换。遇到协议特性、流量探测或 DNS 行为差异时,应回到当前实际运行的内核判断。

v2rayN 的多内核管理可以把不同配置集中到图形界面中,但具体可用组合仍受客户端实现与内核支持范围限制。选择内核时,优先满足节点所需协议和传输参数,再考虑已有路由规则是否兼容。若连接原本正常,切换内核后失败,应先检查配置兼容性,而不是直接认定服务器不可用。

三款客户端的开源属性与分工

v2rayN、v2rayNG 与 v2flyNG 都是开源图形客户端。v2rayN 和 v2rayNG 采用 GPL-3.0 许可,v2flyNG 采用 GPL-3.0 许可;V2Fly 与 Xray 内核采用 MPL-2.0 许可。客户端与内核是不同项目,许可适用范围应分别查看。开源意味着代码及相应许可条件可供研究与审阅,不代表任意来源的二次打包都具有相同维护质量。

桌面端的重点是订阅管理、系统代理和多内核配置,安卓端还要配合系统 VPN 接口与后台运行策略。v2rayNG 面向 Xray 内核配置,v2flyNG 提供 V2Fly 内核路线。选型应围绕设备、协议和既有配置展开,而不是把客户端名称当作速度排名;同一客户端在不同节点与网络下的表现也会不同。

更新界面、内核与规则数据要分别验证

客户端更新、内核更新和路由分类数据更新解决的是不同问题。界面更新可能调整设置入口,内核更新可能影响协议行为,分类数据更新则可能改变域名或地址的匹配结果。更新前记录当前活动服务器、系统代理状态和路由预设,保存必要配置;更新后先验证原有连接,再启用新增功能。

不建议在同一次排查中同时替换订阅、内核、DNS 与整套路由。保留能工作的基线,每次只变更一类设置,结果才有可比性。若更新后仅个别域名异常,检查规则命中与 DNS;若内核无法启动,检查日志中的字段错误与端口占用。遇到持续问题时,可以从问题诊断页按症状逐章核对。

进入 v2rayN 问题诊断 →

配置手记 / 最近文章

DNS 设置与连接问题排查

先区分“节点未建立连接”和“连接后请求走错路径”。最近三篇手记分别处理 DNS 泄漏、解析分流与网页无法访问,按日志、系统代理和路由结果逐项核对,避免只凭客户端状态栏下结论。

查看全部文章 →