v2rayN 全平台安装配置

通用准备：安装包与连接资料

先区分客户端、内核与节点

v2rayN 是桌面图形客户端，负责保存服务器资料、更新订阅、生成运行配置和控制代理入口。实际处理连接的是内核，节点则是远端服务的地址与认证资料。安装客户端不会自动获得可连接的节点；拿到订阅也不代表所有条目都适合当前内核。准备开始前，应确认资料提供方给出的是订阅地址、单条分享链接，还是一份完整配置文件，并了解它适用的协议及客户端范围。

桌面优先选择 v2rayN，覆盖 Windows、macOS 和 Linux。Android 使用 v2rayNG，其常见配置围绕 Xray 内核；已有 V2Fly 配置需求时，再评估 v2flyNG。内核名称相近，不代表协议字段完全相同。特别是 REALITY、流控和传输设置，应以当前应用实际提供的选项为准，不要把某个客户端导出的运行配置直接当成另一款应用的通用订阅。

确认系统架构与安装条件

到客户端下载页按操作系统选择安装包，再核对处理器架构。Windows 本站提供的入口面向 x64；Mac 在“关于本机”中查看芯片，Apple Silicon 与 Intel 分开选择；Linux 同时考虑架构和软件包格式。Android 优先依据设备架构选择 arm64，无法确定或安装提示架构不符时再查看通用包。不要仅凭文件扩展名判断兼容性，也不要反复安装名称相似但架构不同的包。

安装前预留应用及配置的保存空间，并确认当前账户能够安装软件。普通系统代理通常不需要持续以管理员身份运行；TUN、虚拟网卡和路由修改则可能触发额外授权。公司管理设备还可能限制网络扩展、VPN 或代理更改，遇到管理策略阻止时应先确认设备使用规则。系统日期与时间也应准确，明显偏差可能让正常的加密连接在握手阶段失败。

准备最小可验证环境

首次配置先暂停其他正在接管网络的代理或 VPN，只保留当前准备测试的客户端。记下系统原有的代理和 DNS 设置，便于恢复。先使用系统代理完成浏览器验证，再考虑 TUN，不要同时改节点、路由、DNS 和网卡设置。若一次修改多个层次，即使恢复连接，也难以判断究竟是哪项起作用；后续切换网络时，同样的问题往往还会出现。

订阅地址通常带有账户标识或访问令牌，应按敏感资料保存。不要把完整链接贴进公开截图、在线格式转换工具或故障讨论；分享日志时也要遮去认证字段。准备一个能够正常打开的普通网页作为直连参考，再准备一个需要通过当前节点访问的目标页面。测试时说明是哪款应用、是否使用系统代理、是否开启 TUN，比只描述“网络不通”更容易缩小范围。

本手册描述的是操作顺序与配置关系，菜单名称可能随界面调整而变化。找不到同名入口时，先按“订阅管理”“系统代理”“路由设置”等功能定位，不要照着其他平台的截图寻找完全一致的位置。已经能够连接的用户可直接跳到对应章节；仍不熟悉导入与启用顺序时，先完成快速上手教程，再回来增加分流和 TUN。

Windows：v2rayN 安装与系统代理

选择桌面版或经典 WPF 版

打开Windows 下载分组，按需要选择 v2rayN 桌面版或经典 WPF 版。桌面版采用跨平台界面，适合希望在多个桌面系统之间保持相近操作方式的用户；WPF 是 Windows 上的经典界面。两者的菜单组织可能不同，排查时应注明使用哪一种。不要同时开启两份客户端并让它们争用本地监听端口，否则后启动的内核可能无法绑定入口。

按安装程序提示完成安装，首次启动先确认主窗口能够正常显示，再导入节点。若程序直接退出，先查看系统提示与应用日志，而不是立即修改网络设置。缺少运行环境时，应安装应用要求的对应运行库；经典 WPF 界面涉及桌面组件，不能把其他用途的运行环境当成等价替代。具体依赖以安装提示为准，不必在程序已经正常运行时额外安装一组不相关组件。

