客户端全平台安装配置

通用准备：先确认三类信息

开始前，把设备、客户端和连接资料分开看。操作系统决定安装包，处理器架构决定程序能否运行，订阅内容决定客户端能否生成有效配置。这三件事互不替代。仅下载客户端不会自动得到可用服务器；能够导入一条记录，也不代表远端服务仍有效。先把输入条件记清楚，后面出现问题时才不会反复重装。

确认系统、架构与内核需求

桌面平台优先选择 v2rayN。Windows 下载页区分桌面版与经典 WPF 版，两者主要是界面与运行环境的差异，不是不同的订阅账户。macOS 按 Apple Silicon 或 Intel 芯片选包；Linux 同时核对处理器架构和发行版包格式。不要用文件扩展名猜架构，也不要把桌面端安装文件传给手机尝试打开。

Android 首选使用 Xray 内核的 v2rayNG。若现有配置明确面向 V2Fly，可考虑 v2flyNG。内核不是外观主题，它负责解释配置、处理协议和建立连接。带有 REALITY 等特定能力要求的资料，需要对应内核支持。不能因为两款客户端的导入菜单相似，就假定所有字段可以互换。

同时检查设备时间是否自动同步、磁盘是否留有安装空间，以及系统是否允许安装当前来源的应用。时间明显偏差可能影响证书验证和部分认证流程。首次排查使用稳定的普通网络，不要同时开启多个代理或虚拟专用网络工具，否则无法判断流量究竟进入哪一个入口。

区分订阅地址与单条分享链接

订阅地址通常是一个可以更新的网络地址，返回多条连接资料；单条分享链接描述一个服务器配置。复制时应取得完整文本，不包含聊天软件附带的说明、引号或换行。浏览器里看到的账户管理页面不一定是订阅接口，网页地址可以正常打开，也不能证明它适合粘贴到“订阅分组”的地址栏。

订阅地址可能携带账户凭据，应按密码处理。不要发到公开讨论区，不要把完整链接贴进错误截图，也不要上传包含它的配置备份。向他人描述问题时，保留错误类型、操作步骤和客户端名称即可。若链接已经泄露，应通过原服务的账户管理功能重置，而不是只在客户端删掉分组。

如果已有旧客户端，先通过界面的导出或备份入口保存设置，记录订阅分组名、当前服务器、路由预设和本地监听端口。备份应放在自己控制的位置。迁移时先导入一份订阅完成验证，再迁移其余分组；一次复制全部设置，会把旧端口冲突、过期规则和无效链接一起带过来。

建立可以复现的验证基线

首次连接只选一个服务器，先关闭 TUN，使用默认路由和系统代理。记录客户端是否成功启动内核，再检查浏览器是否采用系统代理，最后观察目标页面能否打开。每次只改一个条件，改完重复同一组检查。这样能把安装错误、资料错误和流量接管错误拆开，不必凭“似乎更快”判断配置。

日志应在需要复现时临时打开，完成后恢复日常级别。分享前遮盖地址、用户标识和订阅凭据。失败记录最好包含“执行了哪一步、界面出现什么、下一步发生什么”，而不是只截取红色提示。若只想先完成最短操作流程，转到快速上手教程；本手册后续章节用于解释具体平台的差异。

Windows：v2rayN 安装与接管

Windows 的操作顺序是选安装包、完成首次启动、导入订阅，再开启系统代理。先不要把所有选项都打开。客户端窗口出现只说明界面程序运行成功，内核是否启动、本地端口是否监听和浏览器是否使用代理，需要分别检查。遇到失败时按这个顺序退回上一层，比直接更换服务器更容易定位。

选择桌面版或经典 WPF 版

进入Windows 下载入口，按需要选择 v2rayN 桌面版或经典 WPF 版。桌面版采用跨平台界面，经典 WPF 版保留熟悉的 Windows 桌面布局。两版的菜单位置可能不同，本文以“订阅分组”“系统代理”“路由设置”等功能名称指路，具体文字以当前界面为准，不依赖固定按钮坐标。

按安装向导完成安装，并从开始菜单或安装目录启动。若系统提示缺少运行环境，先核对提示中的组件名称和架构，再按应用提示处理；不要从不明网页下载单独的动态库放进程序目录。安装包无法启动时，查看系统安全提示、文件是否下载完成，以及当前设备是否受应用安装策略限制。

