V2Ray 全平台安装配置大全

首次连接可先走快速上手教程。本手册按系统说明安装、导入和接管范围;换设备、切换网络模式或遇到故障时,从对应章节查起。

通用准备工作

先确定系统、架构和安装包

桌面设备首选 v2rayN,Android 首选使用 Xray 内核的 v2rayNG;明确需要 v2fly 内核时再选 v2flyNG。先确认设备当前运行的操作系统,再确认架构。型号、购买年份、处理器品牌和系统架构不是同一件事:同一品牌可能有不同架构,同一台设备上的虚拟机也可能使用不同的系统。给虚拟机安装时,应查看虚拟机内的系统信息,而不是照宿主机器选包。

从安装包页面进入对应平台,按卡片注明的包类型选择。以该页系统要求为准:架构能对上只说明选对了构建目标,不代表当前系统、运行时和桌面环境都满足条件。第一次安装时,先保留默认的本地监听设置,不开启局域网访问,不设置开机接管。这样即使初次导入失败,也容易区分客户端启动故障与网络接管故障。

平台客户端选包依据接管方式
Windowsv2rayNx64 桌面版或 WPF 版系统代理;按需启用 TUN
macOSv2rayNApple Silicon 或 Intel网络服务的代理设置;按需启用 TUN
Linuxv2rayN发行版包格式与处理器架构桌面或应用代理;按需启用 TUN
Androidv2rayNG、v2flyNGarm64 或通用版客户端通过系统 VPN 接口接管

分清订阅地址、节点和本地配置

订阅地址用于获取一组节点,应填入订阅管理入口;单条分享链接或二维码描述一个节点,走剪贴板、扫码等单节点导入入口。把两者放反,常见表现是订阅任务反复报格式错误,或者地址看似保存成功、列表却没有新增记录。拿到内容后先判断来源提供的是哪一种,再确认它是否供所选客户端解析。其他软件的完整配置文件也不能当作普通订阅导入。

订阅地址可能包含访问凭据,应按密码处理。不要粘贴到在线转换页面、公开截图或反馈帖中。所谓订阅转换,实质是把一种节点描述转换成另一种表示;它不能让目标内核支持原本不支持的协议或传输参数。遇到格式不兼容,先请配置提供方给出适配客户端的订阅,再决定是否需要迁移。导出备份时也要检查是否包含订阅地址、本地节点以及访问凭据,能使用受保护的本地存储就不要公开共享。

建立连接前后的对照记录

连接前先确认设备能正常上网,系统日期、时钟和时区正确。如果当前网络要求网页登录,先完成该网络的接入步骤。随后记下原有的系统代理、自动代理脚本、工作 VPN 和应用独立代理设置。记录的目的不是清空已有设置,而是能在实验结束后恢复原样。受管理设备应保留管理策略;无法确认某项设置归谁维护时,不要直接覆盖。

选定一个已获授权、能反复打开的 HTTPS 地址作为测试目标,再选一个平时需要直连的局域网服务作对照。初次连接只选一个节点、一个应用和一种接管方式。客户端日志用于确认本地入站和出站选择,应用实际响应则用来确认业务是否可用。节点出现在列表、内核启动成功、目标收到响应是三个不同结果。遇到异常时标记发生在哪一步,不要仅写“代理不可用”。

已经能连接的设备适合保留为参照。新设备导入相同订阅后,先确认节点分组和测试目标一致,再比较两边的接管方式。如果两边都无法更新订阅,先核对订阅服务是否可达;如果只有新设备失败,优先查系统权限、应用配置和本地网络。不要先覆盖一台能用的设备,否则故障发生在哪个环节会更难判断。

Windows:v2rayN 安装与接管

选择桌面版或 WPF 版