导入订阅并确认当前服务器

在订阅分组设置中新建分组，填写容易识别的备注，把完整订阅地址粘贴到地址字段，保存后执行更新当前订阅。保存分组只会记录来源，不一定已经拉取节点。更新结束后切换到对应分组，查看是否出现服务器条目，再选择其中一个作为当前服务器。若地址来自浏览器，注意复制的是资料提供方给出的订阅链接，而不是账户中心或订单页面的网址。

使用单条分享链接时，从剪贴板导入与更新订阅是不同操作。导入后核对服务器地址、端口、协议和传输方式，尤其不要把链接末尾的备注误认为服务器地址。首次验证可以只保留一个明确可用的候选，减少自动切换和批量测试带来的干扰。列表中的延迟结果仅反映特定测试方法，不能替代目标网页的实际请求，也不能据此断言某个协议配置完全正确。

启用系统代理，再检查路由

内核启动正常后，在系统代理菜单中选择自动配置系统代理，使遵循 Windows 系统代理设置的应用使用客户端本地入口。系统代理负责把请求交给客户端，路由负责决定收到的请求走直连还是代理，两项不能混为一谈。选了绕过大陆预设，并不等于系统代理已经开启；系统代理开启，也不保证所有应用都会遵循它。终端、开发工具和部分下载器可能需要自己的代理选项。

验证时重新打开测试页面，必要时重启保留旧连接的应用。如果浏览器正常而命令行仍直连，先查看命令行工具的代理来源，不要重复导入订阅。浏览器自身的代理扩展也可能覆盖系统设置。想了解模式差异，可对照系统代理与路由模式说明中的概念；平台界面虽不同，入口设置与出口选择仍是两个层次。

TUN 授权与退出恢复

只有在需要接管不遵循系统代理的应用，或需要更完整的网络接管时，再启用 TUN。先关闭其他虚拟网卡接管工具，按客户端提示授予所需权限，并检查内核日志是否成功创建网络入口。安全软件若阻止网络组件，应核对被拦截的具体对象和用途，不要直接关闭全部防护。设备存在组织策略时，管理员权限也不一定能够绕过限制。

退出前先关闭 TUN，再清除由客户端设置的系统代理。异常关机后如果浏览器完全无法联网，而客户端尚未启动，可在 Windows 的代理设置中检查是否残留指向本机的手动代理。恢复网络时仅撤销本次配置，不要删除不明网卡或重置全部网络。详细启动问题可继续读运行库与启动权限排查，将程序启动失败和节点连接失败分开处理。

macOS：芯片选择、安装权限与代理

按芯片选择安装包

在 Mac 的“关于本机”中查看芯片信息，再进入macOS 下载分组。Apple Silicon 选择对应的 arm64 安装包，Intel 选择 x64 安装包。优先使用与机器架构一致的构建，不要把依赖兼容层启动成功当成最佳安装方式。下载完成后打开磁盘映像，按界面提示把 v2rayN 放入“应用程序”，再从应用程序目录启动，避免长期从临时挂载位置运行。

首次打开可能出现系统来源确认或权限提示。先确认文件确实来自预期下载入口，再通过系统设置中的隐私与安全性页面处理允许打开。若出现程序已损坏、无法验证或没有访问权限等提示，应分别排查下载是否完成、安装位置是否可写、系统策略是否拦截。不要把所有提示都归结为同一种原因，更不要为启动一个应用而关闭整个系统的应用检查机制。

导入后先运行，再写入系统代理

打开 v2rayN 的订阅分组设置，填入备注和完整订阅地址，保存后更新当前分组。出现节点列表后选定当前服务器，确认内核能够启动。若订阅能够保存但更新失败，先检查地址是否有多余空格、是否已失效，以及当前网络能否访问订阅服务。更新订阅与连接节点走的是不同请求路径，前者成功不能证明后者可用，前者失败也不必然说明已有节点失效。

