客户端配置手册 · 从订阅分组开始

V2Ray订阅教程 v2rayN 下载与订阅导入

按平台选客户端,依次完成订阅导入、代理模式与路由设置。

开源客户端 Xray / V2Fly 内核 中文操作说明
配置入口

从订阅导入到连接设置

订阅、代理入口、路由和内核是不同层次的设置。先把分组内容读进客户端,再决定应用流量如何进入内核,最后检查匹配规则。菜单名称可能随界面更新略有调整,遇到差异时按设置项的作用定位,不要照着图标位置盲点。

保存订阅地址,再更新分组

订阅是可重复获取配置的地址,节点是更新后得到的单条连接配置。在 v2rayN 中打开“订阅分组设置”,填写备注与地址并保存,再执行更新订阅。只有保存动作不会自动生成节点。与手动逐条添加相比,分组便于统一刷新来源内容;更新也可能移除来源已删除的条目,因此不要只在订阅条目里保存手工改动。地址中的访问凭据需要保密,求助时隐藏完整链接。更新后先核对分组和协议类型,再选择活动配置。

查看入门指南 →
安装包入口

按平台选择 V2Ray 客户端

桌面端以 v2rayN 为主,安卓端先看 v2rayNG,再按内核需求考虑 v2flyNG。客户端只是配置工具,安装完成后仍需要有效的订阅或分享链接。进入下载页后,先确认处理器架构和安装包类型,再阅读该平台的安装说明。

Windows

v2rayN

下载页提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版保留经典操作布局;两者的菜单位置可能不同,配置时按字段名称对应。先在系统设置中确认设备架构,再选择匹配的安装包。

已有配置时先做备份,再更换界面版本。不要同时启动多个客户端接管系统代理,否则浏览器可能仍指向另一个进程的本地端口,看起来像是订阅无法连接。

前往下载

macOS

v2rayN

先打开“关于本机”确认芯片类型,再选 Apple Silicon 或 Intel 安装包。完成应用安装后,分别检查客户端启动状态与系统代理设置;应用窗口能够打开,并不能证明系统流量已经进入代理。

若系统提示限制打开应用,先核对获取来源和系统提示内容,再按系统提供的安全设置处理。初次验证用系统代理即可,虚拟网卡相关权限与分流设置可以在基本连接正常后再配置。

前往下载

Android

v2rayNG / v2flyNG

v2rayNG 使用 Xray 内核,v2flyNG 使用 V2Fly 内核,选择依据是配置兼容性,而不是名称相近就可以互换。多数现代手机适合 arm64 包;设备架构不明确时,先查看设备信息,再考虑通用包。

首次连接会出现系统 VPN 授权提示,这表示客户端申请本地流量接管权限,不代表订阅已经验证成功。若切到后台后连接中断,再检查电池优化、后台运行权限和其他网络工具是否占用同一系统入口。

前往下载

Linux

v2rayN

按发行版的软件包体系选择 deb 或 rpm,再区分 x64 与 arm64。下载页列出对应入口,图形安装器可用于查看依赖提示。安装包格式与处理器架构是两个独立条件,需要同时匹配。

桌面环境对系统代理的读取方式可能不同,部分应用还使用自己的网络设置。测试时先在一个明确支持代理的应用中验证,若该应用正常而其他应用失败,应检查应用入口,而不是立即替换订阅。

前往下载
快速上手

订阅配置的三个步骤

