配置管理 · 界面示意

先导入配置,再启用代理

客户端负责组织配置与调用内核,不会自动提供服务器或订阅。准备好由可信来源提供的订阅链接,再更新配置、选择条目,最后开启适合当前平台的流量接入方式。

界面上的“更新订阅”与“启动服务”是两个操作。前者获取远端配置,后者运行本地内核;更新成功并不等于连接已经建立。

订阅分组路由设置系统代理
配置来源订阅分组设置
导入方式从剪贴板导入
订阅操作更新当前订阅
桌面流量接入自动配置系统代理

配置工作区

订阅、路由与内核设置

先区分配置来源、规则决策和流量入口,再调整具体参数。下面展示的是设置项示意,不是可操作的客户端窗口;实际菜单位置以所用客户端为准。

订阅分组用于把不同来源的配置分开管理。先在客户端新增分组,填写便于识别的备注与订阅地址,保存后执行更新,再从对应分组选择条目。分组备注只帮助辨认,不会改变服务器参数。相比逐条粘贴配置,订阅能在来源变更参数后集中更新,但也可能覆盖远端管理的字段。需要长期保留的手动修改应单独备份;订阅链接通常含访问凭据,不应放进公开截图或转交在线转换页面。

配置排查按层进行

订阅能更新但网页打不开,通常需要继续检查流量有没有进入本地客户端,而不是立即更换订阅。先确认内核成功启动,再核对系统代理指向的本地端口,随后检查路由和 DNS。每次只改一个条件,保留修改前的设置,才能知道是哪一步产生了变化。多个客户端同时接管系统代理、浏览器单独配置代理扩展、其他程序占用监听端口,都可能造成界面状态与实际访问表现不一致。

遇到“全局代理”选项时,要先看它位于哪里:系统代理中的全局设置、客户端路由的全局模式与 TUN 流量接入并不是同一个概念。前者影响应用如何进入代理,路由模式影响进入后的请求走向。术语含义不确定时,先查术语表;需要逐项操作时,再按配置教程完成一次最小可用配置。

平台入口

V2Ray 客户端下载平台

先确定操作系统,再确定处理器架构。桌面端统一查看 v2rayN,安卓端按内核需求选择 v2rayNG 或 v2flyNG。具体安装包入口集中在下载中心,首页不展示版本号。

Windows

v2rayN 首推

v2rayN 提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版延续经典桌面交互;按系统要求与使用习惯选择,不必同时运行两套客户端。

安装前确认处理器架构与运行环境。便携方式使用时,把程序解压到可写、路径清晰的目录,不要在压缩包内部直接运行。首次测试先选系统代理,确认浏览器可访问后,再考虑 TUN 与其他进阶选项。

macOS

v2rayN

v2rayN 按 Apple Silicon 与 Intel 处理器分别提供入口。先通过“关于本机”确认芯片,再选对应安装包;处理器选型与订阅协议是两件事,不会因换包而自动转换配置。

安装后按系统提示处理应用权限,启用系统代理时确认当前网络服务的代理设置已同步。若只在部分应用中失败,先检查应用是否读取系统代理;需要 TUN 时,再按教程核对权限和虚拟接口状态。

Android

v2rayNG 首推

v2rayNG 使用 Xray 内核,适合需要相应协议支持的配置;v2flyNG 使用 V2Fly 内核,作为按配置需求选择的备选。主流设备通常选择 arm64,不确定架构时查看设备信息或选择通用版。

首次启动连接需要确认系统 VPN 授权。系统通常只允许一个应用占用该 VPN 接口,测试前停止其他同类连接。若切到后台后中断,再检查电池优化与后台运行限制,不要只反复导入同一份订阅。

Linux

v2rayN

v2rayN 提供 deb 与 rpm 包,并区分 x64、arm64 架构。安装包格式取决于发行版的软件包体系;处理器架构则取决于设备,两项都要匹配,不能仅凭文件后缀判断是否适用。

桌面环境、浏览器与应用对系统代理的读取方式可能不同。先用图形客户端完成订阅和本地监听设置,再检查目标应用的代理入口。TUN 需要额外权限与网络环境配合,已有虚拟网络接口时应逐项验证。

查看全部客户端 →

流量入口 ≠ 路由规则

代理模式分两层看

应用先通过系统代理或虚拟接口把请求交给客户端,内核再按照路由规则决定出站。开启 TUN 不代表所有请求必然走远端代理,启用分流也不意味着所有应用都会自动进入客户端。

验证时选择一个明确目标,观察日志里是否出现对应请求。完全没有请求记录时,优先检查流量入口;有记录但连接失败时,再检查服务器参数、解析结果和出站规则。日志是否记录请求也取决于当前日志级别。

配置检查顺序
  1. 01
    应用流量系统代理 / TUN / VPN 模式
  2. 02
    内核路由域名规则 / 地址规则 / 默认出站
  3. 03
    连接目标直连 / 代理 / 阻止

快速上手

订阅导入到连接验证