在「设置 → 系统 → 系统信息」查看系统类型,确认是基于 x64 的系统,然后打开Windows 安装包。桌面版使用跨平台界面;WPF 版采用经典 Windows 界面。两套界面的菜单布局可能不同,照着其他界面的截图找不到同名按钮时,按订阅管理、节点选择、系统代理这三类操作找入口。日常只运行一套客户端:同时打开两个实例不仅可能抢占本地端口,也可能互相改写代理设置。

按下载页所示包型启动安装程序,或将压缩包完整解出后运行其中的客户端。不要只把主程序拖出压缩包单独运行,内核及关联资源仍要能被找到。首次用日常账户启动,不要把长期以管理员身份运行当成常规安装步骤。若程序在出现主界面之前退出,先查看系统提示与下载页列出的运行时要求。若主界面已出现但启动内核失败,再看日志是缺少资源、拒绝访问,还是监听端口已被占用。

更新订阅并验证一个应用

进入订阅分组管理,新增一个便于辨认的分组,把订阅地址填入地址栏并保存。切到刚添加的分组,运行更新当前订阅的操作,确认新增条目确实属于该组。保存时没有错误提示,只能说明本地写入成功;更新成功才说明客户端取回并解析了内容。选中一个节点并设为当前使用项,检查日志是否有启动报错。如果旧分组的列表仍然存在,不要把旧条目误当成此次更新结果。

先在托盘菜单选择设置系统代理,再用默认读取系统代理的浏览器访问测试目标。打开 Windows「网络和 Internet → 代理」查看实际设置是否改变,并与客户端显示的本地代理地址和端口对照。启用系统代理不是给所有程序加上同一条路径:终端、服务、部分下载器及带独立代理设置的浏览器,都可能按自己的配置发起连接。浏览器正常而另一应用失败时,先查该应用的代理入口,不要立即判定节点不可用。

切换到 TUN 前先清理重复入口

只有目标程序不遵循系统代理,或需要以虚拟网络接口接管流量时,再测试 v2rayN TUN 模式。先退出其他正在修改默认路由的代理工具,恢复这次测试前的系统代理状态,暂时只让一种新模式生效。按客户端提示授予启用虚拟网卡所需权限。验证时把日志和应用结果一起看:按钮变为开启未必代表路由已经应用,尤其是在休眠唤醒、无线与有线网络切换或系统同时保留其他虚拟接口时。

如果开启后互联网可用但打印机、文件共享或内网服务变得不可达,先关闭 TUN 确认是否立即恢复。能恢复时,再检查局域网前缀、域名和规则优先级,不要立刻扩大接管范围。若关闭后联网仍异常,回到系统代理页核对是否残留指向本机的端口或脚本。手动恢复时应以测试前的记录为准:原本使用工作代理的设备不能简单地将所有选项统统关闭。

用监听状态定位端口冲突

日志出现地址占用时,可在 PowerShell 查询本机监听套接字。下例先列出状态为监听的连接;把输出里的本地端口与 v2rayN 设置页中实际显示的端口比较,而不是凭默认端口猜测。进程编号只能帮助定位占用者,不能说明对方一定异常。同一个程序也可能分别监听不同地址。

Get-NetTCPConnection -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess |
  Sort-Object LocalPort

确认占用者是仍在运行的旧实例,就先从其托盘菜单正常退出。若属于必须保留的应用,改用未占用的本地端口,再同步更新手动设置过代理的程序。修改后重新启动连接并观察监听项是否出现,最后用一个应用复测。若监听正常但访问仍失败,把排查重点转向接管方式和出站日志,不再围绕端口反复更换。

macOS:v2rayN 安装与网络服务

按芯片选择磁盘映像

从苹果菜单打开「关于本机」。信息显示 Apple 芯片时,选择macOS 安装包中的 Apple Silicon 构建;显示 Intel 处理器时,选择 Intel 构建。不能通过终端窗口的表现判断整台设备的架构,因为终端进程可能运行在兼容环境里。打开对应磁盘映像,按窗口指示把客户端复制到应用程序目录,从复制后的应用启动,而不是一直从挂载的映像里运行。确认能打开后再推出映像。