首次使用以普通权限运行即可。系统代理通常不要求管理员权限，TUN 则可能需要提升权限或额外网络组件。不要为了省去一次授权，把所有网络程序长期设成管理员启动。若程序可以打开但内核立刻退出，先看日志是否提示端口占用、文件路径不可写或内核启动失败，再处理对应原因。

建立分组并更新订阅

在“订阅分组”中新增一个分组，填写容易辨认的名称，再粘贴完整订阅地址。保存后执行更新，确认更新作用于当前分组。导入单条分享链接则使用从剪贴板导入的功能，不要把整段分享文本填入订阅地址栏。两种方式产生的条目可能相似，但只有订阅分组保留后续批量更新的来源。

更新结束后，先取消服务器列表中的关键词过滤，再检查分组是否选中。列表为空不一定是下载失败，也可能是筛选条件把结果全部隐藏。选择一条服务器并设为活动项，确认协议名称与预期一致。若同名条目很多，按来源分组整理，不要仅凭名称末尾的文字判断连接资料是否相同。

订阅更新失败时，先检查地址是否被截断、是否误复制了账户网页，再查看具体错误。某些订阅需要现有代理才能访问，此时应先确认已有连接确实可用，再选择通过代理更新。不要在没有任何有效连接时反复切换更新方式。详细判断可参考订阅更新失败排查清单。

系统代理、TUN 与 Windows 特有问题

在“系统代理”中选择“自动配置系统代理”，再打开遵循系统设置的浏览器进行验证。“清除系统代理”用于撤销客户端写入的系统代理；“不改变系统代理”只是保持现状，并不等于关闭代理。若之前已有其他工具设置了代理，切到“不改变”仍可能继续使用旧地址，因此排查时要查看系统设置中的实际值。

浏览器可用而部分应用不通时，先判断该应用是否读取系统代理。确有接管需求时再启用 TUN，按提示授权，观察虚拟网卡和内核日志。启用后若整机断网，立即关闭 TUN，回到已验证的系统代理基线，然后逐项检查虚拟网卡、路由冲突和其他网络工具，不要同时修改 DNS 与多套路由规则。

睡眠唤醒后失效，可能是网络接口变化或其他工具覆盖了设置。先重选活动服务器，再重新应用系统代理。异常退出后浏览器打不开网页，应到 Windows 的代理设置里核对本地地址；客户端已经关闭时，指向其端口的代理自然无法响应。手动恢复前先确认该项不是组织管理策略。

开机启动、自动更新订阅和默认路由应在首次连接成功后再配置。防火墙弹窗涉及监听范围时，先保持仅本机使用，不必为了让浏览器连接而开放局域网访问。若日志提示端口占用，关闭旧实例或在客户端设置里换一个未占用端口，并让手动配置代理的应用同步修改，避免入口两端不一致。

macOS：芯片选择与网络权限

macOS 使用 v2rayN 时，先确定芯片，再完成安装与系统授权。应用能启动、菜单栏能看到状态和系统网络请求已经使用代理，是三个不同结果。桌面系统可能同时存在无线网络、有线网络和其他虚拟接口，切换网络后应重新检查当前接口的代理状态，不要只根据客户端里的开关位置判断。

按芯片安装并完成首次打开

打开系统的“关于本机”，查看“芯片”或“处理器”。Apple Silicon 对应 arm64 安装包，Intel 对应 x64 安装包；从macOS 下载入口选择对应项。不要仅凭设备外观或购买时间猜测。原生架构通常更合适，下载错误架构后出现无法运行提示，应先换正确安装包，而不是叠加兼容层尝试。

打开下载的磁盘映像，按窗口指引将应用放入“应用程序”，再从该位置启动。不要长期直接在挂载的安装映像内运行，否则更新、文件位置和退出后的行为容易混淆。若已有旧版应用，先正常退出旧实例再替换，避免一个窗口来自旧位置，另一个启动入口指向新位置。

系统阻止首次打开时，先核对文件来源及应用名称，再按“隐私与安全性”中针对该应用的提示处理。不要为打开一个应用关闭整个系统的安全机制。受管理设备可能禁止用户自行放行，此时应由设备管理方处理。授权窗口出现时，也应确认请求来自刚启动的应用，而不是其他后台程序。

