Windows
首选 v2rayN 桌面版;已有经典界面使用习惯时,可比较 WPF 版。桌面版采用跨平台界面,WPF 版面向此系统,两者的菜单布局和运行依赖可能不同。遇到教程截图不一致时,先确认所用界面类型,再寻找同名设置。
压缩包先完整解压到有写入权限的位置。首次运行若出现依赖提示,按安装包说明补齐环境;不要从其他目录拼凑可执行文件。升级前保存配置,退出旧程序后再处理文件,避免两个实例争用监听端口。
前往下载 Windows 客户端按系统选择客户端,查找安装配置、订阅导入与路由分流的设置位置和操作顺序。
v2rayN 使用教程
先让一个服务器正常连接,再调整分流和 TUN。下表以桌面界面为线索;不同发行版的菜单名称可能略有变化,请结合当前界面与日志核对。
| 设置项 | 作用说明 | v2rayN 桌面 |
|---|---|---|
解压目录 → 运行 v2rayN.exe | 压缩包应完整解压到可写目录,再从目录内启动程序。不要只把主程序拖出压缩包,也不要直接在压缩软件中运行,否则随附内核、依赖和数据目录可能无法正常读取。 | 完整目录运行 |
设置 → 参数设置 → Core 基础设置 | 先保留默认监听配置,确认内核能够启动,再导入一个可用服务器。若日志提示端口占用,检查已有代理程序后再改端口;依赖报错则按所选安装包的要求补齐运行环境。 | 界面与内核分别检查 |
| 设置项 | 作用说明 | v2rayN 桌面 |
|---|---|---|
订阅分组 → 订阅分组设置 | 为每个订阅来源建立独立分组,填写容易识别的备注与完整订阅地址。分组用于整理服务器,不代表已经连接;保存后仍需更新订阅,并从返回的服务器列表中选择活动项。 | 按来源维护分组 |
订阅分组 → 更新全部订阅 | 更新会按来源内容刷新列表,手动改过的订阅条目可能被覆盖。更新失败时先读日志,区分网络请求失败和内容解析失败,再检查地址是否到期,避免反复删除分组丢失线索。 | 更新结果查看日志 |
| 设置项 | 作用说明 | v2rayN 桌面 |
|---|---|---|
系统代理 → 自动配置系统代理 | 把系统代理指向客户端的本地监听入口,供遵循系统代理设置的应用使用。选择服务器后启用,再在浏览器发起请求;界面显示运行只说明服务已启动,并不能证明应用已经接入。 | 适合先验证浏览器 |
系统代理 → 清除系统代理 | 停止使用时可清除系统代理,防止程序关闭后应用仍请求本地端口。手动填写代理的应用需要单独恢复;不遵循系统代理的应用,应检查自身网络选项,而不是立即更换所有服务器。 | 退出前检查残留设置 |
| 设置项 | 作用说明 | v2rayN 桌面 |
|---|---|---|
路由设置 → 绕过大陆(Whitelist) | 路由决定已进入内核的请求如何选择出口,和系统代理不是同一层设置。先选一个内置规则验证效果,再按目标域名调整;规则名称只是摘要,具体去向仍取决于匹配条件与顺序。 | 内置规则起步 |
设置 → 路由设置 | 添加自定义规则前先保存现有配置,并确认需要直连还是代理。域名规则与地址规则可能得到不同结果,排查时应同时留意域名解析方式,每次只改一项,便于从日志判断命中情况。 | 规则与解析一起核对 |
| 设置项 | 作用说明 | v2rayN 桌面 |
|---|---|---|
主界面 → 启用 TUN | TUN 通过虚拟网络接口接管流量,可用于部分不遵循系统代理的应用。启用前先确认普通代理可用,再按系统提示授予所需权限;是否可用还取决于随附组件、系统环境及当前设置。 | 基础连接正常后启用 |
设置 → 参数设置 → TUN 模式设置 | 与其他虚拟网卡或网络工具同时运行时,可能出现路由和域名解析冲突。出现断网先关闭 TUN 对比,再逐项检查解析、接口和权限,不宜把所有接管功能同时打开来代替定位问题。 | 支持范围以当前构建为准 |
第一次配置不必同时调整所有选项。按“启动内核 → 导入服务器 → 设置活动服务器 → 配置系统代理 → 发起请求”的顺序验证,能分清错误发生在数据导入、本地监听还是远端连接。服务器测试结果只反映对应测试条件,不能代替实际应用访问。
查看 v2rayN 安装配置完整步骤 →客户端与系统选择
桌面设备先看 v2rayN,安卓设备先看 v2rayNG。下载前核对操作系统、处理器架构与安装格式;同一客户端的不同安装包并不适合任意互换。具体入口与系统要求在下载页集中列出。
首选 v2rayN 桌面版;已有经典界面使用习惯时,可比较 WPF 版。桌面版采用跨平台界面,WPF 版面向此系统,两者的菜单布局和运行依赖可能不同。遇到教程截图不一致时,先确认所用界面类型,再寻找同名设置。
压缩包先完整解压到有写入权限的位置。首次运行若出现依赖提示,按安装包说明补齐环境;不要从其他目录拼凑可执行文件。升级前保存配置,退出旧程序后再处理文件,避免两个实例争用监听端口。
前往下载 Windows 客户端使用 v2rayN 桌面版,按芯片选择 Apple Silicon 或 Intel 安装包。可先打开“关于本机”查看芯片信息,再对照下载入口;不要只凭电脑的外观或购买年份判断架构。界面与桌面教程相近,但权限确认应以系统实际提示为准。
安装后先导入一组服务器,确认内核运行与浏览器请求都正常。若需要 TUN,再单独处理相关授权。系统代理、应用自带代理与虚拟网卡接管处于不同层级,排查时应明确当前使用哪一种入口,避免多个入口互相干扰。
前往下载 macOS 客户端优先选择使用 Xray 内核的 v2rayNG;需要 V2Fly 内核生态时,再了解 v2flyNG。多数近年的主流手机适合 arm64 包,无法确定架构时可查看通用包说明。安装前仍应核对设备条件,通用包也不是系统兼容问题的通用解法。
首次连接需要确认系统的 VPN 连接授权。订阅导入完成后,仍要选择服务器并启动连接;只有列表里出现条目不代表服务已经启用。若切到后台后连接中断,再检查电池优化与后台运行限制,不要先把有效订阅反复删除重建。
前往下载 Android 客户端使用 v2rayN 桌面版,根据发行版的软件包体系选择 deb 或 rpm,再核对 x64 与 arm64 架构。软件包格式决定安装管理方式,架构决定程序能否在处理器上运行,二者都需要匹配;仅修改文件扩展名不能转换安装格式。
安装后先验证桌面会话中的普通代理连接,再考虑 TUN 所需权限。部分应用不会自动读取桌面环境的代理设置,需要在应用内单独指定入口。出现局部应用无法访问时,应先检查代理继承方式,而不是直接修改整个系统的路由。
前往下载 Linux 客户端客户端负责读取配置与建立连接,订阅则由对应来源提供。下载安装客户端不会自动生成服务器,也不会自动恢复已经到期的订阅。若已有订阅,保留原始地址并确认可用状态;若只有单个分享链接,应使用服务器导入入口,而不是把它当作订阅地址填写。
查看全部客户端 →Project V · V2Fly · Xray
先分清内核、客户端和订阅,再决定需要更新或修改哪一部分。名称相近不等于功能完全相同,配置能导入也不等于所有连接条件都已满足。
Project V 是理解 V2Ray 生态的起点,其中的代理内核负责协议处理、传输、路由与连接建立。V2Fly 社区延续 V2Ray 相关项目的维护,Xray 则从相关技术基础上发展出自己的内核与功能路线。日常交流常把整个生态统称为 V2Ray,但具体功能是否可用,需要看客户端实际调用的内核,以及该内核是否实现对应选项。
VMess、VLESS 和 Trojan 是协议名称,WebSocket、gRPC 等属于传输方式,TLS 与 REALITY 又涉及连接的安全与握手设置。这些名称不处于同一层级,不能只凭其中一个词判断配置是否完整。连接参数应与服务器端一致;手动修改时要明确修改的是协议、传输还是安全选项,不能把不同教程中的字段随意拼在一起。
v2rayN、v2rayNG 与 v2flyNG 都属于开源图形客户端。图形界面让用户维护服务器、订阅地址和常用选项,再把这些信息转换为内核可以读取的配置。它们并不是同一个程序的三种皮肤:v2rayN 面向桌面环境,v2rayNG 主要围绕 Xray 内核提供安卓配置入口,v2flyNG 则作为 V2Fly 内核路线的安卓备选。
这种分层也决定了排查顺序。窗口无法打开,应先看安装与运行环境;窗口正常但内核启动失败,应看日志、监听端口和配置生成结果;内核运行而某个服务器连接失败,再核对远端参数与网络条件。把界面启动成功当作连接成功,容易跳过真正需要检查的环节。涉及跨内核迁移时,还要核对协议和高级选项是否都能被目标客户端表达。
开源意味着软件代码按对应许可证公开,并在许可证规定的条件下使用、修改和分发。生态中的不同项目可能采用不同许可证;以 V2Fly 的 V2Ray 核心和 Xray 核心为例,它们采用 MPL 2.0。客户端项目有各自的许可说明,不能把某一个内核的许可证直接套用到所有界面程序、依赖与附带资源上。需要再分发或修改时,应分别阅读相关项目的许可文件。
开源属性与订阅服务质量是两件事。订阅地址、服务器凭据和本地配置依然需要妥善保管;共享截图时应遮住完整订阅链接,导出的配置也不适合公开发送。使用订阅转换服务前,要理解对方可能读取完整配置。优先确认客户端能否直接导入原始格式,确需转换时再评估处理范围,而不是把“格式转换”当成所有导入失败的第一步。
客户端更新、内核更新、订阅更新和路由资源更新各自解决不同问题。客户端更新通常影响界面与配置生成;内核更新影响协议实现和运行行为;订阅更新刷新来源提供的服务器;规则与域名资源更新则可能改变分流结果。遇到异常时先记录最近改动,不要同时更新所有组件,否则很难判断是哪一项改变了行为。
日常维护可以从保存配置开始。升级前记录当前系统代理、监听端口和路由选择,备份中如含订阅地址与凭据,应放在受控位置。升级后先用原有设置检查内核启动,再做实际请求,最后验证自定义分流。若只有特定应用异常,优先比较该应用与浏览器的代理入口;若所有请求都失败,再检查本地服务和当前服务器。
系统代理解决“哪些应用把请求交给客户端”,路由规则解决“请求进入内核后走哪个出口”,TUN 则通过虚拟网络接口接管流量。这三个概念经常出现在同一教程中,但不能互相替代。启用系统代理后仍有应用直连,可能只是应用没有读取系统设置;启用 TUN 后访问异常,也可能与域名解析、网卡路由或其他网络工具有关。
建议先使用系统代理完成基础验证,再按需要调整路由,最后评估是否启用 TUN。每次修改后,用相同应用访问相同目标,并查看相应时间的日志。这样得到的对比更有意义。日志可能包含服务器信息,向他人求助前应清理敏感内容,同时保留错误类型、发生顺序与设置背景,便于继续排查。
安装与故障排查文章
按具体症状选择文章。记录操作前后的变化、当前界面类型与日志中的错误信息,比重复导入相同配置更有助于定位问题。
从选择桌面版或 WPF 版开始,依次讲解解压位置、运行库依赖、首次启动、系统代理设置,并整理 Windows 上最常见的几类报错及其处理办法。
阅读安装步骤 →启动时提示端口被占用?本文介绍用系统命令找出占用进程的方法,说明在参数设置里修改本地 SOCKS 与 HTTP 监听端口的步骤,以及改端口后需要同步调整的地方。
阅读端口排查步骤 →订阅链接过期、返回格式不对、更新时走了代理或被拦截,都会导致解析失败。本文按从易到难的顺序,列出可以逐条核对的排查步骤。
阅读订阅自查清单 →