首次配置建议一次只修改一类设置。先确认订阅能读取,再检查代理入口,最后验证实际访问。这样出现问题时,可以明确回到哪一步,而不是在节点、DNS 和内核之间反复切换。

  1. 步骤一 · 导入来源

    保存分组并更新订阅

    复制订阅来源提供的完整地址,在“订阅分组设置”中新增分组,填写便于辨认的备注后保存。接着执行更新,确认列表中出现连接条目。分享链接则使用对应的剪贴板导入入口,不要把分享链接当成可定期更新的订阅地址。

    更新结果为空时,先看提示是请求失败还是解析失败。前者优先检查地址是否有效、更新是否经过代理;后者检查订阅格式与协议支持。重复点击更新不会修复已经失效的地址。

  2. 步骤二 · 设置入口

    选择活动配置与代理方式

    在列表中选定准备使用的配置。桌面端先使用“自动配置系统代理”,并保留适合当前用途的预设路由;安卓端启动连接并完成系统授权。不要在尚未验证连接时同时加入复杂规则、修改 DNS 或切换内核。

    系统代理决定应用是否把请求交给客户端,路由规则决定接收请求后使用哪个出口。这两个设置分别检查。如果应用本身设置了代理地址,还应确认本地端口与客户端监听设置一致。

  3. 步骤三 · 验证连接

    实际访问并检查日志

    用常用应用访问明确的目标,结合客户端日志观察是否出现连接错误。单次连接测试只能反映测试条件下的结果,不能代替浏览器、应用和 DNS 的实际验证。测试时保留原始设置,便于发现问题后回退。

    若只有某个应用失败,检查该应用的代理入口;若全部失败,再检查活动配置、系统时间与协议参数。退出客户端前按需要清除系统代理,避免应用继续请求已经停止监听的本地端口。

开源生态与选型

客户端、内核与协议的关系

V2Ray 常被用作一类工具的统称。实际配置时,最好把它拆成图形客户端、连接内核、协议参数三个层次来看。理解这三层,有助于判断下载什么、哪里需要更新,以及一份订阅为什么在不同设备上表现不同。

Project V 与内核家族

Project V 是相关代理工具与协议生态的背景,V2Ray 是其中的重要项目。V2Fly 延续 V2Ray 的社区开发,Xray 则从相关代码基础发展出独立的功能路线。两者共享一部分历史和配置概念,但不是同一内核的两个界面名称,也不能只根据文件名判断功能完全相同。

在这个生态中,内核负责建立连接、处理传输、安全层、路由与解析;图形客户端负责把这些能力组织成设置界面。遇到报错时先区分“界面无法保存”和“内核无法启动”:前者可能是输入格式或客户端配置问题,后者通常需要根据内核日志检查字段与功能支持。

三款客户端的职责

v2rayN、v2rayNG 与 v2flyNG 都是开源图形客户端。v2rayN 面向桌面平台,可管理订阅、路由和不同内核;v2rayNG 在安卓端使用 Xray 内核;v2flyNG 提供基于 V2Fly 的安卓端选择。它们负责配置与连接管理,不会因为安装完成就自动获得可用的订阅来源。

开源意味着项目代码按相应许可证公开,使用、修改和再分发需要遵循各自许可。客户端与内核可能采用不同许可证,不能用一个统一标签概括所有组成部分。对于日常配置,更重要的是选择来源明确的软件包、阅读更新说明,并理解应用向系统申请的网络权限。

协议名称不是性能排名

VMess、VLESS、Trojan 与 Shadowsocks 描述不同的协议设计,REALITY 则属于安全层方案,不能把它们全部当成同一层级的选项。客户端中的协议、传输方式与安全层需要按服务端提供的参数组合填写。仅把 VMess 改成 VLESS,或者随意打开一个安全选项,都不能完成有效转换。

连接体验还受网络路径、服务端负载、传输设置与设备资源影响,不能只凭协议名称预测速度或耗电。移动端还要考虑后台保活和流量接管方式。选型时先满足兼容性,再在相同网络与用途下比较实际表现;需要了解设计取舍时,可继续阅读协议详解。

查看协议与内核选型 →

订阅更新与软件更新分开处理

更新订阅会重新读取来源提供的配置,更新客户端则改变界面、管理逻辑及可能随包提供的内核。两者解决的问题不同:地址过期应回到订阅来源确认,内核不支持某项功能才需要检查软件和内核的兼容范围。不能指望刷新分组修复缺少功能,也不能指望升级软件恢复已被来源撤销的访问权限。

调整前备份必要配置,并记录原有的路由模式、DNS 与代理入口。更新后先验证一条已知配置,再逐步恢复自定义设置。若需要求助,保留错误类型和发生步骤即可;完整订阅地址、分享二维码、用户标识和访问凭据不应出现在公开截图中。

使用心得

订阅更新与连接排查

基本连接正常后,再处理具体使用问题。下面三篇从订阅读取、新手概念和 DNS 行为展开。排查时保留报错原文,并记下刚刚修改过的设置,通常比反复重装更有助于缩小范围。