导入订阅并核对当前活动项

进入 v2rayN 的订阅分组功能，新增分组并保存地址，然后执行更新。若从浏览器复制文本后没有成功导入，先粘贴到自己可控的本地文本区域检查是否完整，不要把凭据提交到在线转换工具。订阅返回的可能是错误网页，收到内容并不意味着解析成功，应以客户端更新结果为准。

更新后选中目标分组，清空列表过滤条件，再设置活动服务器。首次验证使用默认生成的配置，不要立即修改传输参数或安全设置。原始资料中的服务器名、连接地址和证书验证名称不一定相同，凭名称相似手动互换字段，可能让界面看起来正常，却在建立加密连接时失败。

多份订阅可分别命名，先验证其中一份，再逐步加入其他分组。自动更新间隔适合在手动更新稳定后设置；休眠期间错过更新并不一定是故障，唤醒后可主动更新一次。若旧条目仍在，不要先批量删除所有内容，应确认是否有单独导入的记录，以及当前查看的是不是刚更新的分组。

检查系统代理与 TUN 授权

启用自动配置系统代理后，在系统设置的“网络”中选择当前使用的网络服务，查看其详细设置里的代理信息。系统不同版本的入口位置可能变化，但检查对象始终是当前活动的网络服务。如果之前配置了自动代理脚本，应记录原值，避免客户端接管后无法恢复原来的工作环境。

先用遵循系统代理的浏览器验证。某些应用有独立代理设置，某些连接不会读取系统代理；这类差异不是订阅丢失。需要扩大接管范围时再尝试 TUN，按应用与系统提示处理权限。若授权后没有生效，查看日志是否真正建立了虚拟接口，而不是只看开关是否处于开启状态。

从无线网络切换到有线网络，或睡眠后重新连接时，先检查基础网络能否正常取得地址，再重新应用代理。若只有特定网络环境失败，保留同一服务器和同一路由进行对照。公共网络需要先完成其正常登录流程；尚未完成网络认证时，客户端内核启动成功也不能替代这一步。

退出应用前先撤销由它设置的系统代理，或确认应用正常退出会按设置恢复。若异常退出后网页无法打开，进入当前网络服务的代理设置，核对是否仍指向已停止的本地入口。保留原先必要的工作配置，不要一键清空所有网络服务。更多共性问题可查看常见问题页，不必把每次网络变化都当成安装损坏。

Linux：包格式、桌面代理与权限

Linux 的发行版、桌面环境和权限机制差异较大。本章以图形桌面中的 v2rayN 为主线，先通过系统软件安装器装包，再在客户端完成订阅与代理设置。这里需要分清包管理器负责安装文件，桌面环境负责部分系统代理设置，而内核与网络接口负责实际连接，三者的错误不能混在一起处理。

核对发行版格式与处理器架构

从Linux 下载入口选择安装包。使用 deb 包体系的发行版选择 deb，使用 rpm 包体系的发行版选择 rpm；同时区分 x64 与 arm64。包格式和处理器架构是两个维度，选对其中一个仍可能无法安装。可在系统“关于”或硬件信息界面查看架构，不要只按设备品牌判断。

用发行版自带的软件安装器打开安装包，阅读依赖和权限提示后安装。若提示缺少依赖，先检查发行版支持范围与软件源状态，再使用系统提供的修复入口。不要强行忽略依赖检查，也不要把其他发行版的底层运行库直接复制过来，这会让后续更新和卸载失去可靠依据。

安装后从应用菜单启动，不要默认使用管理员身份运行整个图形程序。普通用户配置和管理员配置通常不在同一位置，混用可能出现“刚导入的订阅不见了”或配置目录权限异常。若曾经提升权限运行，先确认当前用户能否正常写入自己的应用配置，再继续迁移设置。

导入订阅并确认桌面代理范围

在订阅分组中新增地址，保存后更新，再从列表选择活动服务器。若复制粘贴内容不完整，检查剪贴板里是否混入终端换行、网页说明或全角符号。初次连接不修改高级传输参数。订阅解析成功后仍无法连接，应看内核日志，而不是持续重复导入同一地址。