若系统阻止打开,先区分提示是安全策略、系统版本不符,还是程序启动后异常退出。只为来源可确认且符合本机管理要求的应用按系统提示处理;如果组织策略不允许启动,交由管理员处理,不关闭系统级保护。程序窗口出现后再看应用日志。只要故障还发生在应用加载阶段,就不必调整订阅、代理或 DNS,改这些设置不会修复二进制兼容问题。

从当前网络服务确认系统代理

在订阅管理中新增分组并更新,选中一个节点。开启客户端的系统代理后,到「系统设置 → 网络」找到当前连接的服务,进入其详细信息查看代理设置。无线网络与有线网络是不同的网络服务,历史设置可能分别保留。外接网卡、拔掉扩展坞或从公司切换到家庭网络后,旧服务上的代理状态不能证明当前服务仍采用相同路径。用当前服务和当前时间的日志做对照。

也可以在终端执行下面的只读命令,查看系统当前报告的代理配置以及网络服务顺序。输出能定位代理是否启用、端口是否指向本机,有时还会显示自动配置的相关项;它不证明每个应用都会采用这些设置。例如浏览器配置文件指定了独立代理,或者终端只读取环境变量,就要分别确认它们的实际请求路径。

scutil --proxy
networksetup -listnetworkserviceorder

如果客户端日志没有出现预期应用的入站请求,先彻底退出并重开该应用。有的程序在初始化时读取代理配置,持续运行的进程可能仍沿用旧设置。同样,验证代理停止时不要只切换窗口;关闭客户端的系统代理并按需退出进程后,检查当前网络服务是否恢复到原状态。若看到组织部署的自动代理地址,应保留它,不应为了做对照而删掉。

验证 TUN 启动与睡眠唤醒

系统代理能满足目标应用时,不必为了统一界面状态再开 TUN。需要接管不读取代理设置的应用时,先让系统代理退出这次测试,再按 v2rayN 的提示启用虚拟网络接口。测试顺序是先验证域名访问,再验证依赖局域网的服务,最后在正常退出客户端后复测两者。只测试能否打开外部站点,容易漏掉虚拟接口改变默认路由后出现的局域网故障。

如果睡眠前正常、唤醒后失败,先确定无线网络是否已经重连,以及客户端日志是否还在接收请求。无线网络没恢复时,应先处理网络关联和地址分配;无线已恢复但应用没有入站时,再看系统代理或虚拟路由是否还有效。仅当确认旧会话已失效时,才关闭并重新启用对应模式,观察是否能稳定复现。这样可以把唤醒问题与订阅里的节点切换分开。

区分域名发现、解析与业务连接

局域网访问故障也要分层。先用已知可访问的设备地址测试实际业务,再看用设备名称访问是否成功。如果地址可用而名称不可用,重点检查名称解析或本地服务发现,不要先改远端节点。若连已知设备地址也不能访问,再对比接管前后的接口和规则。远端解析服务通常不会知道你本地网络里的设备名称,即使外部 HTTPS 访问已经正常,也不能据此判定内网解析正常。

当故障只在某个扩展坞或某一条网络上发生,应记录当前服务名称、接管模式以及测试目标的类型。先关闭新改动,切回已验证的设置,再按顺序重做一次。不要同时删除全部网络服务和客户端配置:那样即使症状消失,也无法判断究竟是代理恢复了,还是系统换了一条可用网络。

Linux:v2rayN 安装与桌面代理

发行版包格式与架构

先确认发行版使用的包管理体系,再确认机器架构。Debian、Ubuntu 及使用其软件包体系的桌面发行版通常选 deb;Fedora 及相应体系选 rpm。不能因为安装工具碰巧能读取另一种文件,就把 deb 与 rpm 视为可互换。Linux 安装包主入口是 x64,另有 arm64。发行版不在页面所列兼容范围时,不能只靠格式相同推定可以安装。

