桌面与安卓 · 首次配置

v2rayN 下载与订阅导入

按顺序完成订阅导入、系统代理与路由分流,从安装客户端开始,逐项确认连接设置。

开源客户端 图形化配置 中文操作指南
选择平台,查看对应安装入口
客户端下载入口

按系统选择安装包

先确认操作系统和处理器架构,再选安装格式。桌面端使用 v2rayN,安卓端优先查看 v2rayNG;已有 V2Fly 配置需求时,再考虑 v2flyNG。

Windows

v2rayN · 桌面首选

桌面版采用跨平台界面,经典 WPF 版保留熟悉的 Windows 操作方式。两种入口都用于管理服务器配置、订阅分组和路由规则,不需要同时安装才能使用。首次配置建议先选一种界面,完成连接后再决定是否迁移。

安装前查看系统要求;若客户端启动即退出,先检查对应构建的运行环境和目录写入权限。不要把配置目录放在临时解压位置,更新或清理文件时容易丢失设置。已有配置先备份,再执行升级。

前往下载

macOS

v2rayN · 按芯片选包

在“关于本机”中查看芯片信息:Apple Silicon 选择 arm64,Intel 处理器选择 x64。两类安装包对应不同架构,订阅配置的基本流程一致。完成安装后,先打开客户端,再添加订阅,不要把安装完成等同于已经建立连接。

第一次启动时留意系统提示,确认应用来源后按系统允许的方式处理。若浏览器仍走原有连接,检查当前网络服务的代理设置及浏览器扩展;系统代理、客户端路由和应用自身代理是不同层次,需分别确认。

前往下载

Android

v2rayNG · Xray 内核

安卓端优先选择 v2rayNG;需要 V2Fly 内核时,可查看备选客户端 v2flyNG。较新的主流手机通常使用 arm64,无法确定架构时查看设备信息,或选择下载页列出的通用包。不要仅根据应用名称判断两款客户端的协议支持完全相同。

导入订阅后还要更新分组、选中配置并启动服务。首次启动需要确认系统 VPN 授权;该授权用于在本机接管流量,不代表客户端提供远端服务器。若连接在后台中断,再检查电池优化和后台运行限制,避免先反复修改协议参数。

前往下载

Linux

v2rayN · 区分发行版

根据发行版的软件包体系选择 deb 或 rpm,再确认设备是 x64 还是 arm64。软件包格式与处理器架构必须同时匹配。桌面环境不同,系统代理设置的入口也可能不同,安装后应先确认客户端能够正常启动并读取配置。

浏览器通常可以使用桌面环境提供的代理设置,终端程序则未必自动跟随。遇到浏览器可访问、命令行失败的情况,先检查程序是否支持代理及其环境变量,而不是直接切换服务器。需要接管更多应用时,再阅读 TUN 模式的权限与路由说明。

前往下载

客户端下载、远端服务与订阅是三个不同环节。安装包只提供本机工具,连接所需的服务器地址、认证信息与传输参数,需要由使用者合法取得并妥善保管。

查看全部客户端
配置顺序与核心功能

从订阅管理到路由分流

先让一份配置正常连接,再逐步调整代理范围。下面的界面是设置示意,菜单名称和选项位置可能随客户端及内核变化,以实际界面为准。

订阅分组设置 · 示意
分组备注
日常配置
订阅地址
粘贴服务方提供的完整地址
更新方式
更新当前订阅(不通过代理)
保存地址后仍需更新订阅

订阅用于集中获取和更新服务器配置,适合需要定期同步参数的场景。在 v2rayN 中添加订阅分组,填写备注并粘贴完整地址,保存后再更新当前订阅;安卓端也要区分订阅分组与单条链接导入。分组地址不会自动变成可用服务器,必须成功获取内容。首次配置可先尝试不通过代理更新;失败后核对地址、网络与日志。更新前保留手动配置,分享截图时遮住地址中的凭据。

查看订阅导入步骤

连接验证:一次只改变一项设置

完成订阅更新后,先选中一条配置并启动内核,确认日志没有配置解析或端口占用错误,再打开系统代理。用支持代理的浏览器访问明确的测试目标,同时检查原本可以直连的站点和局域网设备。测试结果要和使用场景对应:订阅能更新,只说明订阅地址可达;内核能启动,只说明配置可以加载;浏览器能访问,也不能证明所有应用都已走代理。

如果失败,记录刚才修改的项目和对应错误,先撤销最近一步。不要同时更换内核、开启 TUN、修改 DNS 并重写路由,否则很难判断是哪一项产生影响。需要接管不读取系统代理的程序时,再进入完整手册学习 TUN;普通浏览器场景可以先从系统代理开始。

按阶段阅读完整手册
Project V 生态与维护依据