把首次配置压缩成三个阶段。先建立可用基线,再增加规则、自动更新或 TUN 等选项。详细菜单与平台差异见完整教程。

  1. 安装客户端,准备订阅

    确认系统与架构后安装对应客户端,准备来自可信来源的订阅链接或单条配置。订阅地址不是普通介绍页地址,复制时不要混入空格、换行或说明文字。已有旧配置时先导出备份,并确认备份是否包含订阅分组、路由与应用设置,避免把只含节点的文件误当作完整迁移文件。

    客户端可以管理配置,但不能代替配置提供方生成有效的服务器参数。地址、端口、用户标识与传输选项应来自同一份完整配置;不要把不同教程里的字段拼接使用。

  2. 导入订阅,选择配置

    在订阅管理中添加分组并保存地址,执行更新后检查是否出现配置条目。单条分享链接则使用客户端的导入入口。选择准备使用的条目,再确认它的协议与当前内核匹配。更新失败时先检查订阅地址是否仍有效,以及当前网络能否取得订阅内容;不要立即删除全部设置。

    订阅格式不被识别时,优先向来源确认兼容的输出格式。转换只能处理工具支持的格式,不能补回缺失参数,也不能赋予内核尚未支持的协议功能。包含凭据的地址不宜交给不明在线转换服务。

  3. 启用接入,逐项验证

    桌面端先启用系统代理,安卓端确认 VPN 授权,然后访问明确的测试目标。客户端显示运行,只能说明本地服务处于运行状态;还应检查目标访问结果和日志。失败时按“内核启动、本地端口、应用入口、DNS、路由、服务器配置”的顺序缩小范围,不要一次切换多组设置。

    结束测试后,用客户端提供的停止与清除系统代理功能退出。若浏览器仍指向已经停止的本地端口,普通网页也可能打不开。需要恢复时先核对系统网络设置,再决定是否重新启动客户端。

查看完整教程 →

Project V · V2Fly · Xray

开源生态与客户端分工

客户端名称、内核名称与协议名称不在同一层。选型先看平台,再看配置需要的协议与内核能力,不用把所有名称当作不同的连接服务。

Project V 与内核家族

Project V 是围绕网络代理工具形成的开源生态背景,V2Ray 是其中的重要项目。V2Fly 延续 V2Ray 相关开发,Xray 则在共同基础上发展出自己的协议扩展与实现方向。两条路线都有各自的演进节奏,不能把名称相近理解成配置字段始终相同,也不宜简单用“新版替代旧版”概括关系。

对使用者而言,差异最终落在具体功能上:某份配置使用哪些协议、传输与安全机制,当前内核是否接受这些参数。以 REALITY 为例,应确认所用 Xray 内核及客户端导入支持情况。若日志提示未知协议或字段,先核对兼容性,而不是把问题归为网络不稳定。更详细的对应关系见选型指南。

三款图形客户端的职责

v2rayN 面向桌面环境,把配置列表、订阅分组、路由与系统代理入口集中到图形界面。v2rayNG 面向安卓,使用 Xray 内核并通过系统 VPN 接口接入应用流量。v2flyNG 同样面向安卓,提供基于 V2Fly 内核的选择。三者都是开源客户端,但不意味着界面布局、菜单名称与配置备份格式可以直接互换。

桌面首选 v2rayN,是因为本页的桌面教程围绕它组织;安卓优先查看 v2rayNG,再按内核需求考虑 v2flyNG。选择备选客户端应有明确原因,例如已有配置要求对应的内核行为,而不是同时开启多个客户端试图叠加效果。多个入口争用代理设置或 VPN 接口,反而会增加排查变量。

开源协议与配置来源分开理解

开源意味着项目代码按相应许可证提供查看、使用或再分发的条件,具体权利义务应以各项目随附的许可证为准。客户端界面、内核与附带组件可能采用不同许可;某一个组件的许可不能直接代替整个发行包的许可说明。使用开源客户端也不等于自动获得订阅或服务器服务。

订阅提供方负责配置内容,客户端负责读取和执行,网站文档负责说明操作与概念。三者的职责应分开看。含用户标识的订阅链接、二维码与导出文件都应按敏感配置保存。排查时分享日志只保留必要错误上下文,先移除服务器地址、用户标识与订阅凭据,避免把完整访问资料贴到公开讨论中。

更新客户端,也关注内核变化

客户端更新可能调整界面、配置生成逻辑或系统集成,内核更新则可能改变协议支持与参数处理。升级之前记录当前可用模式并备份设置,升级之后先用原有配置测试;确认基线正常,再尝试新增功能。若出现异常,比较启动日志与设置变化,比连续重复安装更容易定位原因。

订阅更新、规则数据更新和程序更新是不同操作。订阅更新刷新远端配置,规则数据更新影响匹配范围,程序更新替换客户端或相关运行组件。下载入口集中在下载中心;安装、迁移与平台特有问题集中在全平台安装配置大全。遇到已有明确现象的问题,也可先查FAQ再决定下一步。

配置文章

安装流程与内核原理

先完成基础配置,再阅读与当前问题相关的专题。平台教程解决安装与设置顺序,内核对比帮助判断兼容性,原理文章用于理解进阶选项的作用边界。

查看全部文章 →

v2rayN下载