接着在系统代理菜单中启用自动配置系统代理。Mac 的系统代理与网络服务有关，切换无线网络、有线网卡或其他网络服务后，应重新确认当前服务的代理状态。系统代理菜单中的“不改变系统代理”只是停止主动修改系统设置，不代表系统中已经没有代理残留；需要恢复直连时，应使用清除系统代理并在系统网络设置中核对结果，而不是只切到不改变状态。

区分浏览器连接与应用连接

先用遵循系统代理的浏览器打开目标页面，观察请求是否进入客户端日志。如果浏览器可以使用，而某个开发工具不能连接，先查看工具自己的代理选项和进程环境。部分应用只在启动时读取代理，修改系统设置后需要重新打开。浏览器也可能配置了独立代理扩展或自定义解析方式，这些设置会让同一台 Mac 上的应用表现不同，不应直接通过反复换节点解决。

绕过大陆、全局等路由预设应根据目标选择，不要把“自动配置系统代理”理解成所有连接都通过远端。启用系统代理后，内核仍可按规则将指定域名或地址直连。开发环境中的本地服务应特别注意回环地址与局域网目标的处理，避免把本来应访问本机的请求送到远端。需要访问打印机、局域网服务或内部域名时，应保留适当的直连范围。

TUN 与休眠后的恢复顺序

需要接管不读取系统代理的应用时再测试 TUN。按客户端提示完成提权或辅助组件授权，并留意系统是否要求批准相关网络能力。TUN 启用后先验证普通网页，再验证局域网和目标应用；如果只验证一个页面，可能遗漏局域网路由或解析异常。不要同时运行多个试图管理默认路由的工具，关闭窗口也不一定等于相关后台网络功能已经停止。

Mac 从休眠恢复或切换网络后，旧连接可能失效。先检查基础网络是否可用，再重新连接当前节点；仍有问题时关闭 TUN、恢复系统代理基线，然后按原顺序启用。退出应用前主动清除代理，异常退出后则到当前网络服务的代理页面检查残留。操作过程可配合macOS 系统代理模式详解查阅，启动阶段的问题另看权限与隔离属性排查。

Linux：软件包、桌面代理与权限

同时核对发行版与处理器架构

进入Linux 下载分组，先确定发行版使用 deb 还是 rpm 软件包，再确定机器是 x64 还是 arm64。不要通过更改扩展名把一种包变成另一种包，也不要把处理器架构与发行版名称混为一谈。可以在系统“关于”页面查看信息；使用终端时，下面的命令只读取系统资料，不会安装软件或修改网络。输出中的架构名称应与下载页说明对应后再继续。

uname -m
cat /etc/os-release

通过发行版的软件安装工具打开下载的安装包，检查依赖提示并完成安装。若安装器报告缺少组件，应使用当前发行版的正常软件源解决依赖，不要混入其他发行版的软件包。应用安装成功却无法显示窗口时，可从终端启动已安装的程序以读取错误输出，重点区分图形会话、桌面组件和文件权限问题；这时尚未进入节点连接阶段，修改订阅没有意义。

用普通账户运行并确认监听入口

日常打开图形界面优先使用普通账户，避免一次以高权限运行后，配置目录变成普通账户无法写入。首次启动检查订阅与应用设置能否正常保存，退出后重新打开确认仍然存在。若修改每次丢失，先查看配置目录权限、磁盘状态以及是否误从临时位置运行。备份或迁移时同样要保留合理的文件属主，而不是用放宽所有目录权限的方式掩盖问题。

新建订阅分组、填写地址、保存并更新，选定节点后观察内核日志。出现地址已被占用，通常意味着另一份内核或代理工具正在使用同一个本地端口。先查清占用者，再停止重复实例或调整客户端入口。调整端口后，还要同步使用该入口的应用设置；只改客户端而不改浏览器、终端或桌面代理，会形成“内核运行正常但请求进不来”的状态。