开启系统代理后，进入桌面环境的网络代理设置，核对代理模式和本地入口。不同桌面环境对系统代理的读取方式不同，部分应用只读取自身设置，另一些程序依赖启动时的环境变量。因此浏览器可用，不能直接推断后台服务、沙箱应用或命令行程序也会采用同一套代理。

如果某个图形应用提供独立代理设置，可按客户端界面显示的实际监听地址、端口和协议填写。不要把 SOCKS 入口填进仅接受 HTTP 代理的字段，也不要把订阅地址填成代理服务器地址。修改后重启该应用再测试，避免旧进程继续使用启动时缓存的网络设置。

TUN 权限、接口冲突与恢复顺序

需要接管更多应用时，再启用 TUN。它涉及虚拟网络接口、路由以及应用所需的网络权限，具体授权入口以客户端和发行版提示为准。若界面已打开但日志报告创建接口失败，应先处理权限与运行环境，不要把失败归因于远端服务器，也不要直接给整个应用目录放宽所有访问权限。

启用 TUN 前关闭其他同类网络工具，并确认系统没有必须保留的特殊路由。容器、虚拟机和远程办公网络可能使用独立网段，与新的接管规则产生交集。出现局域网服务访问异常时，先关闭 TUN 验证能否恢复，再添加必要的直连规则；不要一次性改掉所有接口的默认路由。

若系统代理在退出后残留，通过桌面环境的网络设置恢复之前记录的模式。若 TUN 关闭后仍异常，查看客户端是否已正常停止相关进程，再检查其他工具是否接管了网络。远程桌面设备尤其要谨慎，涉及路由的调整应确保有本地恢复途径，避免修改后失去管理连接。

最后再设置登录启动与订阅自动更新。桌面会话尚未建立时启动图形客户端，可能缺少桌面代理服务；无线网络尚未连上时更新订阅，也可能暂时失败。先确认手动启动、手动更新和退出恢复都稳定，再启用自动化，便于把会话顺序问题与连接资料问题分开。

Android：导入、VPN 授权与后台运行

Android 首选 v2rayNG，需要 V2Fly 内核时再选择 v2flyNG。两者安装和导入的基本路径相近，但内核能力不能混用。手机上的连接按钮通常通过系统 VPN 接口接管流量，与桌面上“给浏览器设置系统代理”不是同一种操作。理解这个区别，可以减少“还要去哪里开系统代理”的反复寻找。

选择架构并完成安装

进入Android 下载入口，一般较新的主流设备优先选 arm64；无法确定架构或出现不兼容提示时，可考虑通用版，并核对设备系统要求。通用版解决的是架构覆盖，不会让旧系统自动满足应用所需的运行条件。不要把“安装失败”直接理解成订阅或服务器问题。

打开安装文件时，系统可能要求允许当前浏览器或文件管理器安装应用。只对这次实际使用的来源授权，安装完成后可按需要关闭该权限。更新已有应用时，先保存必要设置；如果系统提示签名不一致，不要直接卸载，先确认安装来源与原应用是否一致，卸载可能同时删除本地资料。

首次打开后，先查看应用是否能正常进入主界面，再导入连接资料。某些设备的安全或工作资料策略限制 VPN 功能，应用安装成功也不代表系统允许建立 VPN。若设备由组织管理，应按管理策略使用，不要通过反复重装绕过限制。系统时间同样应保持自动同步。

订阅分组、分享导入与活动配置

在订阅分组设置中新增名称与订阅地址，保存后执行更新；菜单名称会随客户端和界面版本有所不同，应按功能寻找。若拿到的是单条分享链接，使用从剪贴板导入或相应的扫描入口，不要将账户后台网页粘贴为订阅。导入结果出现后，点击要使用的配置，使它成为当前活动项。

列表里存在条目不等于当前选择正确。更新后名称可能相同，先核对所属分组、协议和配置来源。若订阅内容使用 Xray 特有能力，应在相应客户端验证，不要为了消除解析错误随意删除安全字段。需要了解差异时，阅读Xray 与 V2Fly 内核选型说明。

订阅更新提示成功但列表为空时，检查分组可见性和过滤条件，再查看更新日志。若返回的是登录网页或错误页，换客户端通常不会解决地址本身的问题。网络不可达时可换一个正常网络复测，但保持订阅地址不变；每次同时换网络、地址和客户端，会失去判断依据。