uname -m
cat /etc/os-release

uname -m 返回 x86_64 时通常对应 x64 构建,返回 aarch64 时对应 arm64 构建。容器或特殊兼容环境中,内核报告的架构不一定等同于用户空间软件包架构,应再以目标系统包管理器的结果核对。读取发行版信息是为了选本机包格式,不需要修改其中任何字段,也不需要为一次安装更换软件源。

可先使用桌面自带的软件包安装器;使用命令行时,在实际文件所在目录执行适合发行版的安装命令。下例假设已把选定的包在本地重命名为 v2rayn.deb 或 v2rayn.rpm,两条命令只运行其一。包管理器会尝试处理依赖;如果提示依赖不可满足,先确认系统版本和现有软件源,不要用强制忽略依赖的办法安装。

# Debian / Ubuntu
sudo apt install ./v2rayn.deb

# Fedora
sudo dnf install ./v2rayn.rpm

用当前桌面账户导入订阅

安装阶段需要提升权限,不等于客户端日常也要用提升权限运行。首次从当前用户的桌面会话启动,再添加订阅分组、更新并选定节点。若先前用提升权限启动过,可能读写了另一套配置,普通用户下看到的列表自然不同;如果配置目录出现权限错误,先查看目录具体位置和归属,不要递归放宽整个主目录的权限。内核加载失败时,保留第一条错误,不要只截取随后出现的重复重试提示。

桌面代理的能力与当前会话有关。客户端写入桌面设置后,支持读取该设置的应用才会使用它。另一套桌面环境、独立运行的沙箱应用、不同用户启动的程序以及已经打开的终端,可能没有获得同样的代理配置。先验证一个普通桌面浏览器,然后分别验证目标程序;若只有后者失败,考虑让该程序使用自己的代理设置,而不是认为整个桌面的代理开关失效。

显式测试本地代理

如果桌面应用和终端表现不同,可以让终端明确使用客户端的 HTTP 或混合代理端口。下面的命令会先读取输入,不会写入系统或 shell 的永久设置。输入的应是客户端实际显示的本地端口,不是节点的远程端口;测试目标使用已确认允许访问的地址。若只启用了 SOCKS 入站,这个以 HTTP 为例的测试不适用。测试用地址应能响应 HEAD 请求,否则应换用普通 GET。

printf '本地 HTTP 或混合代理端口:'
IFS= read -r proxy_port
printf 'HTTPS 测试地址:'
IFS= read -r test_url
curl --noproxy '' --proxy "http://127.0.0.1:$proxy_port" \
  --head --max-time 15 -- "$test_url"

连接本机被拒绝时先看是否在监听,以及端口类型是否匹配。收到 HTTP 响应后,再结合客户端日志判断请求被代理、直连还是拒绝;单看状态码不能证明是哪条出站完成了连接。测试成功后若终端的常规工具仍失败,应查看该工具自己的网络配置,避免把一次显式参数测试误解为所有命令已经继承了代理。

虚拟接口、默认路由与撤销

测试 TUN 前,确认内核提供虚拟网络接口,桌面会话具备客户端所需权限,并记录正常状态下的默认路由和内网可达性。容器、远程桌面和受管系统不一定能创建所需接口。不要通过以特权方式启动整个图形会话解决接口创建问题。启用后如果另一条工作网络失联,先停掉本次新增的接管模式,再比较路由,不要在远程会话里直接清空路由表。

网络管理器可能在重连时重新应用设备配置,所以应分别测首次启用和一次正常重连。若只有重连后失效,记录接口、网络环境和错误出现时间,先确认是否失去默认路由,再处理客户端状态。正常退出后,桌面代理、应用单独指定的代理和虚拟接口应分别检查;撤销其中一处不会自动撤销另外两处。

Android:v2rayNG 与 v2flyNG

客户端和安装包架构

