Windows
v2rayN Desktop / WPF
首次安装可从 Desktop 版入手;已有 WPF 界面使用习惯的用户可选经典 WPF 版。两者主要区别在界面和打包方式,不是两套代理协议。先在系统信息中确认系统类型,再按下载页说明准备运行环境。
解包后从完整目录启动,不要只把可执行文件拖到桌面单独运行。迁移时先备份旧目录里的用户数据,再测试新程序能否读取分组和节点。如果双击后界面未出现,优先核对运行库、目录写入权限和安全软件记录,而不是重新导入订阅。
前往下载01 生态概览
客户端负责编辑和管理配置,内核负责建立连接、处理请求与匹配路由。界面能打开,不代表内核已正常启动。
02 配置路径
从配置来源、流量接管到规则命中,分别验证。出现异常时,先确认故障在哪一层,再调整设置。
在 v2rayN 的路由设置中,先确认正在使用哪套规则,再按匹配顺序检查出站。内核通常采用首条命中的规则,因此局域网直连和特定域名拦截应放在宽泛的规则之前。域名条件和地址条件需要分别验证;同一条规则内同时填写两类条件,并不表示命中任意一类就行。改完后重新发起请求,从日志确认出站,而不是只凭页面能否打开判断分流是否生效。
geoip:private → direct
geosite:category-ads-all → block
geosite:cn → direct
在 v2rayN 中先进入订阅分组设置,新增分组并保存地址,再从订阅分组菜单更新。导入后切回对应分组,确认节点确实出现在列表中。手动添加的单条配置不会跟随该分组刷新。若更新失败,先看错误发生在拉取、证书验证还是内容解析,再检查是否误把单节点链接填进订阅地址栏。若旧节点已无法连接,使用它更新订阅也可能失败。
订阅分组设置 → 新增分组
更新订阅 → 检查目标分组
v2rayN 的系统代理设置影响遵循系统代理的应用,选择全局路由也不会让忽略系统代理的应用自动接入。先在已知会读取系统代理的应用中验证,再检查目标程序是否使用独立网络设置。需要接管更广的流量时,再单独测试 TUN 模式,并留意局域网访问和系统路由变化。退出客户端前可清除系统代理,避免应用继续连接已经关闭的本地端口。
系统代理 → 设置系统代理 / 清除系统代理
路由设置 → 选择当前规则集
GeoSite 提供域名集合,GeoIP 提供地址集合。客户端拿到域名时可以直接做域名匹配;规则要用地址匹配时,还要看当前路由策略是否会解析该域名。出现规则库加载错误,先核对文件路径和分类名称是否存在,再考虑更新库文件。若看似相同的网站在浏览器和其他应用中走向不同,还应检查浏览器自带的加密 DNS,以及应用发起请求时使用的是域名还是地址。
geosite.dat → geosite:cn
geoip.dat → geoip:private
遇到 V2Ray 无法连接,先看内核是否启动、本地监听是否建立,再发起一次实际请求并对照同一时刻的日志。若监听失败,检查端口是否被另一个实例占用;若连接远端时失败,再核对地址、协议、传输和安全设置。延迟测试成功只说明测试请求在当时通过,不代表所有应用都走了代理。定位到问题后一次只改一项,否则难以判断是哪项修改恢复了连接。
内核启动 → 本地监听 → 远端连接 → 目标请求
03 安装包选择
先选系统,再核对处理器架构。桌面使用 v2rayN;安卓按所需内核选择 v2rayNG 或 v2flyNG。
v2rayN Desktop / WPF
首次安装可从 Desktop 版入手;已有 WPF 界面使用习惯的用户可选经典 WPF 版。两者主要区别在界面和打包方式,不是两套代理协议。先在系统信息中确认系统类型,再按下载页说明准备运行环境。
解包后从完整目录启动,不要只把可执行文件拖到桌面单独运行。迁移时先备份旧目录里的用户数据,再测试新程序能否读取分组和节点。如果双击后界面未出现,优先核对运行库、目录写入权限和安全软件记录,而不是重新导入订阅。
前往下载v2rayN Apple Silicon / Intel
在「关于本机」查看芯片或处理器一栏。Apple Silicon 选 arm64,Intel 选 x64。不要按产品外观或购买年份猜架构,同一系列电脑在不同代际可能使用不同芯片。
安装后先用一条已知可用的配置确认客户端能启动内核。若浏览器可以访问而某个程序仍不能连接,检查该程序是否读取系统代理。已有独立代理设置的应用应单独核对本机地址、监听端口及代理类型,避免沿用另一款客户端留下的设置。
前往下载v2rayNG / v2flyNG
v2rayNG 使用 Xray 内核。明确需要 V2Fly 内核时,再选 v2flyNG。设备支持 arm64-v8a 时可选 arm64 包;不清楚设备支持哪种架构时可先看通用包,仍须满足系统要求。
首次启动代理服务时,按系统提示确认 VPN 连接权限。如果设备上还有其他占用 VPN 槽位的应用,先停止旧连接再测试。出现锁屏后连接中断时,分别检查 VPN 状态、后台限制和网络切换记录,不要仅凭这一现象判断远端节点已失效。
前往下载v2rayN deb / rpm
Debian、Ubuntu 系优先看 deb,Fedora 等采用 RPM 包管理的发行版看 rpm。包格式与处理器架构是两项独立条件。x86_64 对应 x64,aarch64 对应 arm64;换一个包格式不能解决架构不符。
装好后用桌面应用和终端程序分别测试。桌面环境的系统代理未必会影响终端程序,某些工具会使用自身的代理设置或环境变量。若终端独自失败,先查它实际读取哪些设置;若两者都失败,再回客户端确认内核启动和本地监听。
前往下载04 开源生态
判断配置能否迁移,要分别核对客户端、内核和规则库,而不只是看节点名称或导入结果。
inbound → routing → outbound
客户端生成或加载配置;进入内核的请求按路由规则选取出站。
Project V 是 V2Ray 生态的起点。对日常使用最有帮助的是它的配置模型:入站接收请求,路由决定流量交给哪个出站,出站再直连、转发或按配置拒绝。图形客户端的节点列表只是配置的一部分,并不能说明所有应用请求都会进入内核。比如浏览器和同机命令行工具可以各有代理设置,即使它们访问同一个地址,实际流量也可能经过不同入口。
因此,从桌面界面看到已经选中节点时,仍要区分两件事:内核是否成功监听,以及目标应用是否真的把请求送到这个监听入口。如果日志里没有出现目标请求,应该先检查应用接入方式。此时反复变更远端传输参数,不会让未到达内核的流量改变路径。
V2Fly 是社区对 V2Ray 核心的延续维护。Xray 从这一技术脉络分化,作为独立项目发展。两者在入站、路由、出站等基本概念上相通,但协议、传输方式和安全字段会随各自实现演进。客户端能解析分享链接,只能说明链接被识别;并不能证明所选内核支持其中的每个参数,更不能证明远端使用了同样的组合。
迁移时先核对协议、传输和安全层,再决定用哪个客户端和内核。以 REALITY 为例,应按 Xray 的对应文档检查安全层设置,不要把显示在分享链接中的协议名当成完整配置。若普通配置能连而某个节点报不支持,应保留完整错误类型,优先核对该节点的字段和内核实现。
v2rayN 是桌面端图形客户端,管理订阅、服务配置、代理模式和路由;实际能使用哪些内核,要看所选发行包和配置。v2rayNG 面向安卓,主要提供 Xray 配置入口;v2flyNG 同样面向安卓,但使用 V2Fly 内核。三者都可以管理节点,却不能把对方的界面选项、导入格式和默认路由当成一回事。
首次配置不必同时安装两款安卓客户端。先按节点要求选内核,再导入一条配置完成基本测试。若要比较两款,保持测试网络和目标一致,并确认每轮只有待测客户端的 VPN 服务在运行。这样才能区分差异来自客户端、内核还是接管流量的方式。
V2Fly 的 V2Ray 核心和 Xray-core 使用 MPL-2.0。它是文件级开源协议;分发经过修改的受覆盖代码时,应按该协议履行相应的源码义务。客户端和内核是不同项目,其他随包组件也可能有自己的许可。查阅或再分发时,应分别看项目和组件随发行包附带的许可声明,不要用某个内核的许可概括整个客户端。
社区会分别维护界面、核心实现和规则数据。文档中的设置名称用于定位功能,既不代表所有界面布局相同,也不代表一次客户端更新会自动刷新订阅和规则库。选包时先关注系统、架构和内核能力;诊断时则以本机配置和实际日志为准。
更新客户端改动的是程序,刷新订阅改动的是节点来源,更新规则库改动的是匹配数据。这三项最好分开进行。更新前保留一份可用配置,记录当前规则集和本地监听端口。更新后先复测同一个目标,再验证本地服务直连和需要代理的请求是否仍走预期路径。
若订阅更新后只有个别配置失败,先比对这些配置的传输参数;若规则库更新后只有某类域名走向异常,检查分类是否变动,及是否被前面的规则提前匹配。若客户端更新后所有请求都失败,先看内核启动和监听错误。按改动范围缩小排查面,比同时重装、刷新订阅和改 DNS 更容易找到原因。
05 资讯与排查
启动失败先看本地监听,安装失败先核对软件包,流量走向异常再看路由与规则库。
用系统自带命令找出占用 10808、10809 端口的进程,说明在 v2rayN 中修改本地 SOCKS 与 HTTP 监听端口的步骤,以及改完后需要同步调整的设置。
改端口前,先确认占用者是不是已运行的客户端。若是旧实例,退出它并重新启动通常比改配置更直接。确实要保留两个程序时,再为它们分配不同端口。修改后,用同一应用复测,并确认应用没有继续读取旧代理地址。
从选包、解压、首次运行到导入订阅一步步走完,对比 WPF 版与 Desktop 版的差异,并汇总缺少运行库、杀软拦截、路径含中文等常见问题。
用首次启动作为分界:界面未出现时先查运行环境;界面出现却无节点时,再查导入和订阅更新。两类问题要看不同的提示。
介绍 geoip.dat 与 geosite.dat 的用途、在客户端内更新规则库的路径,以及 geosite:cn、geoip:private 等常用写法在分流规则中的组合方式。
验证规则时,分别准备一个域名请求和一个直接使用地址的请求。若只有其中一种走向异常,先检查匹配对象是否与规则类型一致。