v2rayN 这组入口提供 x64 桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留经典界面;两者是不同的图形程序,不是两套节点协议。先打开系统的「关于」页面,查看系统类型,确认能运行对应架构的程序。
如果从旧装迁移,先退出原来的实例,再启动新程序。同一台机器上的两个客户端若使用相同的本地监听端口,后启动的一方可能报端口占用。切换之后也要检查系统代理仍指向当前程序实际监听的地址和端口。遇到启动失败,先分清是界面程序未运行,还是界面打开后内核启动失败,再查对应的错误提示。
界面负责管理订阅和启动内核,配置文件描述内核如何接收、解析和转发流量。下列片段用于辨认字段,不能直接当作完整配置运行。
订阅用于批量更新节点。以 v2rayN 为例,先添加订阅地址并更新对应分组,再从更新后的列表选择节点。列表出现条目只说明客户端读到了配置,不代表服务器已经连通。订阅地址属于客户端的管理数据,不是内核的 JSON 字段。下面的 SOCKS 入站是启动内核后给本机应用使用的代理入口,与远端订阅地址是两回事。应用手动填写代理时,应读取当前设置中的端口。
{
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks"
}
]
}
路由规则决定进入内核的连接走哪个出站。规则按列表顺序判断,第一条命中项生效,因此具体规则通常放在宽泛条件之前。例子按目标地址匹配私有网段,命中后交给标签为 direct 的出站;这个标签必须在出站列表中另行定义。应用如果没有把连接交给代理入口,改路由规则也不会改变它的流量。测试分流时,应先固定入口,再分别测试一条应该命中和一条不应该命中的连接。
{
"routing": {
"rules": [
{
"type": "field",
"ip": ["192.168.0.0/16"],
"outboundTag": "direct"
}
]
}
}
内核负责解析并执行配置。切换之前先核对节点的协议、传输和安全参数是否都受目标内核支持,不能只看协议名称。v2rayNG 与 v2flyNG 分别采用 Xray 和 V2Fly,不是同一应用中的两个开关。下面的 freedom 出站展示两套内核共有的基本写法,它只负责直连,不携带远端节点参数。迁移自定义配置时,先从日志确认内核能读取配置并成功启动,再验证实际访问。
{
"outbounds": [
{
"protocol": "freedom",
"tag": "direct"
}
]
}
DNS 设置影响名称如何转换为地址,并可能影响依赖目标地址的路由规则。下面在内核的 DNS 服务器列表中使用 localhost,表示借助本机系统解析。它不能强制浏览器放弃自带的安全 DNS,也不会改写所有应用的解析行为。如果同一应用能访问已知地址却打不开域名,先记录解析错误,再确认查询实际由哪一层发起。不要同时更换解析服务器、节点和路由,否则很难归因。
{
"dns": {
"servers": ["localhost"]
}
}
系统代理把代理地址交给会读取系统设置的应用,通常适合先验证浏览器。终端程序可能有独立的代理选项,不能仅凭网页连通判断它也经过了代理。TUN 通过虚拟网卡接收流量,覆盖范围取决于路由、权限和平台。下面的 HTTP 入站只演示前一种方式可使用的本地入口,不会创建虚拟网卡。排查时先选定一种接入方式,再对照系统设置与客户端日志确认流量是否进入内核。
{
"inbounds": [
{
"listen": "127.0.0.1",
"port": 10809,
"protocol": "http"
}
]
}
先确定运行设备的系统,再看处理器架构。桌面设备选 v2rayN;移动设备在 v2rayNG 与 v2flyNG 之间按配置要求选择。
v2rayN 这组入口提供 x64 桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留经典界面;两者是不同的图形程序,不是两套节点协议。先打开系统的「关于」页面,查看系统类型,确认能运行对应架构的程序。
如果从旧装迁移,先退出原来的实例,再启动新程序。同一台机器上的两个客户端若使用相同的本地监听端口,后启动的一方可能报端口占用。切换之后也要检查系统代理仍指向当前程序实际监听的地址和端口。遇到启动失败,先分清是界面程序未运行,还是界面打开后内核启动失败,再查对应的错误提示。
在系统的「关于本机」中查看芯片或处理器信息。显示 Apple 芯片的设备选 Apple Silicon 对应的 arm64 安装包,显示 Intel 处理器的设备选 x64。两个入口是处理器架构的区别,不需要按订阅协议挑选,也不应根据设备外观判断。
打开磁盘映像后,将应用移到「应用程序」再启动,便于之后从固定位置打开。首次测试可先用一个读取系统代理的浏览器,避免同时切换多个网络选项。无线网络与有线网络的代理设置可能属于不同网络服务;如果换网络后行为变化,要在当前使用的网络服务里核对设置,而不是先重新导入订阅。
多数近年的设备可选 arm64 包,前提是系统支持运行该架构的应用;不确定时可看通用包。通用包通常打包了多套架构的原生库;它仍须满足客户端自身的系统要求。v2rayNG 采用 Xray 内核,需要对照 V2Fly 行为时再选 v2flyNG。
首次使用 VPN 模式时,系统会要求确认连接权限。若设备已有另一个应用建立 VPN,先检查两者是否冲突。连接建立后,如果某个应用表现不同,先检查客户端是否启用了按应用筛选,再看它是否在纳入或排除列表中。此时安装架构通常不是排查重点;架构问题主要出现在安装或加载原生库的阶段。
先按发行版选包格式,再按设备选架构。采用 Debian 软件包体系的发行版通常选 deb,采用 RPM 软件包体系的发行版通常选 rpm。两种格式都有 x64 与 arm64 的对应入口;包格式正确并不意味着架构也正确,两项需要分别核对。
如果包管理器报告缺少依赖或不兼容,先记录软件包给出的提示,在安装阶段解决问题,再打开 v2rayN。启动后,桌面应用是否读取系统代理取决于桌面环境和应用本身。若浏览器可用而终端不可用,可单独检查终端工具的代理参数或环境配置,不要把终端未走代理误判为安装失败。
第一次只验证一个节点、一套路由和一个应用。先确认基本链路,再打开其他接入方式或调整 DNS。
拿到订阅地址后,在订阅分组中添加一条记录并保存,随后主动更新该分组。保存地址与拉取条目是两步;如果列表仍为空,先确认选中的是刚添加的分组,再查看更新结果。只有一条节点分享链接时,使用对应的单节点导入入口。
导入后先选一条协议和传输参数明确的记录。若更新报错,检查地址有没有被截断或附上多余空格;若更新成功但只少了个别节点,重点检查这些节点的格式是否受客户端支持。分享排查截图时,隐藏订阅地址、账户字段和节点凭据。
先明确哪些访问需要直连,哪些请求应交给代理节点。使用客户端的预设规则时,先确认实际选中了哪一套,并检查直连与代理目标的匹配条件。办公网或局域网服务可作为直连样本,代理侧则选一个稳定、已知可访问的目标。
系统代理开关决定一部分应用会不会把流量交到本地入口,路由模式决定内核拿到连接后发往哪里。两项设置互不替代。如果局域网访问在改规则后发生变化,留着原节点不动,单独切回原来的规则测试,便于判断是条件匹配变了,还是应用根本换了入口。
桌面端选择节点并确认内核监听就绪,再按需启用系统代理;移动端则在选择节点后建立 VPN 连接并确认系统授权。用实际应用分别访问直连样本和代理样本,同时查看客户端日志是否出现对应请求。列表延迟和连接状态不能替代这一步。
如果两个样本都失败,先查本地入口或 VPN 状态;只有代理样本失败时,再查节点、路由命中和远端握手。浏览器成功后若还要使用命令行,再用目标工具单独测试。退出客户端前可先关闭或清除系统代理,避免其他程序继续连接已经停止的本地端口。
先区分界面、内核和协议。客户端名称用于选择软件,协议和传输设置用于判断连接兼容性。
Project V 是理解早期 V2Ray 项目的起点。V2Ray 把流量入口、转发出口和匹配规则分开定义:同一个入站收到的不同请求,可以被路由到不同的出站。这样的结构适合把接收流量和决定流量去向分开检查,也为不同图形客户端提供了共同的配置概念。
v2rayN、v2rayNG 与 v2flyNG 是开源图形客户端,分别提供节点管理、配置和启动入口。桌面客户端的界面设置不等同于内核文件;移动端的 VPN 授权也是系统行为。查资料时,先判断问题发生在界面、操作系统还是内核。比如软件界面能正常打开并不说明内核已经监听,而系统授予 VPN 权限也不代表远端握手一定成功。
V2Fly 社区延续 V2Ray 内核的维护,Xray 则从 V2Ray 代码分支发展。两者在入站、出站和许多路由字段上保留相似概念,各自也有独立实现。读到同名字段时,还需核对当前内核的支持范围;特别是较新的传输和安全选项,不能把一套配置的参数直接套到另一套上。
选型时,先确认节点参数要求,再看客户端能调用哪个内核。若某条配置在旧环境可用,在新环境报未知字段或不支持的选项,先从日志摘出字段名,再判断是客户端没有生成正确参数,还是目标内核不识别。用不含敏感信息的精简配置核对,比反复重装更容易定位问题。常见名称可在内核术语中对照。
VMess、VLESS 和 Trojan 都能在这个生态中见到,但认证方式、连接参数和安全层的要求不同。协议一栏与传输一栏描述的是不同维度:客户端能识别某个协议,并不意味着它支持该节点使用的每一种传输组合。远端地址和端口都正确时,传输参数或服务器名称不一致仍可能让连接失败。
例如,VLESS 本身不提供内容加密,阅读相关配置时应另看实际使用的安全层,不能只从协议名称推断链路特性。客户端和内核的代码开源,也不意味着通过软件导入的第三方节点由这些项目运营。软件来源、连接设置和节点运营方需要分别判断。各术语的具体含义见协议速查。
客户端更新可能调整界面或配置生成方式,内核更新可能影响可用字段,订阅更新则刷新分组中的节点列表。三者不必同时更新。排查近期变化时,先记下症状从哪一步开始:软件升级后无法启动,应看内核日志;更新订阅后只有某个节点失效,应先核对该节点的新参数。
手工管理规则时,可记录当前使用的路由配置、关键标签与本地端口,便于变更后比对。先用一条已知可用的记录验证代理入口和远端连接,再逐项恢复自定义路由与解析设置。如果需要迁移订阅和自定义配置,含有凭据的资料应保留在受控位置;提交故障记录时通常只需提供错误类别和相关字段名。
从当前遇到的问题选读:先确定能否启动客户端,再看请求是否进入内核,最后再比较节点表现。
从下载解压、首次运行权限到订阅导入、内核选择与开机自启,梳理 Windows 与 macOS 共通的初始设置流程和新手常见卡点。
分清「系统代理开关」与「路由规则」是两层设置,对比全局、绕过大陆、直连等组合的流量走向,按日常场景选出合适搭配。
订阅里节点一长串该点哪个?从测速延迟的含义、流量倍率、服务器地区到 VMess/VLESS/Trojan 协议差异,给出可操作的挑选顺序。