Android 安装包先列出 v2rayNG,再列出 v2flyNG。v2rayNG 使用 Xray 内核,适合作为首选;订阅明确依赖 v2fly 内核时,再选择 v2flyNG。两者的界面操作有相似处,但支持的协议、传输组合和导入细节不能互相推定。设备系统确认支持 arm64 应用时选 arm64;不确定时可先核对设备规格,再选择通用版。六十四位处理器不保证厂商一定安装了支持相同应用架构的系统。

从文件管理器打开安装包。若系统提示授权当前来源安装应用,只给实际打开该文件的应用本次所需权限,完成后可在系统设置里撤销。无法覆盖安装时,先区分架构不匹配、系统版本不满足、设备管理限制和已有应用与新包不兼容。不要直接卸载正在使用的应用:卸载后本地节点、分应用名单和偏好可能不再保留,确认确实要迁移时再做备份。

订阅更新与首次 VPN 授权

打开订阅分组设置,新增地址及便于识别的名称。回到节点页执行更新订阅,选中本次得到的一个节点,再启动连接。剪贴板导入适合单条分享链接,不需要因为订阅更新失败就把同一地址转投剪贴板导入。日志若显示获取阶段已失败,应先检查当前网络能否访问订阅服务;如果已经获取内容却没有可用条目,再核对订阅格式与内核支持。

第一次启动通常会弹出系统 VPN 授权。确认创建连接的是刚选定的客户端,再授权。这里用的是系统提供的虚拟网络接口,同一用户环境中,另一项使用该接口的工作 VPN、本地防火墙或过滤器可能与客户端互斥。此前若设过始终开启 VPN,先核对它对应哪一个应用。不能把桌面的“设置系统代理”照搬成手机步骤,也不要并行开启两款客户端来比较节点。

分应用接管和网络切换

初次验证先用常规接管范围测试浏览器,不立即添加分应用条件。验证通过后再打开分应用代理,确认界面采用的是“只接管选中应用”,还是“选中应用排除在外”。用各一个应当接管与不应接管的应用复测。遇到浏览器可用而应用内页面失败时,检查发起网络请求的是主应用、系统组件,还是由外部浏览器实际打开。按图标理解请求归属,容易选错应用名单。

无线网络正常而移动数据异常时,应先确认切换后普通网页在停用客户端的对照状态下可访问,再观察连接是否重新建立。移动数据权限、节省流量设置和当前网络的接入条件都可能影响结果。不要只看系统的 VPN 图标:它说明接口仍存在,不代表此前的远端连接沿用到了新网络。记录切换动作前后的首条错误,比连续点按重连接更容易定位。

后台限制与常驻策略

锁屏后停止、亮屏便恢复,先看系统电池和后台运行设置。若能稳定复现,再对当前客户端单独调整电池限制,并以相同网络与锁屏时间段复测。不必给所有应用解除限制。始终开启 VPN 是连接策略;限制未经过 VPN 的连接是另一层约束。后者可能让客户端停止时的普通联网也被阻断,还可能影响需要直连的应用。启用前先核对设备策略和使用需求,避免用它来掩盖后台退出的原因。

排查耗电时,区分客户端持续转发、应用高频发起请求和网络不稳引发的反复重连。可在电池用量页从同一段使用时长比较,测试期间固定网络和应用范围。需要细分电池优化、厂家后台管理与分应用取舍,可参阅v2rayNG 耗电与后台运行排查。

换设备后重建系统侧设置

订阅重新导入主要恢复节点列表,不会替新设备配置系统的 VPN 授权、数据使用权限和分应用名单。换机后应先建立最小连接,再添加后台运行与常驻条件,最后比较两台设备的应用访问结果。如果只迁移少量自建节点,可以按需分享单条链接;若还要保留路由和偏好,先区分哪些能随配置备份导出,具体可看多设备配置同步。

路由分流与 DNS

接管入口、规则匹配与出站