桌面环境不等于统一的系统代理

Linux 的桌面代理行为取决于桌面环境与应用自身实现。客户端提供系统代理选项时，也应到桌面的网络代理设置中确认写入结果。某些图形应用会读取桌面配置，命令行程序则可能读取环境变量或自身配置文件；已经启动的进程也未必自动更新。先让一个明确支持代理的应用使用本地入口，证明节点链路可用，再扩展到其他程序，排查范围会更清楚。

给终端配置代理前，应确认工具支持的代理协议，以及客户端实际启用的监听类型。HTTP 入口和 SOCKS 入口不能仅因同在本机就互换使用。临时环境变量通常只影响当前终端及其子进程，不会自动修改整个桌面。需要撤销时也应撤销相应环境配置；否则客户端退出后，新的命令仍可能尝试连接已不存在的本地端口，看起来像系统网络故障。

TUN、路由与网络管理服务

TUN 需要访问虚拟网络设备并修改相关路由，权限不足时应根据客户端提示配置所需授权。不要为了让它启动而长期使用高权限账户打开整个桌面应用。启用后检查是否确实创建网络入口、是否存在其他 VPN 接管默认路由，以及局域网目标是否还能访问。桌面网络管理服务在网络切换后可能重新应用配置，因此一次启动成功并不代表网络切换后的状态一定相同。

DNS 也可能由桌面环境、网络管理服务或本地解析服务分别管理。先确认当前由哪一层负责，再调整客户端 DNS，避免直接覆盖系统管理的解析文件。无法解析时先关闭 TUN 回到基线，看系统解析能否恢复；基础网络恢复后再逐步检查虚拟入口和规则。退出前撤销本次代理设置，保留原有网络配置；远程维护机器尤其不要在缺少回退路径时直接改默认路由。

Android：导入订阅与 VPN 授权

选择 v2rayNG 或 v2flyNG

到Android 下载分组选择客户端。常规 Xray 配置优先使用 v2rayNG；已有资料明确围绕 V2Fly 时，再评估 v2flyNG。两款应用虽然都能管理节点，但功能选项和协议支持不能按名称推定完全相同。若服务资料要求 REALITY 或特定流控，应先在当前客户端中核对相应字段，避免导入成功后才发现运行时无法识别。

安装包有 arm64 与通用版入口，较新的主流设备通常可选 arm64，仍应以实际处理器架构为准。安装提示不兼容时，先核对架构和系统要求，不要持续覆盖安装不同来源的包。通过浏览器安装时，Android 可能要求允许当前来源安装应用；只对本次使用的来源按需授权。安装完成后从应用列表打开客户端，先确认能够进入主界面并保存配置。

粘贴地址后执行订阅更新

复制完整订阅地址，在应用的订阅设置或订阅分组管理中新增来源，填写备注并保存，再执行更新订阅。不同界面可能将更新入口放在主列表菜单，不应把订阅设置页面能看到地址当成更新已经完成。更新后回到节点列表，选择准备使用的条目。若只有分享链接，应使用相应的剪贴板导入功能，而不是把单节点链接填进只接受订阅地址的字段。

手机复制资料时容易带入换行、空格或聊天软件追加的说明，导入前应检查开头协议和完整内容。扫码导入也只负责读取编码资料，不能确认配置仍有效。若节点名称出现但无法启动，核对传输类型、加密连接参数和内核支持，再查看日志。更详细的格式差异可读订阅、原生 JSON 与分享链接说明，不要把所有文本都按同一种导入方式处理。

理解 Android 的 VPN 接管方式

点击连接后，系统通常会弹出 VPN 连接请求，确认后应用才能通过本地虚拟网络入口接收流量。这是 Android 提供给此类客户端的网络接管机制，并不意味着节点资料被系统自动补全。看到 VPN 状态标志，只能说明本地接管通道建立，远端连接是否成功还要通过日志和目标请求判断。系统授权被拒绝时，重复更换节点不会解决授权问题。