区分客户端、内核与服务

看懂这三层关系,比单独记住一个软件名称更有用。下载客户端解决本机操作入口,选择内核解决配置兼容性,远端服务则决定连接参数从哪里取得。

Project V V2Fly Xray

Project V:先理解生态背景

Project V 是围绕网络代理工具形成的开源生态,V2Ray 是其中广为人知的项目。日常搜索中的“V2Ray”有时指内核,有时泛指兼容配置或整套使用方式,因此不能仅凭这个词确定应下载哪一个安装包。图形客户端把底层配置组织成菜单、分组和开关,使用户不必每次手写完整配置,但协议、传输方式与认证信息仍需要准确对应远端。

本站将安装与连接分开讲解:先按设备选择图形客户端,再解释订阅提供哪些参数,最后说明系统代理和路由如何影响应用流量。这种顺序便于把问题定位到具体环节,也避免把“客户端已打开”误认为“所有网络请求都已按预期转发”。

V2Fly 与 Xray:相关但不完全相同

V2Fly 社区延续了 V2Ray 的维护与开发;Xray 从相关代码发展而来,并持续演进自身功能。两者共享部分技术背景,但协议扩展、配置字段及更新节奏存在差别。VMess、VLESS、Trojan 属于需要分别理解的协议类型,REALITY 则涉及连接安全层的具体机制,不应把这些名称视作可以随意替换的按钮。

选择配置时,先核对提供方要求的协议、传输方式和内核能力,再检查 TLS 服务器名称等字段。某项功能在一个内核可用,并不意味着另一个内核会自动兼容。旧教程中的默认值也未必适合当前构建;遇到不认识的参数,保留原始配置并查阅对应说明,优于凭名称相似就手工改写。

三款开源客户端:操作入口各有侧重

v2rayN 面向桌面系统,提供服务器管理、订阅分组、系统代理和路由设置等图形入口。跨平台构建与经典界面在操作位置上可能有所不同,但首先导入配置、再确认内核与代理范围的逻辑一致。桌面端需要特别注意本地监听端口和退出后的系统代理状态;修改端口时,也要同步调整使用该端口的应用。

v2rayNG 面向安卓设备,采用 Xray 内核,常见导入入口包括剪贴板、二维码及订阅分组设置。安卓端通过系统 VPN 接口接管流量,因此授权提示、按应用代理和后台运行设置都可能影响使用结果。二维码只是承载配置内容的一种方式,扫描成功不代表远端配置一定有效,也不代表订阅已经完成更新。

v2flyNG 是采用 V2Fly 内核的安卓备选客户端,适合需要对应内核行为或配置兼容性的场景。选择它应基于实际配置要求,而不是把多个客户端同时启动当作排查方法。系统通常只允许一个 VPN 服务处于活动状态,切换客户端前先停止原有连接,并在新客户端重新核对导入内容和代理范围。

开源协议:了解代码与许可的边界

这三款客户端均以开源项目形式提供代码。v2rayN 使用 GPL-3.0 许可,v2rayNG 与 v2flyNG 使用 GPL-3.0 系列许可;V2Fly 与 Xray 内核采用 MPL-2.0 许可。具体使用、修改和再分发义务应以所用构建附带的许可证及依赖说明为准,客户端、内核和附带组件不能简单当作一份相同许可处理。

代码开源意味着实现可以被阅读与讨论,不等于每一个远端服务都值得信任。订阅中的地址可能含有认证凭据,日志也可能暴露服务器信息;求助时只保留必要错误上下文,遮盖访问凭据、订阅地址和个人信息。客户端的开源属性与服务提供方的经营方式是两个独立问题,需要分别判断。

更新机制:先备份,再观察变化

客户端、内核、路由资源和订阅内容有各自的更新来源与节奏。更新订阅主要同步远端配置,不会替代客户端升级;更新客户端也不保证订阅地址仍然有效。遇到连接异常时,先看近期改变了哪一层,再决定是否更新。升级前记录当前代理模式、路由选择及自定义端口,备份设置,避免把升级与大量配置修改同时进行。

社区维护会带来功能调整和问题修复,也可能改变菜单名称或默认行为。教程因此以操作目的为主,而不是要求每个按钮都处于固定位置。更新后先检查能否正常启动,再验证日常应用和直连目标;确认新设置稳定后,再清理旧备份。若问题持续出现,可按日志中的配置解析、DNS、连接建立和 TLS 错误分别排查。

了解本站内容定位
技术笔记 · 最近更新

按现象查找排查步骤

已经完成基础配置,却遇到某个具体问题时,从对应现象进入笔记。先保存错误提示,再按从本机到远端的顺序缩小范围,避免把所有连接失败都归因于同一个设置。