订阅导入 →
把服务提供方给出的订阅地址保存到分组,再执行更新。订阅是获取配置的入口,不等于客户端本身;安装完成后仍需准备可用的连接资料。
配置主题
把服务提供方给出的订阅地址保存到分组,再执行更新。订阅是获取配置的入口,不等于客户端本身;安装完成后仍需准备可用的连接资料。
先用系统代理验证浏览器访问,再判断是否需要 TUN。接管方式决定哪些应用流量进入客户端,路由规则则决定进入后的流量走向。
先测连接能否建立,再检查目标网页和出口地址。单次延迟不能代表下载速度,也不能替代对 DNS、规则命中与实际访问结果的检查。
多个来源的服务器放在同一列表里,容易混淆更新范围。先在“订阅分组设置”中填写易辨认的备注,粘贴完整订阅地址,保存后执行更新。v2rayN 可按分组筛选服务器,v2rayNG 也可通过订阅分组管理入口维护来源。与逐条粘贴连接链接相比,订阅更适合批量刷新,但更新结果取决于服务方返回的内容。若列表为空,先核对地址、有效期与网络,不要反复重装客户端。订阅地址通常包含访问凭据,截图或求助时应遮住完整地址。
订阅分组与过滤实践 →https://example.com/sub?token=xxxx设置示意,需在客户端内操作。
系统代理适合先验证浏览器及遵循系统代理设置的应用;未遵循该设置的程序,可能仍然直连。TUN 通过虚拟网络接口接管流量,通常还涉及管理员权限、路由与 DNS。v2rayN 中应先确认普通代理连接可用,再按需要启用 Tun 模式,避免一次改变太多变量。v2rayNG 的首次连接则需要确认系统 VPN 授权。与只设置浏览器代理相比,TUN 的接管范围更广,但不能修复失效订阅或错误的服务器参数。退出客户端前也要确认系统代理已经恢复。
查看各平台权限要求 →路由分流负责决定进入客户端的请求从哪个出口发送,不负责让应用自动使用代理。初次使用可先选内置“绕过大陆”规则,理解访问结果后再添加自定义域名或 IP 条目。与全部请求交给代理相比,分流能为本地服务、内网地址与特定网站保留独立路径。自定义规则通常按顺序匹配,应把范围明确的例外放在宽泛规则之前,并检查 DNS 解析位置是否符合预期。修改后用同一目标重复验证,记录改动,避免同时更换服务器、规则和解析方式。
查看路由规则实战 →图形客户端负责管理与操作,实际建立连接的是内核。v2rayN 可按客户端提供的选项管理不同内核;v2rayNG 使用 Xray 内核,v2flyNG 则提供 V2Fly 内核方向的备选。与只看客户端名称相比,核对内核支持的协议、传输和安全选项,更能判断配置能否使用。不同内核的参数并非完全通用,切换前应保留原设置,确认服务方要求,再测试一条已知可用的配置。不要仅因某个内核更新就切换整套环境,优先解决明确的兼容需求。
区分客户端与内核 →TCPing 主要反映到目标端口的连接情况,真连接测速还会经过代理链路访问测试目标。与只看端口可达性相比,真连接测试更接近实际请求,但仍受测试地址、网络拥塞与服务端策略影响。导入订阅后,先选择一组服务器测试,再设定活动服务器,用浏览器访问目标网页并检查出口地址。出现超时时,按本地端口、代理状态、订阅时效、系统时间与传输参数逐层排查。不要把一次测试失败直接判断为客户端损坏,也不要把较低延迟等同于更高带宽。
首次连接与验证步骤 →安装包入口
桌面设备优先选择 v2rayN;安卓设备优先选择 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。安装包要同时匹配操作系统、处理器架构与打包格式,不能只凭文件名中的客户端名称判断。下面的入口会打开下载页并定位对应平台,具体安装要求也在该页集中说明。
客户端负责读取连接配置,不附带可用的订阅服务。安装前准备好服务提供方交付的订阅地址或连接链接,并确认设备时间准确、网络可以正常访问。已有其他代理工具时,先停止其代理接管,避免端口和系统网络设置互相影响。
下载页提供桌面版与经典 WPF 版两个入口。桌面版采用新一代跨平台界面,WPF 版保留经典操作布局;选择时结合系统要求和既有使用习惯,不必为了尝试界面而同时运行两套代理。
首次安装应放在有写入权限、便于长期保留的目录,按包内说明启动。先导入订阅,确认内核能正常运行,再开启系统代理。需要 TUN 时,再核对权限与虚拟网卡状态;不要把管理员权限当作所有连接问题的通用解法。
前往下载 →先在系统的“关于本机”中查看芯片信息,再选择 Apple Silicon 或 Intel 安装包。架构匹配能减少兼容层带来的不确定性;不要把两种安装包理解为功能等级不同,它们首先对应不同的处理器平台。
将应用安装到常用应用目录,首次打开遇到系统提示时,按系统安全设置核对应用来源与允许选项,不要直接关闭整套安全机制。连接前检查已有的网络代理配置,连接后再验证浏览器访问。涉及 TUN 的步骤,以客户端提示和当前系统授权要求为准。
前往下载 →优先使用基于 Xray 内核的 v2rayNG,V2Fly 内核需求可选择 v2flyNG。近年的主流手机通常适合 arm64 包;无法确认设备架构时,可在下载页查看通用包说明,再结合设备信息选择。
安装时仅对当前可信来源授予必要权限。添加订阅分组、更新配置并选中服务器后,点击连接并确认系统 VPN 授权。同一时间通常只能由一个应用接管该通道;若后台断开,应检查省电策略与后台运行限制,而不是不断重复导入同一份订阅。
前往下载 →按发行版的软件包体系选择 deb 或 rpm,并核对 x64、arm64 架构。deb 常用于 Debian、Ubuntu 等发行版,rpm 常用于 Fedora 等发行版;衍生发行版仍需查看自身的软件包与依赖说明。
安装后先在桌面会话中验证客户端启动和本地监听,再检查浏览器是否遵循桌面环境的系统代理设置。不同应用读取代理的方式可能不同,因此浏览器可访问不代表所有进程都已接管。需要 TUN 时再处理额外权限与路由,避免直接以高权限长期运行所有桌面操作。
前往下载 →快速上手预览
每次只改变一个环节。先让配置进入客户端,再确定接管范围,最后验证实际请求;这样即使出现异常,也能知道应该回到哪一步检查。
在 v2rayN 中打开订阅分组设置,为来源填写备注,完整粘贴订阅地址后保存,再执行更新订阅;在 v2rayNG 中从订阅分组入口完成相同准备。复制时注意首尾空格、缺失参数和换行,网页上的登录地址通常不能直接当作订阅地址使用。
更新后先确认当前分组确实出现了服务器。列表为空时,查看更新提示,核对服务是否有效、网络是否能访问订阅入口。已有配置不要急着全部删除,可先备份原设置,再单独验证新分组,避免排查时失去原本可用的参照。
对准备使用的服务器进行真连接测试,再设为活动服务器。桌面端先选择自动配置系统代理,并使用默认或内置的路由方案完成基础验证;安卓端选中配置后点击连接,阅读并确认系统 VPN 授权提示。界面的连接状态只说明接管流程已经启动,仍需下一步的实际访问测试。
系统代理、TUN 与路由不是同一组开关。前两者解决流量如何进入客户端,路由决定进入后的出口。普通浏览器访问正常以后,再按应用需求开启 TUN 或增加规则。若设备上还有其他代理、网络加速或 VPN 工具,应先暂停它们的接管功能。
打开一个明确需要通过代理访问的目标,检查页面能否完整加载,再用可信的出口地址查询服务确认请求路径。测试前注意浏览器缓存和独立代理扩展,必要时使用新的浏览器会话。真连接测试成功而网页失败时,优先比较两者的目标、DNS 与路由,而不是只更换服务器。
确认可用后,记下活动分组、代理方式和路由选择,作为后续调整的基线。故障发生时先恢复这套组合,再检查订阅是否过期、本地端口是否冲突和系统时间是否准确。求助时可以提供经过遮挡的错误提示与操作步骤,不公开订阅地址和连接凭据。
静态界面示意。网页中的设置不会改变设备网络,请在客户端内操作。
订阅更新失败,先看地址与访问条件;列表存在但连接失败,先看服务器参数与内核日志;只有某个应用失败,先看接管范围与路由。把问题缩小到一层,再决定是否调整设置。
按现象查找常见问题 →开源生态与维护
V2Ray 不是一款固定界面的软件名称。Project V 生态围绕代理协议、传输方式与路由能力发展,图形客户端把这些能力组织成订阅、服务器、代理模式与日志等可操作的入口。理解这层分工,比记住某个按钮的位置更有用。
本站整理三款客户端的安装入口与中文配置说明。客户端软件、内核项目和提供订阅的服务方各有职责:客户端不会自动生成可用的服务,内核能够识别协议也不代表服务端配置一定正确,订阅是否有效仍由服务提供方决定。
Project V 提供理解 V2Ray 体系的背景。V2Fly 持续维护 V2Ray 相关项目,Xray 则是从相关技术体系发展出的另一条内核路线。两者存在共同概念,但功能演进、协议支持与配置细节并不完全相同。教程中看到的协议名、传输类型和安全选项,最终都需要所用内核支持。
因此,遇到导入成功却无法运行的配置,应核对协议与内核能力,而不是只看客户端能否显示该条目。服务方给出的配置说明、客户端当前内核选项和错误日志,应放在一起判断。术语相近不等于参数可以直接互换。
v2rayN 是面向桌面系统的开源图形客户端,适合集中管理订阅、系统代理与路由。v2rayNG 面向安卓,采用 Xray 内核,适合移动设备上的配置导入和连接管理。v2flyNG 同样面向安卓,为需要 V2Fly 内核的用户提供另一种选择。三者都是客户端,不是订阅服务的销售入口。
选择时先看设备平台,再看服务方使用的协议和传输配置。没有明确兼容需求时,桌面优先使用 v2rayN,安卓优先使用 v2rayNG;已有稳定环境则先保留设置,不必为了名称差异反复迁移。不同客户端的界面与导出格式可能不同,迁移前先确认订阅可以重新导入。
开源意味着软件源代码按各项目的许可条款提供,使用、修改和再分发需要遵循对应协议;客户端与内核是不同项目,不能把其中一个项目的许可简单套用到整个组合。开源属性也不能替代对安装来源、系统权限和连接配置的审慎判断。
订阅地址、连接链接和导出的配置文件可能带有访问凭据。分享问题截图时,应遮住完整地址、账户标识和认证内容;公开日志前,也要检查是否包含这些信息。备份文件应保存在受控位置,替换设备或转交旧设备前,清理已经保存的配置与自动更新任务。
客户端更新改变程序界面、兼容能力或内核组合;订阅更新则从服务方重新获取服务器配置。这两个操作解决的问题不同。服务器过期通常需要检查订阅状态,协议选项不受支持则可能涉及客户端或内核能力,不能把每次连接失败都归结为程序需要升级。
计划更新前,先保存订阅分组、路由与必要的自定义设置,阅读安装要求和变更说明。更新后先用原来的可用配置验证,再逐项恢复额外设置。如果只在某一应用中异常,保留其他已验证条件,检查该应用的代理方式。稳定、可复现的操作记录,比同时调整多项参数更便于定位问题。
技术笔记
基础连接可用后,再按目标阅读专项笔记。首次安装关注运行环境和初始设置;连接选择关注真连接测试与实际访问;需要自定义流量走向时,再深入域名、IP 与规则顺序。每篇笔记围绕一个操作问题展开,便于对照当前配置逐项验证。
从解压目录选择、运行环境、首次启动的内核设置到系统代理与开机自启,梳理 v2rayN 在 Windows 与 macOS 上首次配置最容易踩的坑。
阅读笔记 →导入订阅后如何区分 TCPing 与真连接测速、按结果挑选服务器,再通过浏览器访问与出口 IP 查询确认流量确实经过代理。
阅读笔记 →拆解 v2rayN 路由设置中的域名规则、IP 规则与 geosite/geoip 用法,给出绕过大陆、全局代理与自定义直连三种分流场景的配置思路。
阅读笔记 →