同一系统用户下通常不能同时由两个普通 VPN 应用接管流量。若已有其他 VPN、过滤工具或通过 VPN 接口工作的网络应用，应先停用再测试。应用内的分应用代理用于选择哪些应用进入接管范围，不同选项可能表示“仅代理所选”或“绕过所选”，操作前要阅读当前模式。选中列表中的应用，不一定都代表它们会走代理，具体方向取决于该模式的定义。

后台限制、网络切换与恢复

若前台使用正常，锁屏后连接却经常中断，先检查系统对客户端的电池优化、后台运行和自动启动限制。按设备提供的设置允许必要后台活动即可，不必批量放开无关应用。也要确认是否由系统回收了进程，还是无线网络切到移动网络后旧连接失效。两种情况的处理不同：前者涉及后台限制，后者应先尝试重新连接当前配置并观察日志。

首次验证不建议立即开启始终开启 VPN 或阻止非 VPN 连接等系统选项。它们可能让客户端未成功连接时的其他请求也被阻断，掩盖基础网络状态。需要这些行为时，应先验证正常连接、断开与重启后的表现。排查结束后，主动在应用内断开连接，并确认系统 VPN 状态已解除；更换客户端前也应先停用原有接管，避免误把前一款应用的残留状态当成新应用故障。

订阅管理：格式、更新与配置迁移

识别资料类型，选择对应导入方式

订阅地址是可重复请求的资源入口，客户端更新时从这个地址取得节点资料。分享链接通常描述单个节点，原生 JSON 则可能描述一整套入站、出站、路由和 DNS。它们并不是只换一个后缀就能互相使用的文件。遇到导入失败，先确认输入类型，再确认客户端是否支持该类型；把网页内容保存成文本，或把编码内容再次编码，都不会自动变成有效配置。

Base64 订阅常见于对分享链接集合进行编码的场景，解码后仍需要符合客户端能识别的链接格式。某些订阅服务会根据请求方式返回不同结构，因此浏览器看到的内容与客户端实际收到的内容可能不完全一样。排查时应观察更新日志中的响应与解析错误，不要只根据地址是否能够在浏览器打开下结论。返回登录页面、错误提示或空内容，都可能造成没有可导入节点。

把分组更新与节点选择分开

订阅分组建议使用可识别的备注，区分不同来源及用途。更新当前分组只刷新该来源，更新全部订阅可能同时替换多个分组的条目。更新前若手动修改过订阅节点，应先备份，因为客户端可能按来源重新生成记录，手动调整不一定保留。需要长期维护的自定义节点，适合单独保存，而不是依赖每次更新后再次修改同一条订阅记录。

更新完成后检查当前选中节点是否仍存在，节点名称、服务器地址或配置内容可能发生变化。不要只看分组更新成功就直接离开。自动更新间隔也应结合来源限制设置，失败时避免连续高频刷新。订阅服务暂时不可达但现有节点仍能连接时，可以先继续使用已保存配置，再处理订阅请求路径，不必删除所有条目重建环境。

迁移优先使用应用级备份

在同一客户端之间迁移，优先使用应用提供的备份与恢复功能，或按其说明备份配置目录。迁移前关闭应用，避免复制正在写入的数据库；恢复前另外保存目标设备原有资料。备份中可能包含完整订阅地址、认证信息和本地使用记录，应保存在受控位置。新设备恢复成功后，再核对本地监听端口、系统代理和 TUN 设置，不要假定这些机器相关选项可以原样照用。

跨平台迁移尤其要注意文件路径、权限方式和网络服务差异。Windows 的路径不能直接用于 Mac，Linux 的授权方式也不能照搬到 Android。跨客户端迁移则应以双方支持的分享格式为主，并逐项核对关键参数。完整运行配置可能包含某个内核专用字段，不能因为都是 JSON 就认为兼容；导入时没有报错，也应进一步验证实际连接和路由结果。