VPN 接管、应用分流与后台限制

点击连接后，系统首次会显示 VPN 连接请求，确认请求应用正确后授权。状态栏出现 VPN 标识，只说明系统建立了该接口，不保证远端服务器可用。接着用浏览器打开目标页面，并查看客户端日志。有独立 VPN 的工作应用可能与之冲突，同一用户环境通常只能有一个活动的普通 VPN 服务。

Android 不需要再套用桌面端的系统代理步骤。若只有个别应用不走代理，查看客户端是否启用了分应用代理，以及该列表表示“只代理选中应用”还是“绕过选中应用”。这两个模式语义相反。修改后断开并重新连接，重新打开目标应用，避免旧连接继续保持原路径。

锁屏后断开，先查看系统的电池优化、后台活动和自启动设置。不同设备的入口不同，应针对当前客户端逐项调整，而不是关闭全机的省电功能。把应用留在最近任务中不一定足够；反过来，允许后台运行也无法修复无效订阅，因此要先证明前台连接稳定，再排查后台行为。

在无线网络与移动网络之间切换后，先确认基础网络能访问普通网页，再重新连接。若启用了系统“始终开启 VPN”或断开时阻止其他连接，客户端退出后可能表现为整机无法联网。排查时先了解这两项的作用，再决定是否暂时关闭。恢复正常后再按实际需求设置，避免把系统的阻断行为误判为客户端卡死。

代理与路由：区分入口和出口

代理设置可以拆成两层：第一层决定应用请求怎样进入客户端，第二层决定进入后从哪个出口离开。系统代理和 TUN 主要解决第一层，路由规则主要解决第二层。开启 TUN 不代表所有请求都会选择代理出口；选择直连规则也不意味着流量没有经过客户端。先画清这条路径，再讨论“全局”或“绕过”的名称。

系统代理三态与 TUN 的边界

“自动配置系统代理”会让遵循系统设置的应用指向本地入口；“清除系统代理”撤销相应设置；“不改变系统代理”保留现有状态。三者不是连接质量档位。若本地内核已经停止，而系统仍指向它的端口，浏览器会失败。若系统代理已经清除，内核即使继续运行，浏览器也可能直接联网。

TUN 通过虚拟网络接口接收符合接管条件的流量，适合不读取系统代理的应用，但也引入权限、路由和 DNS 协作问题。两种方式可以在特定环境共存，却不适合首次排查时一起启用。先证明系统代理路径正常，再添加 TUN；失败时便能明确问题来自新增的接管层。

先用预设，再添加最小规则

首次使用先选择客户端提供的合适路由预设，确认基本连接，再处理某个站点或局域网服务。通常规则按顺序匹配，前面的宽泛规则可能遮住后面的具体规则。添加规则后应检查它的位置、匹配类型和出口名称。仅把域名放进列表，却选择了错误出口，结果仍会与预期相反。

geosite:cn 表示引用对应域名集合，geoip:private 表示引用私有地址集合；它们依赖运行环境提供相应规则数据，不是所有配置中都天然有效。direct 通常只是配置作者给直连出口起的标签，只有确实存在同名出口时，规则引用才有意义，不能把标签当成内核保留的自动出口。

局域网打印机、家庭存储或路由器管理页失效时，先检查私有地址是否直连，以及目标名称能否解析到正确的本地地址。局域网发现还可能涉及广播或组播，不完全等同于访问一个网页。不要因为设备列表为空就把所有请求切到直连，应分别测试直接地址访问和自动发现功能。

把 DNS 与验证方法放在一起

域名规则需要客户端知道请求的目标名称，地址规则则依赖目标地址。应用提前自行解析、使用加密解析或只向代理发送地址时，匹配条件可能变化。DNS 设置还受客户端接管方式影响。遇到域名访问失败，应先查看解析结果和路由日志，而不是立即关闭证书验证或随意替换全部解析服务器。

浏览器的安全 DNS、系统解析、客户端 DNS 和 TUN 的 DNS 接管可能同时存在。先记录谁负责解析，再改动其中一层。若改动后只有浏览器表现不同，检查浏览器独立设置；若所有应用都失败，回到系统网络和接管层检查。解析缓存会影响复测，修改后可重新启动目标应用建立新连接。