先区分“应用有没有把请求交给客户端”和“客户端收到以后把请求送到哪里”。系统代理或 TUN 解决第一件事,路由规则解决第二件事。如果应用请求从未进入客户端,改动规则不会影响它。反过来,当日志显示请求已被接收却走错出站时,先排查规则顺序、匹配条件和默认行为,不必去开启另一种接管模式。

普通路由规则按顺序匹配,通常由首条匹配规则决定出站。域名专用规则应放在可能把它提前匹配掉的宽泛规则前。规则中的 outboundTag 引用配置里已有的出站标签,而不是任意可识别的中文名;direct、proxy、block 是常见示意名称,不能假设每套配置都采用这些标签。没有匹配规则时,内核通常使用首个出站,图形客户端也可能额外生成兜底规则。检查实际配置和日志,不凭界面上的档位名称推断。

先核对具体规则,再改默认路径

下面是一条可用于 Xray 的域名规则片段,匹配精确域名 example.org 并交给已有的 direct 出站。它是 routing.rules 数组中的单条对象,不是完整配置。要验证规则顺序,可在确认存在相应出站后,把它放在测试配置的宽泛匹配之前,对照该域名与另一测试目标的出站日志。图形客户端若提供路由编辑器,应填写对应字段,不要把整个对象粘进只接受域名的输入框。

{
  "type": "field",
  "domain": ["full:example.org"],
  "outboundTag": "direct"
}

域名规则只能匹配内核拿到的域名。以 IP 字面地址访问、应用先自行解析再连接,或虚拟接口只看到目的 IP 时,域名规则未必会触发。部分配置可用流量嗅探补充域名线索,但是否能识别要看流量与设置。内网设备需要直连时,应先弄清应用实际使用的是本地名称还是具体地址,再选择域名条件或范围适当的 IP 条件;不宜把整个不相关的地址范围一并排除。

谁在解析域名

V2Ray DNS 设置涉及多处:操作系统可能先解析,浏览器可能使用自己的安全 DNS,内核也可能为路由判断或出站连接发起查询。启用远端 DNS 不等于所有查询都会交给它,TUN 也不会天然约束每个应用内置的解析器。排查时先明确要验证哪类查询,再看日志、应用设置和系统解析的差异。外部域名与仅供内网使用的名称通常需要不同解析路径,混用同一解析端会让故障更难解释。

若站点只能用域名访问,不用把直接访问其 IP 当成 HTTPS 成功标准:证书、虚拟主机与握手使用的服务器名称可能依赖域名。更可靠的对照是分开记录域名解析是否成功、应用是否建立连接、内核最后选择哪条出站。遇到应用缓存干扰,可退出并重开要测试的应用;不要把一次切换后立刻得到的旧缓存结果,当作新设置已生效的证据。需要系统化检查查询路径,可看DNS 泄漏检测与配置。

域名策略和 FakeDNS 的使用边界

内核的路由域名策略会影响是否为 IP 规则执行解析。以 Xray 为例,AsIs 不为路由匹配主动把域名变成 IP,IPIfNonMatch 在按域名未匹配时再尝试解析以检查 IP 规则。路由为了匹配而执行解析,与最终连接用哪个地址不是一项设置。切换策略可能改变解析时机和命中结果,调整后应同时检查原本应该直连和应该经代理的目标。

FakeDNS 则用合成地址建立映射,再由接管流量的内核还原到域名。它要求解析结果和后续连接落在相互配合的处理路径上。如果设备拿到了合成地址,却通过未接管的路径访问,就可能表现为解析成功、连接失败。首次配置应先让普通解析与路由稳定;只有明确需要域名映射时,再阅读FakeDNS 原理与适用场景,单独验证。回退时同步撤销映射相关设置,并重新建立测试应用的连接。

配置常见问题

订阅已保存,节点列表为什么还是空的?

定位获取阶段与解析阶段