核对 REALITY 与传输参数

VLESS 节点需要分别检查服务器地址、端口、用户标识、传输方式、连接安全和流控。REALITY 的服务器名称、公钥与短标识应与服务端要求对应，不能从其他节点任意拼接；服务器名称也不一定等于实际连接地址。相关参数缺失时应向资料提供方确认，而不是通过关闭验证来碰运气。原理层面可查阅REALITY 与 XTLS Vision 说明。

迁移完成后做两轮验证：先在新设备建立最小连接，再加回原有分流、自动更新和后台选项。确认稳定后再清理旧资料；如果新设备尚未验证成功，保留旧设备配置可以帮助区分资料问题与平台环境问题。关于格式转换的具体边界，继续参考订阅格式详解。

系统代理、TUN、路由与 DNS

先判断请求从哪里进入客户端

系统代理是一种应用协作机制：系统记录代理入口，愿意读取这项设置的应用把请求发送到该入口。TUN 则在网络层创建虚拟入口，通过路由把符合条件的数据交给客户端。两者解决的首先是接收流量的问题，不直接决定所有请求的最终出口。某个应用没有遵循系统代理时，修改节点分流规则通常没有作用，因为请求根本没有进入内核。

判断入口是否工作，可在发起一次明确请求时查看日志，注意目标域名、连接时间与应用行为是否对应。没有记录时，先查代理入口和应用设置；有记录但连接失败时，再查节点、路由和解析。日志级别不宜长期调得过细，排查结束后恢复常用级别并清理含敏感信息的记录。连接复用可能使一次页面刷新不产生全新连接，需要时重新打开应用再观察。

路由规则按顺序选择出口

绕过大陆通常通过域名与地址规则把相关请求交给直连出口，其余请求按预设继续处理。规则顺序很重要，较宽泛的规则放在前面，可能使后面的具体规则永远无法匹配。局域网地址、特定开发域名和远端目标应分别考虑，不要只加一条覆盖全部地址的规则。尤其在公司网络中，内部域名可能只能由内部解析服务解析，不能一律交给远端处理。

下面是一段 Xray 路由结构示例，用于说明数据库规则与出口标签的关系。它需要合并到已有配置，不能作为完整客户端配置直接启动；示例假定已有名为 direct 与 proxy 的出站，以及可用的规则数据库。图形客户端可能会重新生成运行配置，日常修改应优先使用它提供的路由界面，而不是直接编辑临时生成文件。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "ip": ["geoip:private", "geoip:cn"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "network": "tcp,udp",
        "outboundTag": "proxy"
      }
    ]
  }
}

DNS 不只是填写一个解析地址

域名解析可能发生在应用、系统、客户端或远端，不同代理方式的解析位置也可能不同。浏览器自行启用加密 DNS 后，系统 DNS 的修改未必影响它。排查时先确认目标应用使用哪一层解析，再看客户端规则是否能看到域名信息；如果请求进入时只剩地址，依赖域名的规则可能无法按预期匹配。不要因为网页打不开，就立刻在多个层次同时更换解析服务。

客户端 DNS、直连出口和代理出口之间还可能形成依赖关系。例如解析节点服务器地址所需的请求，如果必须先通过尚未建立的同一个节点，就会形成启动环路。应先保证连接服务器本身所需的基础解析可用，再处理目标域名的分流解析。使用 TUN 时还要确认 DNS 请求是否按设计被接管，避免系统与客户端分别使用不同结果，造成同一域名行为不一致。

数据库与 UDP 分开验证

GeoSite 管理域名分类，GeoIP 管理地址范围，两者不是可以互换的规则数据。规则写法正确但分类失效时，检查数据库是否存在、是否成功加载，以及客户端当前内核支持哪种数据格式。更新数据库后要观察内核是否重新加载，不能仅以下载完成作为结果。详细匹配顺序见GeoIP 与 GeoSite 更新指南。