验证规则时，固定一个目标和一条活动服务器，只更改一条规则，观察新请求命中的出口。网页缓存、已有长连接和连接复用都可能让结果延迟体现。先关闭目标应用再打开，必要时重连客户端，不要只连续刷新同一页面。日志中的目标和出口应与实际测试时间对应，避免读取旧记录。

“全局”一词在不同客户端中可能指代理接管，也可能指路由预设，因此描述问题时应写出具体菜单和选项。规则数量多不等于更准确；保留每条自定义规则的用途，遇到异常才能按新增顺序回退。日常只需要解决明确的站点与应用需求，不必把所有可见高级选项同时启用。

配置文件：从入口读到路由

图形客户端通常会根据服务器、订阅和路由设置生成运行配置。界面中的一项选择，可能同时影响配置里的多个字段。手动阅读有助于判断问题，但直接修改运行文件不一定能保存下来：切换服务器、更新订阅或重启内核时，客户端可能重新生成它。需要长期保留的设置，应优先通过界面或明确的自定义配置入口管理。

认识主要字段及标签引用

inbounds 定义本地接收请求的入口，包含监听地址、端口和入口协议；outbounds 定义请求离开时使用的出口；routing 决定请求与出口的对应关系。入口端口不是远端服务器端口，把两者交换会导致本地应用连不上，或者内核尝试向错误位置建立连接。

tag 是用于引用的名称，应在同一配置中保持清晰且不重复。路由里的 outboundTag 必须指向已经定义的出口，大小写也应保持一致。log 控制日志行为，dns 定义内核相关的解析设置；它们不能弥补缺失的出口，更不能自动补全订阅中错误的认证信息。

用可运行的直连配置理解结构

下面是一份 Xray 直连演示配置，只在本机回环地址开放 SOCKS 入口，并把请求交给直连出口。它不包含远端代理服务，也不会把流量送到订阅服务器。示例用于理解配置结构，不应覆盖客户端已经生成的生产配置；需要使用时，应通过支持自定义配置的入口单独保存并选中。

{
  "log": {
    "loglevel": "warning"
  },
  "inbounds": [
    {
      "tag": "local-socks",
      "listen": "127.0.0.1",
      "port": 10808,
      "protocol": "socks",
      "settings": {
        "auth": "noauth",
        "udp": true
      }
    }
  ],
  "outbounds": [
    {
      "tag": "direct",
      "protocol": "freedom"
    }
  ],
  "routing": {
    "rules": [
      {
        "type": "field",
        "inboundTag": ["local-socks"],
        "outboundTag": "direct"
      }
    ]
  }
}

示例中的监听端口必须未被其他程序占用。若客户端现有内核已使用相同端口，应停止旧配置或在独立配置里换一个端口，并同步修改测试应用的入口。这里采用仅本机监听和无认证的组合，是因为连接范围限定在本设备；不要未经评估就把监听地址改为所有网络接口。

这段配置里的 SOCKS 入口不能直接当作 HTTP 代理使用。浏览器或其他应用若明确支持 SOCKS，应填写本机地址和对应端口；只接受 HTTP 代理的输入框不能套用同一协议。支持 UDP 的入口也不代表整条链路必然可用，应用、接管方式和实际出口都需要支持相应传输。

修改边界与错误恢复

JSON 的对象使用双引号键名，不支持在普通标准 JSON 中随意插入注释，最后一个成员后也不能多写逗号。布尔值与数字不应因为复制习惯全部加上引号。出现解析错误时，先看日志给出的行列附近，通常是括号、引号或逗号问题；不要在结构尚未通过解析时继续调整网络参数。

结构合法只是第一步。内核还会检查字段、协议和引用关系，之后才进入实际联网阶段。把错误分成“文本解析失败”“配置校验失败”“连接建立失败”三类，可明显缩小范围。若日志提示未知字段或不支持的安全模式，先核对当前内核类型与配置来源，不要通过删除关键字段让它勉强启动。

涉及 TLS 或 REALITY 时，服务器地址、验证名称和其他协商参数具有不同用途，应严格按连接资料填写。不要把服务器证书验证问题当成普通开关故障，更不要为消除报错长期关闭验证。先检查设备时间、资料是否过期，以及选择的内核是否支持对应能力，再考虑向资料提供方确认参数。

