Windows
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留熟悉的 Windows 操作布局。新安装可以先了解桌面版;已有使用习惯时,再对照两种界面的菜单位置选择。导入订阅的基本思路一致,不需要为了换界面重新申请订阅。
安装前查看系统架构与安装说明。启动后先完成订阅更新,再选择服务器和系统代理。若退出客户端后浏览器仍提示代理连接失败,先查看系统代理是否已经恢复,不要直接把问题归到服务器。
前往下载从开源客户端选择开始,把订阅导入与路由设置分开讲清。
导入成功不等于浏览器已经使用代理。先辨认设置项负责的环节,再调整参数,能少走很多重复操作。
订阅分组设置
别名:日常订阅
地址:https://example.com/sub?token=xxxx
启用更新:开启
订阅是一份可更新的服务器配置清单,地址通常由服务提供方给出。把完整地址填入订阅分组,保存后执行更新,客户端才会读取其中的配置。它与单个服务器分享链接不同,也不是登录网页的地址。更新失败时,先检查链接是否完整、是否过期,再看获取订阅时使用的网络路径。不要反复删除已有分组,更不要把带有个人令牌的地址贴进公开截图。订阅只负责取得配置,后面的系统代理与路由仍需分别设置。
系统代理
○ 清除系统代理
● 自动配置系统代理
○ 不改变系统代理
系统代理是在操作系统里登记客户端的本地代理入口,主要影响愿意读取这项设置的应用。新手可先选择自动配置系统代理,用浏览器测试基本连接。某个程序没有变化,不一定是服务器失效,它可能使用独立的网络设置。TUN 则通过虚拟网络接口接入流量,覆盖方式和权限要求都不同。先把普通系统代理跑通,再判断是否需要 TUN;同时开启多个接管网络的工具,反而容易让请求绕错入口。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
路由是在请求已经进入客户端之后,决定它走直连还是代理。上面的规则表示把私有地址交给名为 direct 的出站,实际配置还必须存在对应出站。客户端里的预设路由把常见规则打包成菜单,适合先建立可用的基础配置。分流异常时,检查规则顺序、域名匹配与规则数据文件,而不是只切换服务器。系统代理负责把请求送进来,路由负责送往哪里,两者不能互相替代。
图形界面 → 生成配置 → 代理内核
v2rayNG → Xray
v2flyNG → V2Fly
v2rayN → 按配置选择支持的内核
客户端界面负责管理配置,内核负责实际处理协议与网络连接。名称相近不代表功能完全相同,选择时应看服务端需要的协议、传输和安全参数。比如涉及 REALITY 的配置,需要确认所用内核及客户端导入功能能够支持,不能只看有没有 VLESS 菜单。已有配置能稳定运行时,不必为了名称切换内核。遇到不支持的字段,先核对协议说明与客户端更新记录,再决定更换客户端或调整配置。
排查顺序
本地入口 → DNS → 远端连接 → 握手
记录:操作时间、目标域名、错误原文
分享前:隐藏地址令牌与认证信息
日志的价值在于指出连接在哪一段停止,而不是给客户端打一个好坏分数。先记录触发故障的操作,再找同一时间附近的错误。连接拒绝、超时与握手失败对应的可能原因不同,不能套用同一组参数解决。每次只改一项,保留修改前的配置,测试后比较结果。向他人求助时提供客户端名称、系统类型和经过脱敏的错误原文,比只说不能连接更有帮助,也能避免暴露订阅与认证信息。
桌面选择 v2rayN,安卓优先了解 v2rayNG。先核对系统与处理器架构,再选择安装包;软件名称相近,安装包不能跨平台混用。
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留熟悉的 Windows 操作布局。新安装可以先了解桌面版;已有使用习惯时,再对照两种界面的菜单位置选择。导入订阅的基本思路一致,不需要为了换界面重新申请订阅。
安装前查看系统架构与安装说明。启动后先完成订阅更新,再选择服务器和系统代理。若退出客户端后浏览器仍提示代理连接失败,先查看系统代理是否已经恢复,不要直接把问题归到服务器。
前往下载v2rayN 的 macOS 安装包按 Apple Silicon 与 Intel 芯片区分。可以在系统的“关于本机”中查看芯片或处理器信息,再选对应架构。安装包能够下载,并不代表系统已经允许应用启动,首次打开还可能需要处理系统安全提示。
系统代理与 TUN 需要的授权并不相同。先用常规代理方式确认订阅和服务器可用,再按需要授予额外网络权限。遇到启动拦截时,阅读具体提示,按照系统设置中的放行流程操作,不要随意关闭整套安全机制。
前往下载v2rayNG 使用 Xray 内核,是这里的安卓首推选择;v2flyNG 使用 V2Fly 内核,作为另一条配置路线。两者都提供 arm64 与通用安装包,较新的主流设备通常可先查看 arm64 选项,无法确定架构时再阅读下载页的选择说明。
首次连接出现系统 VPN 授权提示属于建立本地网络接口的步骤。允许后仍需选择有效的服务器配置。若锁屏后频繁断开,可检查系统对后台活动与电池使用的限制;不要把手机的省电策略误判为订阅失效。
前往下载v2rayN 的 Linux 安装包按 deb、rpm 格式和处理器架构区分。先看发行版使用的软件包体系,再确认 x64 或 arm64。不要只因为文件能够打开就继续安装,包格式、架构和桌面环境的依赖都需要对应。
不同桌面环境对系统代理的读取方式可能不同,终端程序也不一定继承桌面代理设置。验证时先选一个明确遵循代理设置的应用,再逐步检查其他程序。若需要 TUN,继续查看平台指南中的权限与网络接管说明。
前往下载客户端本身不附带可用的远端服务。开始前需要准备有效的订阅地址或分享链接,并确认它适用于所选客户端与内核。
在 v2rayN 中打开订阅分组设置,填写便于辨认的别名和完整订阅地址,保存后执行订阅更新。在 v2rayNG 中,通过订阅设置添加地址,再回到主界面更新订阅。粘贴前后留意空格、换行与截断,尤其不要把服务提供方的管理页面地址当成订阅地址。
更新完成后检查是否出现预期的服务器配置。若列表仍为空,先看更新结果与日志;若已有旧配置,保留它作为对照。订阅令牌相当于访问配置的凭据,整理截图或寻求帮助时应隐藏完整地址,不要只遮住域名而留下查询参数。
桌面端先选定要使用的服务器,再设置自动配置系统代理,并从内置路由预设开始。安卓端选定配置后点击连接,按系统提示允许建立 VPN 接口。菜单名称会随界面调整,但“选配置”和“让应用请求进入客户端”始终是两件事,缺少后者时浏览器可能仍然直接连接。
不要一开始就叠加多个网络接管方式。系统代理适合先验证常见浏览器,TUN 适合进一步处理不读取系统代理的应用,但会增加权限、DNS 与路由排查成本。局域网设备访问异常时,也应先检查绕过局域网的设置,而不是盲目换协议。
先访问一个日常使用、能够明确判断结果的网页,再测试目标应用。客户端内置的连通性测试只能说明测试条件下的结果,不能保证所有网站和应用都能正常工作。部分网站可能有自己的访问限制,单个网页失败不应直接推断整份订阅不可用。
出现异常时记录时间、应用与错误现象,打开日志查同一时段的信息。先确认客户端仍在运行、本地入口正常,再检查 DNS、远端连接与握手。每次修改后重复相同测试,才能比较前后结果。完整步骤与平台差异放在教程中,首页只保留这条最短操作顺序。
先区分项目、内核和图形客户端,再比较协议支持。名称之间有历史联系,但并不是同一个软件的三个皮肤。
V2Ray 是 Project V 生态中的核心项目,围绕可配置的网络代理构建协议、传输与路由能力。用户日常操作的图形界面,通常是在这些能力之上提供服务器管理、订阅更新和设置入口。搜索“V2Ray 客户端”时,真正需要的往往是这样的图形程序,而不是直接编辑内核配置文件。
这一层区分很实用:界面里的一个勾选项可能影响客户端行为,也可能被转换为内核配置。订阅管理、窗口布局与系统代理开关主要属于客户端层;协议握手、出站连接和规则匹配则由相应内核执行。遇到问题时先确定属于哪一层,才能找到对应文档,避免拿另一款客户端的菜单名称逐字寻找。
V2Fly 社区延续 V2Ray 相关开发,Xray 则从相关代码基础发展为另一条内核路线。它们共享一部分概念与配置习惯,但功能演进、协议细节和字段支持并不完全同步。不能因为两边都能看到 VLESS,就认为任何相关配置都可以原样通用,更不能仅凭文件名判断兼容性。
选择内核时,应把服务端要求放在前面:协议是什么、使用哪种传输、是否需要特定安全机制、客户端能否完整导入这些字段。REALITY 等能力需要具体核对支持情况。若订阅已提供匹配客户端的导入方式,优先遵循其配置说明;不清楚的参数先查询协议与传输术语,不要根据名称猜测。
v2rayN 面向桌面使用,提供订阅管理、服务器选择及代理相关设置;v2rayNG 面向安卓,使用 Xray 内核;v2flyNG 同样面向安卓,使用 V2Fly 内核。它们的源代码按各自开源许可提供,具体使用和再分发条件以项目许可为准。开源描述的是代码与许可条件,不等同于远端服务的质量证明。
客户端可以免费获取,但订阅背后的远端服务是独立事项,服务提供方的账户、费用与可用范围不会因安装客户端而自动获得。订阅地址也不应交给不相关的网站代为解析。本站定位是客户端下载与配置说明,阅读教程时应始终区分“工具怎样工作”和“服务由谁提供”,两者的更新与故障来源并不相同。
客户端更新通常涉及界面、导入逻辑与平台兼容;内核更新影响协议实现和运行行为;GeoIP、GeoSite 数据文件更新则改变部分路由规则依赖的数据。更新订阅只能刷新服务提供方给出的配置,不能替代这三类更新。路由异常时反复更新订阅,往往不会改变已经过期的规则数据。
调整前先保留可恢复的配置记录,更新后按原来的应用和网址重新验证。如果新界面的菜单位置变化,可以对照功能名称,而不是继续寻找旧截图的坐标。涉及较多平台差异时,阅读全平台指南;遇到明确报错时,先保存脱敏后的错误原文,再按照本地到远端的顺序定位。
基础连接完成后,再沿实际问题继续阅读。下面三篇分别对应找菜单、处理首次启动权限和维护分流数据,不需要一次改完所有设置。
按区块走一遍 v2rayN 主窗口,说明服务器列表、订阅分组、底部日志、系统代理切换和参数设置分别管什么,新手看完即可找到常用操作。
针对 macOS 首次打开 v2rayN 被拦截的情况,讲清在隐私与安全性中放行、授予网络与系统代理权限的步骤,以及 TUN 模式需要的额外授权。
解释 GeoIP、GeoSite 两个数据文件在分流中的作用,演示在 v2rayN 和 v2rayNG 里更新规则文件,以及 geosite:cn 这类写法的含义。
查看全部文章 →