浏览器网页成功也不代表 UDP 应用一定可用。UDP 是否可转发，取决于应用入口、客户端设置、协议能力、节点服务与网络条件共同作用。语音、实时通信或使用不同传输的应用失败时，应单独观察对应流量，而不是用网页结果替代。配置复杂度应逐步增加：系统代理可用后测试路由，再测试 TUN，最后处理 DNS 与特定应用需求，每一步都保留可恢复的上一份配置。

配置常见问题：按失败阶段排查

程序打不开与内核无法启动

先判断主窗口能否出现。主窗口尚未打开时，优先检查安装架构、系统依赖、应用权限和安全提示；此时订阅内容通常不是主要排查对象。能够打开窗口但提示内核退出，则查看内核日志，关注配置解析失败、本地端口占用、文件访问失败和不支持的字段。把错误发生阶段记清楚，可以避免在应用启动问题上反复更换节点，或在参数错误时反复重装整个客户端。

如果刚改过设置后出现启动失败，先撤销最近一项修改；有备份时恢复已知能够启动的配置。不要立即删除全部配置目录，里面可能还有能够帮助定位的日志与有效资料。端口被占用时查找重复运行的客户端，权限错误时检查具体文件位置。启动问题的跨平台分支可参考v2rayN 闪退与权限排查，先恢复程序基线再测试网络。

订阅失败与连接失败

订阅更新失败时，先看是否能访问订阅服务，再看返回内容能否被识别。访问超时、认证失效和格式不支持属于不同问题。确认地址完整且仍有访问权限后，检查当前网络是否有登录页面或访问限制；已有节点可用而订阅不可达时，再查看客户端是否提供合适的更新请求路径。不要随意把敏感订阅交给在线转换服务，以免把资料问题扩大为访问凭据泄露。

节点已经导入但连接失败，则按远端地址、端口、协议、传输和安全参数逐项核对。超时通常需要检查可达性与服务状态；认证或握手错误则更应关注配置内容、系统时间与服务端要求。错误提示不能单独证明某个原因，应结合出现阶段判断。批量换节点之前先验证一条资料明确的配置，若所有配置都在相同阶段失败，优先检查公共环境而非逐条修改参数。

已连接但网页或应用不可用

客户端显示运行中，仅表示本地进程处于工作状态。先检查请求是否进入日志，再检查匹配的出口，最后看目标解析和远端响应。浏览器能用而其他应用不能用，多半需要比较入口和应用代理设置；所有应用都失败，再回看内核与节点。只有部分域名异常时，检查路由分类、DNS 结果和目标服务本身，不必马上开启更广泛的流量接管。

网页部分加载、下载中断或视频卡住，也不宜直接归结为“节点慢”。页面可能同时请求多个域名，某一组资源被错误分流就会出现局部失败。先观察失败资源的目标与出口，确认是否走了预期路径。延迟测试只测某一种连接，不代表吞吐、持续传输或所有协议表现；比较节点时保持同一目标、同一网络和同一代理方式，避免把不同条件的结果混在一起。

关闭后仍无法联网与提交问题

退出客户端后断网，先检查系统代理是否仍指向本地入口，再检查 TUN 或系统 VPN 是否仍在接管。恢复时先撤销客户端修改，再验证直连参考页面。Linux 还要检查终端环境变量与桌面代理是否分别残留；Mac 注意当前网络服务；Android 检查是否启用了阻止非 VPN 连接的系统选项。不要从“关闭后断网”直接跳到重置全部网络，先处理能够明确对应本次操作的设置。

需要继续求助时，整理系统及架构、客户端名称、资料类型、连接方式和复现步骤，并附上已遮去敏感字段的错误片段。说明是所有目标失败还是部分目标失败，直连是否正常，问题是在安装后首次出现还是切换网络后出现。每次只验证一个假设，记录结果再继续。常见概念可跳转常见问题；准备重新走完整连接流程时，回到使用文档，按导入、选择、启用、验证的顺序建立基线。