自定义配置往往不会自动继承图形界面的全部选项。界面里更改路由，未必会改动独立配置里的规则；反过来，编辑文件也未必更新服务器列表。需要深入了解各段关系，可继续阅读配置文件 JSON 结构详解，先确认配置来源和生效位置，再决定修改方式。

配置常见问题：按失败位置检查

排错时先说清“哪一步失败”，再选择检查对象。安装失败属于运行环境问题；订阅失败属于资料获取或解析问题；内核启动失败属于本地配置问题；启动后打不开网页才进入流量路径与远端连接检查。下面按常见现象组织，先恢复最小可用状态，再逐项加回高级设置，避免靠反复切换碰运气。

订阅失败、列表为空或协议不兼容

订阅更新超时，先检查基础网络，再核对地址是否完整及是否需要已有代理。若收到内容但解析失败，查看返回内容是否为错误网页、格式是否被当前客户端支持。链接失效、账户状态变化和客户端过旧都可能导致失败，但需要根据具体提示判断，不能仅凭“昨天可用”排除资料来源的问题。

更新成功却看不到记录，先清空关键词筛选，查看当前分组和隐藏状态，再确认更新的究竟是哪一组。不要立刻删除所有分组重新建。多订阅并存时，可先停用不相关分组，减少同名条目干扰；整理方法见v2rayN 订阅分组与过滤说明。

出现不支持的协议或字段时，先核对配置要求的内核。更换界面主题、修改端口或开启 TUN 都不会增加协议能力。桌面使用 v2rayN 时检查活动配置对应的内核类型；Android 则按 Xray 或 V2Fly 需求选择相应客户端。迁移后先测试一条配置，确认可用再导入剩余资料。

显示连接成功，网页仍打不开

先确认客户端是否只是启动了内核，还是已经产生了实际请求日志。没有请求到达时，查看系统代理、应用独立代理或 TUN 的接管范围；有请求但连接失败时，再看远端地址、认证、传输和 DNS。状态栏的连接标识描述本地状态，不能替代对目标访问结果的验证。

所有域名失败而某些直接地址可访问时，可以把 DNS 列为检查方向，但不能据此直接下结论。加密站点通常依赖域名与证书匹配，直接用地址打开出现证书提示不是有效的等价测试。应结合日志中的解析错误、请求目标和出口判断，不要为了完成测试忽略证书警告。

只有一个站点失败时，保持同一配置测试其他正常目标，再检查该站点的路由、应用缓存与远端限制。只有一个应用失败时，查看它是否采用系统代理或被分应用规则排除。若切换服务器后恢复，记录差异再继续判断，不要把单次成功当作全部配置正确的证明。

TUN 开启后全机断网，先关闭 TUN，清理当前测试中的额外接管层，回到之前可用的系统代理方式。随后检查权限、虚拟接口、其他 VPN 工具及 DNS 接管。一次只恢复一项。若通过远程连接管理设备，应先保留本地恢复方式，不要在唯一管理链路上连续试改路由。

退出、更新与跨设备迁移

退出客户端后网页打不开，检查系统是否还指向已停止的本地代理。先恢复原有系统代理状态，再判断基础网络。Android 还要核对始终开启 VPN 和断开阻断选项。不要把设备重置网络作为第一步，因为它可能同时清除无线网络、工作网络和其他需要保留的配置。

升级后异常，先正常退出旧实例，再确认新的启动入口和配置目录。不要同时保留两个自动启动项。若使用自定义配置，核对新内核是否仍接受原字段；若使用订阅生成配置，先用默认选项重新验证。保留备份后再迁移，避免一边更新一边清空唯一可回退的设置。

跨设备迁移应优先迁移订阅来源和必要规则，不要直接复制整份系统接管配置。本地端口、监听地址、权限和接口名称可能与新设备不同。新设备先完成单条连接验证，再加入分组、自动更新和分流。旧设备确认不再使用后，撤销其系统代理与自动启动，防止留下难以辨认的后台状态。

需要进一步求助时，整理操作系统、客户端名称、内核类型、失败步骤、经过遮盖的错误文本，以及是否启用 TUN。不要附完整订阅和账户凭据。更多独立问题可在常见问题页查阅；若尚未建立过一次成功连接，返回快速上手教程，从默认设置重新走通主线。