先确认活动分组和更新对象一致。更新日志如果报域名无法解析、连接超时或服务返回状态异常,问题还在获取阶段。使用设备原有、已获授权且能访问订阅服务的网络重试一次;订阅本身不能为尚未导入的节点提供连接。若获取成功但显示格式不支持,应请提供方确认返回的是客户端可识别的订阅,而不是登录页、错误提示或其他软件的完整配置。不要公开响应内容和原始地址,只记录错误类别与出现时间。

若列表以前正常、这次部分条目消失,先查活动分组是否切错,再确认服务端是否替换了节点或撤回了某些条目。订阅更新可能覆盖分组中的原有节点。在另一个分组保留需要独立维护的手工配置,便于将订阅变化与本地改动分开。

节点能测出结果,应用为什么连不上?

按测速类型解读结果

V2Ray 节点测速可能只测试到服务器的传输连接,也可能通过节点访问客户端设置的测试地址。能测通只能说明该项测试成功,不能证明另一个域名、另一个应用或另一套 DNS 配置可用。先确认当前活动节点就是测过的那个,再在目标应用发起一次新请求,记下时间并查看内核日志。没有入站记录,先查系统代理、虚拟接口或应用范围;有入站且出站符合预期,再定位远端连接和目标服务响应。

不同测试地址、网络和测速类型得出的结果不适合直接比较。单次测试超时也不能判定整个订阅失效。应在同一接入网络下选定同一测试地址重复验证,记录失败是否总出现在相同阶段,然后再与已知可用节点做对照。

打开 TUN 后,所有网站都无法访问怎么办?

恢复已知可用状态,再单独复测接管

先关闭本次启用的 TUN,恢复先前的直连或系统代理,确认基础网络仍然可用。若恢复后仍不能上网,检查当前网络是否完成登录、客户端退出后是否留下本机代理端口,以及设备是否仍受某项常驻 VPN 策略限制。恢复操作应保留原有工作网络设置。若关闭 TUN 后立即恢复,再检查虚拟接口的权限、其他网络工具是否争用路由,以及用于解析的地址是否变得不可达。

复测时只开 TUN,保持节点与测试地址不变,先测域名访问和原本需要直连的本地地址,再查看日志。看到“已开启”只说明客户端接受了操作;路由、接口、解析和出站都需要单独确认。

同一份订阅在两台设备上表现不同,先比什么?

对齐客户端、内核和验证条件

先比较实际选中的节点、内核类别、网络、目标地址和测试时间。手机走系统 VPN 接口,桌面可能只设置系统代理;即使同一个节点可用,两端应用的接管边界也不同。对于导入后有记录、连接时才报参数错误的情况,检查协议和传输设置是否被当前内核识别。替换客户端之前,可用客户端对比确认差异,再在一台设备上做单变量测试。

若在两个应用都可用的情况下还要迁移规则,不应直接复制整套系统相关设置。相同的分流意图可分别实现,但设备的本地地址、代理端口、应用名单和权限对象都需要重新确认。与其要求选项完全一致,不如验证两边需要直连和需要接管的业务是否达到预期。

遇到证书或握手错误,要改哪些设置?

保留证书检查,定位错误发生位置

确认系统日期和时钟正确,区分提示来自浏览器访问的目标站点,还是来自客户端与节点之间的握手。如果是客户端日志报错,检查导入的节点地址、传输参数与服务器名称是否和提供方说明一致;如果是浏览器提示,检查测试地址是否输入正确、当前网络是否要求网页登录、应用是否误用了系统中遗留的代理。不要把关闭证书验证当成处理方法,那会掩盖连接对象或配置信息不一致的问题。

需要反馈时,只提交操作系统、客户端名、连接模式、复现步骤和脱敏后的第一条错误。不要附完整订阅、节点分享链接或含凭据的配置导出。若仍不能判断是从哪一步开始出错,可回到快速上手教程重做最小流程,再按本手册对应章节增加设置。