Windows
v2rayN 桌面版与经典 WPF 版
桌面版采用跨平台界面,WPF 版保留经典桌面操作方式。两类入口适合不同界面习惯,选择前先看下载中心的系统要求。首次使用应把程序放在可写目录,避免配置保存被目录权限拦截。
桌面选择 v2rayN,Android 优先选择 v2rayNG;从开源客户端入手,完成订阅导入与路由分流设置。
先导入配置,再检查流量入口与路由出口。以下为设置结构示意,具体菜单名称以所用客户端为准,不代表正在运行的连接状态。
{"outbounds":[{"tag":"proxy",
"protocol":"vless"}]}订阅用于批量获取配置,分享链接通常只描述一个节点。先确认内容来自可信来源,再在订阅分组中保存地址并执行更新;复制的是分享链接时,应使用从剪贴板导入入口。更新结束后检查协议、传输与安全参数是否完整,再选择活动配置。图形客户端把这些字段整理成列表,适合日常管理;直接运行内核则需要自行维护配置文件。订阅地址往往包含访问凭据,截图与求助日志都应隐藏敏感部分。
{"routing":{
"domainStrategy":"IPIfNonMatch"
}}路由模式负责决定已进入内核的请求走向,并不负责让所有应用进入代理。首次使用可从客户端预设规则开始,确认常用网站正常后再增加自定义规则。规则通常按顺序匹配,较具体的域名条件应放在宽泛条件之前。示例中的域名策略会在域名规则未命中时尝试解析,以继续匹配 IP 规则。与单纯切换系统代理相比,分流可以分别处理不同目标,但也需要配合 DNS 设置与规则数据更新,避免解析结果影响预期出口。
{"listen":"127.0.0.1",
"port":10808,"protocol":"socks"}系统代理主要影响遵循系统代理设置的应用,不等于接管全部网络流量。开启前先确认内核已经启动、本地监听端口没有冲突,再让客户端写入系统代理。浏览器可用而其他软件不可用时,应检查应用是否使用独立代理设置。窗口中的端口仅为配置示例,实际填写应与本机一致。与虚拟网卡接管相比,系统代理的影响范围更容易确认;排查时先用这一入口建立可复现的连接,再按需要评估其他流量接管方式。
{"protocol":"vless",
"tag":"proxy"}图形界面负责组织设置,内核负责建立连接和执行路由。选择内核时,应核对完整的协议、传输方式及安全参数,而不是只看节点名称。v2rayNG 以 Xray 内核作为 Android 使用重点,v2flyNG 则提供 V2Fly 路线的备选。桌面端可根据 v2rayN 实际提供的选项和配置要求进行调整。不同内核并非所有字段都能互换,切换前保存原配置,切换后查看启动日志并重新验证;不能把更换内核当成所有连接问题的通用修复。
{"listen":"127.0.0.1",
"port":10808}这里的同步指在不同设备上复用配置来源,不表示客户端之间会自动同步全部设置。可在各设备手动导入同一可信订阅,再分别检查活动配置、分流规则与 DNS。完整配置文件还可能包含本地路径、监听端口或平台专属选项,不能直接照搬。与只迁移单个分享链接相比,订阅更便于持续获取更新,但设备端的系统代理、应用分流与权限仍需各自设置。迁移完成后应逐台验证,备份文件与订阅地址也应按敏感信息保存。
先选操作系统,再选处理器架构与安装格式。下载中心集中列出安装包入口;首页不直接分发安装文件。
v2rayN 桌面版与经典 WPF 版
桌面版采用跨平台界面,WPF 版保留经典桌面操作方式。两类入口适合不同界面习惯,选择前先看下载中心的系统要求。首次使用应把程序放在可写目录,避免配置保存被目录权限拦截。
v2rayN · Apple Silicon / Intel
先在系统的“关于本机”中查看芯片信息,再选择对应架构。安装完成后确认应用能够启动、内核能够运行,最后设置系统代理。若系统提示需要确认来源,应先核实下载来源及提示内容,不要整体关闭安全保护。
首选 v2rayNG,备选 v2flyNG
多数较新的设备可先查看 arm64 入口,架构不确定时阅读通用版说明。首次连接需要确认系统 VPN 授权,已有其他 VPN 连接时应先处理冲突。后台中断则继续检查电池优化、应用后台权限及网络切换行为。
v2rayN · deb / rpm
按发行版包管理体系选择 deb 或 rpm,再确认设备使用 x64 还是 arm64。安装图形客户端与接管桌面流量是两个步骤:即使内核正常启动,应用仍可能需要系统代理或自身代理设置,不能仅凭窗口已打开判断连接完成。
客户端提供配置管理界面,本身不附带可直接使用的远程连接服务。下载安装完成后,仍需要来自可信服务提供方或自建服务的有效配置。只有订阅更新成功、活动配置选定、本地流量入口生效之后,应用请求才有机会沿预期链路发出。将这三个环节分开确认,能够避免在订阅失效时反复重装程序,也能避免把系统代理未生效误判成服务端故障。
首次安装建议保留默认监听地址,只调整必要项目。已有其他代理软件时,先记录当前端口和系统代理状态,再避免多个程序同时修改相同设置。完成基本连接后,再逐项增加自定义路由、DNS 或应用分流;每次只改一类设置,才能在出现问题时明确回退位置。
查看全部客户端 →区分项目、内核与客户端,才能看懂下载名称和配置选项。站名用于下载与文档导航,不表示这些独立开源项目由本站开发。
Project V 是理解 V2Ray 相关工具的背景入口。早期围绕内核与配置文件形成的使用方式,逐渐扩展出桌面和移动端图形客户端。内核主要处理网络连接,客户端则把订阅、节点、路由和本地代理设置组织成可操作的界面。搜索“V2Ray 官网”时,经常会同时看到项目名、内核名和客户端名;它们处于不同层级,并不是同一个安装程序的不同写法。
V2Fly 延续 V2Ray 核心的社区开发路线,Xray 是从相关代码基础发展出的另一条内核路线。二者有共同技术背景,但功能演进与具体参数支持并不完全相同。VMess、VLESS 等是协议名称,WebSocket 等属于传输相关选择,TLS 与 REALITY 则涉及连接安全配置。只知道协议名不足以判断兼容性,应结合服务端要求逐项核对,不能认为任意客户端都能使用任意分享链接。
v2rayN 面向桌面平台,适合集中管理订阅、切换活动配置和调整路由。v2rayNG 面向 Android,常见使用流程是导入配置后通过系统 VPN 接口接管相应流量;v2flyNG 提供以 V2Fly 内核为基础的 Android 备选。三者都是开源图形客户端,但菜单、配置导出格式与平台权限不同。选择时优先考虑设备和配置要求,而不是仅凭名称相近就替换应用。
相关客户端与内核按各自开源许可证发布,许可证规定代码使用、修改与再分发的条件;客户端和内核也可能采用不同许可证,具体范围应以对应项目的许可证文本为准。代码开源便于社区审阅与贡献,但不能代替对订阅服务、远程服务器和本地权限的判断。下载安装程序、获得连接配置、授权流量接管,是不同的信任环节,任何一个环节都值得单独核实。
客户端更新可能涉及界面、导入兼容或系统集成;内核更新可能涉及协议处理;路由规则数据更新则影响域名与 IP 的分类。订阅更新通常只是重新获取远程配置,不意味着上述组件都已更新。升级前保存现有设置,阅读变更说明,升级后复测常用网站和应用。出现回归问题时,记录发生在哪个更新环节,比直接清空所有配置更有利于定位。
备份也应区分内容:分享链接可以保存连接参数,客户端配置备份可能还包括订阅凭据、分组信息和本机路径。跨设备迁移时,不要把备份上传到公开位置;向他人求助时,先隐藏地址中的凭据、用户标识与认证字段。使用文档中的配置片段时,也应理解每个字段的作用,而不是把局部示例当作完整可运行配置。
按配置来源、流量入口、规则出口的顺序检查。每一步保留结果,下一步才有明确依据。
安装只完成了工具准备。还要导入有效订阅或分享链接,选择活动配置,并确认内核启动成功。桌面端接着检查系统代理或应用代理,Android 则检查 VPN 授权。先让一个浏览器请求走通,再扩展到其他应用,避免同时排查多个变量。具体顺序见入门指南。
导入成功只说明客户端识别了返回的配置,不代表远端服务当前可达。应继续检查订阅有效期、活动配置、系统时间与连接日志。如果返回的是登录网页或错误提示,即使地址可以在浏览器打开,也不是有效订阅内容。不要公开粘贴完整订阅地址,可先按教程中的导入流程重新核对入口。
应用可能忽略系统代理,也可能使用自己的代理配置。浏览器扩展、应用内代理和系统代理并存时,还可能指向不同端口。先确认本地监听和浏览器访问,再检查目标应用的网络设置。直连或代理模式只决定进入内核后的路由,不能让尚未进入内核的请求自动受规则控制。可结合问题诊断按症状排查。
先记录失败域名、系统解析结果与客户端日志,再区分解析失败和连接失败。浏览器安全 DNS、系统 DNS 和内核 DNS 可能采用不同链路,单独修改某一处未必改变所有请求。保留当前配置,每次只调整一个环节,并同时测试预期直连与代理的目标,避免修复一个网站却改变其他规则。后续操作可参照DNS 与路由诊断说明。
从首次启动、链接格式到路由部署,按问题查阅对应主题。先完成图形客户端的基础连接,再考虑更复杂的网络接管方案。
概述在路由器或旁路由上直接运行内核的两种组网方式,讲清透明代理、DNS 接管与设备网关设置要点,以及适合的使用场景。
入门指南对比单节点分享链接与订阅地址的格式、更新方式和导入入口,演示在 v2rayN 与 v2rayNG 中从剪贴板或二维码导入节点。
入门指南从解压运行、内核选择、本地端口到系统代理模式,梳理 v2rayN 首次启动必须确认的设置,并汇总杀毒误报、端口占用等常见问题。