V2Ray 全平台安装配置手册

准备工作与配置层次

先确定系统、架构与客户端

安装前先确认操作系统和处理器架构，再决定下载入口。Windows 在“设置 → 系统 → 系统信息”查看系统类型；macOS 在苹果菜单的“关于本机”查看芯片；Linux 查看系统设置中的设备信息；Android 在设备信息中确认系统版本，并结合设备规格判断架构。不要用安装包体积推断是否适合设备，也不要把系统名称相同当作架构相同。

桌面平台优先使用 v2rayN，三个桌面系统的配置思路接近，但权限、系统代理和安装包格式不同。Android 首先考虑使用 Xray 内核的 v2rayNG；已有配置明确依赖 V2Fly 行为时，再考虑 v2flyNG。图形客户端负责管理服务器、订阅和系统入口，内核负责处理连接；界面能启动，并不代表内核已成功运行。

准备订阅地址与恢复记录

客户端本身不提供服务器。开始配置前，需要准备有权使用的订阅地址或单条分享链接，确认服务仍在有效期内，并了解提供方要求的协议与传输参数。订阅地址通常含访问凭据，应当按密码保管。截图、日志和求助记录中都要隐藏完整地址，尤其不能只遮住开头而留下查询参数。

已有客户端配置时，先记录正在使用的服务器、订阅分组、本地监听端口、路由模式及 DNS 设置。需要迁移时使用客户端提供的导出或备份功能，并把备份放到受控目录。操作系统代理设置也应记录原值：设备可能原本就配置了单位网络代理，直接清空会影响原有工作环境。

区分四个容易混淆的环节

第一层是订阅获取：客户端能否从订阅地址读取服务器资料。第二层是内核启动：本地端口是否成功监听。第三层是流量进入：应用有没有把请求交给系统代理、手动代理或 TUN。第四层是出站选择：进入内核的连接按路由规则直连、代理还是阻断。排错时逐层检查，不要把所有异常都归结为服务器失效。

系统代理主要影响遵循操作系统代理设置的应用；有些程序使用独立网络栈，需要单独填写代理地址。TUN 通过虚拟网络接口接收更多流量，但依赖权限、路由和 DNS 配合。路由中的“全局代理”通常只改变已经进入客户端的流量如何出站，不会自动让绕过系统代理的程序改变联网方式。

首次配置建议只启用一条流量入口，先用系统代理验证浏览器访问，再考虑 TUN。暂时退出其他会修改代理、虚拟网卡或网络路由的软件，避免两个工具同时写入系统状态。每次只改一个设置，保留改动前后的日志，成功后再增加自动更新、应用分流等附加功能。

操作前还应确认系统时间准确、磁盘可写、安装目录有足够空间。证书验证依赖时间，配置保存依赖目录权限，内核启动依赖可执行文件完整解压。准备阶段解决这些基础条件，比安装后反复切换协议更有效。需要最短操作路径时，转到入门指南；需要理解具体平台限制时，继续阅读下面各章。

Windows：v2rayN 安装与代理设置

选择桌面版或经典 WPF 版

在Windows 下载入口选择 v2rayN。桌面版使用跨平台界面，经典 WPF 版使用 Windows 桌面界面；两者菜单布局可能不同，配置目标一致。按下载页标注的系统和架构要求选择，不要因为名称中都有 v2rayN 就把两套文件覆盖到同一目录，也不要混用它们各自生成的程序组件。

使用安装程序时，按向导完成安装后从开始菜单启动。使用压缩分发形式时，先完整解压到长期保存、当前账户可写的目录，再运行主程序。不要直接在压缩包预览窗口中启动，也不要只拖出主程序而遗漏旁边的依赖文件。路径尽量简短，避免同步盘、临时下载目录和需要额外授权的系统目录。

首次启动如果提示缺少运行环境，按提示识别所需组件及架构，再通过系统认可的渠道安装。窗口闪退时先查看安全软件的隔离记录、系统事件和客户端日志，不要先关闭全部安全防护。普通系统代理通常不要求管理员身份；只有启用需要系统级操作的功能时，才根据客户端提示提升权限。

创建订阅分组并启动服务器

进入“订阅分组设置”，新增分组，填写便于识别的别名，将完整订阅链接填入“地址（url）”，保存后执行对应分组的“更新订阅”。初次没有可用代理时，通常先尝试不通过代理更新；如果地址必须通过已有连接访问，应在已有连接确认有效后再选择通过代理更新，避免形成启动依赖循环。

更新后先确认列表属于刚才的分组，再选择其中一条服务器并设置为活动项。观察日志是否出现配置解析、内核启动或端口占用错误。延迟测试只适合作为筛选辅助：测试方式与实际应用的连接方式可能不同，最终仍应通过浏览器访问和日志判断。不要把一次测试失败直接当成订阅导入失败。

设置系统代理与按需启用 TUN

在任务栏通知区域打开 v2rayN 菜单，找到“系统代理”，选择“自动配置系统代理”等表示写入系统代理的选项。若通知区域未显示图标，检查隐藏图标区域。随后打开 Windows 的“设置 → 网络和 Internet → 代理”，核对客户端写入的本地地址与端口；设置名称可能随系统界面调整，地址和端口才是核对重点。

“清除系统代理”用于撤销客户端设置，“不改变系统代理”表示不主动修改现有值，二者并不等价。使用手动代理的应用，需要填写客户端实际监听的协议和端口，不能把远端服务器端口填进本地代理框。浏览器扩展可能覆盖系统代理，测试时应暂时恢复浏览器使用系统设置的状态。

TUN 建议在普通代理已经验证后启用。按界面提示处理管理员权限或服务相关要求，再检查虚拟接口和内核日志。如果开启后全部连接中断，先关闭 TUN，确认网络恢复，然后检查是否与其他虚拟网卡、单位网络客户端或安全策略冲突。不要同时更换服务器、修改 DNS 和重装驱动，否则难以判断真正原因。

退出、升级与 Windows 特有问题

关闭窗口可能只是缩到通知区域，并不等于退出。升级前通过托盘菜单真正退出，确认内核进程结束，再使用客户端支持的更新方式或安装新包。保留原配置备份，避免把旧程序组件直接覆盖到新目录。若系统提示文件正在使用，先结束正常会话，不要反复强制删除仍被占用的文件。

异常退出后若浏览器无法联网，先查看系统代理是否仍指向已停止的本地端口，必要时恢复安装前记录的代理状态。若窗口能打开但无法保存配置，检查安装目录写入权限；若开机启动后连接失败，检查网络是否尚未就绪。开机启动和自动连接应当在手动流程稳定后启用，避免把启动顺序问题误判为长期连接故障。

首次安装的依赖、解压位置和启动检查还可对照v2rayN 首次安装与初始设置。如果只有个别应用不走代理，先查应用的网络入口，不需要立即重装整个客户端。

macOS：芯片选择与网络权限

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

先打开苹果菜单中的“关于本机”：显示 Apple 系列芯片时选择 Apple Silicon 安装包，显示 Intel 处理器时选择 Intel 安装包。入口见macOS 客户端下载。架构选择优先依据设备信息，而不是购买年份；同一产品系列可能使用不同处理器，安装包名称也不能替代系统中的实际信息。

打开下载的磁盘映像，按窗口说明将应用放到“应用程序”目录，再从该目录启动。不要长期在挂载的磁盘映像中运行，也不要在多个位置保留同名副本后交替启动。放置完成后可推出磁盘映像，确认正在运行的是应用程序目录中的副本，避免更新时修改了另一份程序。

首次打开若受到系统安全检查限制，先确认文件来源与设备架构，再查看“系统设置 → 隐私与安全性”中的相关提示。只对明确识别的应用执行系统允许的打开流程，不应为了启动一个客户端而全局关闭安全检查。若提示文件损坏、架构不支持或缺少组件，应分别排查，不把所有提示都当成同一种权限问题。

导入订阅并核对活动服务器

打开 v2rayN 的订阅管理入口，在“订阅分组设置”中新增分组，填写别名和完整地址，保存后更新该分组。粘贴时留意从聊天工具复制的内容是否包含说明文字、换行或中文标点。链接中的大小写、编码字符和查询参数都应保留，不要为了让地址看起来整齐而手动删改。

更新完成后选择服务器，确认其已成为当前活动项，再观察内核日志。菜单栏图标与主窗口可能显示不同层级的状态：窗口存在只说明界面正在运行，内核仍可能因为端口或配置问题启动失败。验证连接时先使用一个明确的测试目标，并记录此时的服务器、入口和路由模式，后续比较才有依据。

系统代理按网络服务核对

在客户端选择自动配置系统代理后，进入“系统设置 → 网络”，选择正在使用的网络服务，在详细信息中查看“代理”。无线网络与有线网络是不同服务，切换连接方式后应重新核对。不要只检查未连接的网络服务，也不要因为某一服务显示正确就认为所有网络接口都已应用相同设置。

系统代理需要与客户端正在监听的本地地址和端口一致。部分应用使用自己的代理选项，另一些应用只在启动时读取系统代理；修改后可完全退出测试应用再打开。浏览器中的代理扩展、工作配置描述文件和其他网络工具也可能覆盖设置，应先确定真正控制当前请求的是哪一层。

启用 TUN 时，按客户端提示处理所需权限，并检查日志中是否成功建立接口与路由。并非所有安装形式的权限处理流程都相同，不要照搬其他版本的终端授权命令。若需要重复授权，先确认应用是否被移动过、是否启动了另一份副本，以及配置目录是否仍属于当前账户。

休眠恢复、网络切换与升级

笔记本从休眠恢复后，原有连接可能已失效，尤其是在无线网络、手机热点和有线网络之间切换时。先确认系统本身获得了有效网络，再重新启动客户端连接。若普通系统代理正常而 TUN 异常，重点检查恢复后的路由与 DNS，不必一开始就删除订阅。短暂断网与配置错误应通过重复测试区分。

升级前真正退出菜单栏中的客户端，保留配置备份，再替换应用。程序关闭后若仍不能联网，检查当前网络服务是否残留本地代理。恢复时依据原始记录操作：家庭网络可能适合关闭手动代理，工作网络则可能需要恢复原代理地址。不要把所有代理选项一律清空当成通用修复。

如果安装后无法保存订阅，检查应用配置目录的权限与可用空间；如果只有某个网络环境失败，保留相同服务器和设置换网络复测。一次只改变一个条件，能够分清设备权限、局域网限制与服务器连通性，避免把可用配置改成无法恢复的混合状态。

Linux：包格式、桌面代理与 TUN

按发行版和架构选择安装包

在Linux 下载入口选择 v2rayN。使用 Debian 系包管理的发行版选择 deb，使用 RPM 系包管理的发行版选择 rpm；同时确认处理器是常见的 x64 还是 arm64。包格式与处理器架构是两个独立条件，不能只满足其中一个。衍生发行版还应以自身的软件安装说明和依赖要求为准。

可以在图形软件安装器中打开安装包，由系统处理依赖并完成安装。遇到依赖不足时，先查看安装器给出的具体组件名称与系统支持范围，不要把其他发行版的库文件复制进系统目录。客户端是图形程序，正常使用还需要可用的桌面会话；纯命令行服务器环境不是本章的操作对象。

架构不确定时，可以打开终端执行下面的只读命令。常见输出中，x86_64通常对应 x64，aarch64通常对应 arm64。若输出不同，先核对设备和安装包支持情况，不要通过强制安装绕过包管理器的架构检查。命令输出用于识别环境，不会修改网络设置。

uname -m
cat /etc/os-release

以普通用户启动并导入订阅

安装后从桌面应用菜单启动 v2rayN，先用当前登录账户运行，不要直接把整个图形程序长期作为管理员进程。客户端的配置、缓存和日志一般属于用户环境；交替用不同权限启动，可能造成目录所有者变化，表现为设置无法保存、启动后分组消失或更新配置失败。

在“订阅分组设置”新增分组，填入地址并保存，再执行更新。首次更新失败时看日志中的网络错误与解析错误：前者检查当前网络、DNS 和更新路径，后者检查订阅响应是否真的是客户端可识别的内容。导入成功后设置活动服务器，再观察内核启动结果，不要直接跳到 TUN 设置。

桌面系统代理与应用独立入口

Linux 不同桌面环境的代理配置入口并不统一。GNOME 通常在系统设置的网络代理中管理，其他桌面可能有独立模块；客户端自动写入的范围也取决于当前桌面会话。即使图形设置中显示了代理，某些应用仍不会读取它。先用明确遵循桌面代理的应用测试，再判断系统代理是否工作。

终端中的环境变量与桌面代理不是同一个入口。浏览器能连接，不代表终端程序已经获得代理设置；反过来也一样。需要为某个应用手动配置时，先确认客户端本地监听的协议和端口，再填写该应用支持的代理类型。不要长期写入未知来源的全局环境变量，也不要把订阅地址当作代理服务器地址。

本地端口冲突可通过客户端日志或系统监听信息确认。下面命令列出当前 TCP 监听端口，输出权限取决于账户；重点核对客户端设置中的实际端口，不要求与其他教程中的数字一致。如果已有程序占用，应先识别进程用途，再选择关闭冲突程序或修改客户端端口。

ss -ltnp

TUN 权限、路由与桌面集成

TUN 需要系统网络能力，处理方式依客户端安装形式而异。优先使用界面提供的权限配置与启动流程，不要随意给整个安装目录添加宽泛权限，也不要盲目执行网上的能力授权命令。启用后先确认接口建立成功，再检查流量路由；日志中的权限不足与远端连接超时属于不同问题。

如果开启 TUN 后局域网服务无法访问，检查是否有接管局域网流量、排除地址段或路由优先级相关设置。若系统同时运行其他隧道或容器网络，先停用新增工具做对照，保留原路由记录。不要直接删除所有网络接口；那样既可能中断当前连接，也会让问题失去可重复的检查条件。

部分桌面没有默认显示托盘图标，关闭窗口后仍可能存在后台进程。升级、修改端口或重复启动前，先确认旧实例是否仍在运行。安装包升级应通过对应包管理流程完成，避免同时保留不同来源的程序副本。若程序启动正常但不能写配置，优先检查用户目录权限，而不是继续提高运行权限。

Android：订阅导入与 VPN 接口

选择 v2rayNG 或 v2flyNG

进入Android 下载入口，优先查看使用 Xray 内核的 v2rayNG；已有配置依赖 V2Fly 时，再查看 v2flyNG。多数较新的主流手机可选择 arm64，无法确定设备应用架构时可考虑通用版。设备处理器支持某架构，不一定表示当前系统提供相同应用环境，应结合系统和安装提示判断。

安装时只为执行安装操作的文件管理器或浏览器授予所需权限，完成后可撤销其安装未知应用权限。若系统提示无法安装，区分架构不匹配、存储不足、系统要求不满足和已有应用冲突。不要为了覆盖安装而先删除现有客户端；卸载可能同时删除订阅与本地配置，应先完成备份。

从其他来源迁移应用时，系统可能因为签名差异拒绝直接更新。这种情况不能靠反复点击安装解决。先保存配置，确认目标客户端和来源，再决定迁移方式。v2rayNG 与 v2flyNG 是不同应用，界面相似不代表数据库可以直接互换；跨应用迁移优先使用双方都支持的订阅或分享格式。

添加订阅分组并选择配置

在客户端侧边菜单中查找“订阅分组设置”或对应订阅管理入口，新建分组，填写备注与订阅地址并保存。返回主界面执行“更新订阅”。如果复制的是单条分享链接，应使用从剪贴板导入配置的入口，而不是把它当作远程订阅地址。两种入口用途不同，混用时可能出现无法获取或格式错误。

更新后点选一条配置，使其成为当前选择项，再使用连接按钮启动。若提供方要求特定传输方式或安全参数，应以完整分享内容为准，不要为了简化界面随意关闭相关选项。测试时先保留默认设置，确认基础连接可用后再调整分应用代理、DNS 和路由规则。

理解 Android 的 VPN 授权

首次连接通常会弹出系统 VPN 连接请求。这是客户端借助系统接口接收设备流量的授权，不表示客户端自动获得可用服务器。允许后还需要内核启动和远端连接成功。系统一般不会让两个普通 VPN 应用同时占用同一接口；已有同类连接运行时，应先断开再测试。

Android 端不需要照搬桌面的“自动配置系统代理”步骤。常见使用方式是由客户端建立系统 VPN 接口，再按路由和分应用设置处理流量。界面出现连接标识只能说明接口状态，不能单独证明目标网站已经通过远端服务器访问。应结合应用访问结果、客户端日志和必要的路由检查验证。

“分应用代理”通常可以选择仅让指定应用进入客户端，或排除指定应用，具体取决于界面中的模式。设置后要同时检查模式与名单：同一份名单在“仅代理”与“绕过”模式下含义相反。修改后可断开重连，并完全退出目标应用再测试，避免旧连接继续沿用之前的路径。

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

部分设备会在锁屏后限制后台进程。若前台使用正常、锁屏后中断，检查电池优化、后台活动和厂商自启动管理，针对客户端放行必要限制，不必对所有应用关闭节电策略。先记录断线发生的时间与场景，再区分进程被终止、网络切换和远端会话过期。

从无线网络切换到移动网络后，原连接可能需要重新建立。先确认设备自身网络正常，再断开并重新连接客户端。若某一网络始终失败而另一网络正常，保留相同配置做对照，不要同时修改协议参数。使用私人 DNS、其他本地网络工具或热点共享时，也应记录这些因素，避免漏掉系统层面的差异。

系统中的“始终开启 VPN”和“阻止不使用 VPN 的连接”可能影响断开后的联网行为。开启阻断后，客户端停止时设备不能正常访问网络可能是预期结果，而非系统损坏。排错需要临时断开时，先理解这些选项再调整；受管理设备上的策略不应擅自更改。

订阅、分享链接与更新管理

识别地址与内容的区别

订阅链接通常是一个远程地址，客户端访问它后得到多条配置；单条分享链接则直接描述一条服务器配置。订阅响应可能采用编码文本或其他被客户端支持的结构，但网页链接并不一定就是订阅链接。账户首页、付款页面和说明文档即使能够正常打开，也不能因此放进订阅地址字段。

桌面端通常通过“订阅分组设置”保存远程地址，安卓端通过订阅管理菜单保存。剪贴板导入适合客户端支持的分享内容；从文件导入适合对应配置文件。选入口前先判断手中的材料是什么，不要轮流尝试所有导入按钮。错误入口有时会生成不完整记录，使后续排错更加困难。

粘贴地址后检查首尾空格、换行、转义字符和标点。部分消息工具会把链接后面的句号一起复制，某些网页则显示经过缩短的文字而非真实地址。应复制完整链接目标，保留查询参数，不要手工把编码符号替换成看起来更直观的字符。地址中的示例域名不能用于真实连接。

分组更新与活动配置的关系

建议按来源或用途建立分组，别名写清楚，避免所有订阅都放进一个无法识别的列表。更新时优先选择当前分组，确认返回数量和日志，再考虑更新全部分组。多个来源混合时，某个来源失败不一定影响其他分组；按分组检查能够保留仍可用的配置，避免一次性清空所有内容。

订阅更新可能重建由订阅管理的条目，手动修改这些条目的备注或参数后，下一次更新不一定保留。需要长期自定义的配置，应先了解客户端是否支持复制成独立条目或独立分组，再进行修改。不要在未备份时依靠订阅条目保存唯一一份手工参数，也不要假设列表顺序始终不变。

更新成功后还要核对当前活动服务器。原来使用的条目可能已被删除、改名或替换，客户端也可能保留另一个分组的活动项。先确认选中项所属分组、协议和服务器地址，再重启连接测试。订阅管理与连接管理是两个步骤，更新日志显示成功不能代替实际连接验证。

更新路径与自动更新间隔

不通过代理更新，意味着订阅请求直接使用当前网络；通过代理更新，则依赖已有可用代理。后者适合已经确认连接正常的场景，但如果唯一可用配置已经失效，就可能无法依靠它取得新配置。排查时先明确请求走哪条路径，再针对该路径检查网络，不要只反复点击更新。

自动更新需要“启用更新”等开关处于启用状态，并按界面指定单位填写间隔。若字段标为分钟，就不能把小时数直接填进去。间隔应结合提供方说明、内容变化频率和设备使用习惯设置，过于频繁只会增加请求；间隔设为零时的行为因实现而异，不应把零默认理解成持续更新。

设备休眠、客户端退出或后台被系统限制时，自动更新不一定按时执行。恢复使用后查看最近一次更新结果，必要时手动更新。若每次自动更新都失败而手动更新正常，比较两者运行时的网络状态、代理路径和权限，不必先怀疑地址格式。详细分支见订阅更新失败排查。

从错误类型缩小范围

超时通常表示请求没有在规定时间完成，应检查网络路径和地址可达性；拒绝访问可能与凭据、来源限制或服务状态有关；返回内容无法解析则要确认收到的不是登录页、错误页或其他客户端格式。不要公开完整响应内容，服务返回的资料也可能包含访问凭据和服务器认证信息。

更换订阅前保存仍可用的配置，确认新地址来自原有可信渠道。若怀疑地址泄露，应在提供方支持的情况下重置访问凭据，单纯删除本地分组不能让旧地址失效。关于桌面与安卓入口的逐项对照，可继续阅读订阅链接导入方法。

系统代理、TUN、路由与 DNS

先确定流量入口，再讨论分流

系统代理、TUN 和路由规则解决不同问题。系统代理告诉遵循设置的应用把请求交给本地入口；TUN 通过系统网络接口接收更广范围的连接；路由规则决定进入内核的请求使用哪个出站。只有先确认请求进入客户端，讨论直连或代理规则才有意义，否则规则再正确也不会影响绕过客户端的应用。

首次排查建议使用普通系统代理作为基线，选择一个明确遵循系统设置的浏览器，保持服务器和路由不变。若浏览器正常而另一应用异常，检查后者是否有独立代理、特殊传输或分应用排除。若所有应用都异常，再检查内核、本地端口与远端连接，不要先增加复杂分流规则。

本地监听地址通常使用回环地址，只允许本机访问。开启局域网监听会扩大可访问范围，应明确用途并结合防火墙限制。给手机或其他设备填写代理时，回环地址指向的是那台设备自身，不是运行客户端的电脑；需要使用电脑在局域网中的地址，并确认双方网络可达与监听范围正确。

规则顺序与出站名称

路由规则一般按顺序匹配，靠前的宽泛规则可能遮住后面的精细规则。需要特定域名直连时，应检查它是否已被上方规则匹配，而不是只确认规则存在。出站标签必须与当前配置中实际定义的标签一致；界面中的“代理”“直连”是显示名称，底层标签不一定在所有配置中都完全相同。

下面是 Xray 路由对象的结构示例，仅用于解释规则，不是可直接导入的完整客户端配置。它假定配置已存在名为 direct 的出站，并且所用内核具备对应域名数据。通过图形客户端管理时，优先在“路由设置”中建立等效规则，不要直接修改客户端临时生成的运行文件。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      }
    ]
  }
}

geosite表示按域名集合匹配，geoip表示按地址集合匹配，二者不能互换。域名规则需要内核获得可用于判断的域名信息；应用只提供地址时，匹配结果可能不同。增加规则前先确认输入信息、数据文件和规则顺序，再判断是否需要域名嗅探等能力，不要为了命中一条规则而开启所有选项。

DNS 解析路径与连接路径

DNS 负责把域名解析为地址，代理连接负责传输请求，两条路径可能分开。域名打不开而地址可以访问，只能说明需要进一步检查解析，并不能直接确定是某个 DNS 服务故障。先区分系统解析、客户端内部解析和应用自己的加密 DNS，再确定当前测试实际使用的是哪一条。

系统代理模式下，应用可能自行解析域名，也可能把域名交给本地代理，取决于协议与应用实现。TUN 模式还可能接管 DNS 请求，处理方式与普通代理不同。切换入口后，应重新核对 DNS 设置，而不是假设原有浏览器行为保持不变。排错时一次只调整一个解析入口，避免多个来源相互覆盖。

自定义 DNS 服务器前要确认它在当前网络能够访问，并理解其请求是否经代理发送。不能连接远端服务器时，把所有解析也绑定到同一个失效代理可能形成新的依赖问题。使用域名作为远端服务器地址时，还要考虑建立代理连接之前如何完成首次解析，不能只检查连接建立后的查询。

TUN 的局域网与恢复边界

TUN 接管后，打印机、网络存储和局域网管理页面可能受到新路由影响。先检查客户端是否提供局域网绕过或排除路由，再确认局域网地址段与实际网络一致。不要为了恢复一台设备就添加覆盖范围过大的直连规则；规则越宽，越容易影响原本需要代理的目标。

“全局代理”适合临时验证路由差异，但它不等于系统所有流量都被接管。测试完成后恢复适合日常使用的规则，并确认内网访问。需要逐条理解域名前缀、地址集合和优先级，可阅读v2rayN 自定义路由规则写法，再根据实际目标缩小规则范围。

配置常见问题与恢复顺序

从现象划分故障范围

先记录“哪个应用、哪个目标、哪种网络、从何时开始”出现异常，再确定问题发生在启动、订阅、入口还是出站。窗口无法打开与网站无法访问不是同一类问题；只有某个网站异常与所有应用断网也不能使用相同处理方式。保留失败时的设置和日志后，再执行修改，避免把原始现象覆盖掉。

如果客户端无法启动，检查安装形式、系统架构、运行环境、目录权限和安全软件记录。如果客户端能启动但内核失败，查看第一条相关错误，优先处理配置解析和端口监听。后面大量连接错误可能只是前面启动失败的结果，不应逐条当成独立故障，更不需要立即删除全部订阅。

如果订阅更新成功但无法连接，确认活动服务器属于预期分组，并检查内核是否运行。随后确认测试应用是否进入代理，再看远端连接日志。订阅只是获取配置的渠道，服务器是否可用仍取决于认证参数、服务状态与网络路径。更新成功与实际连通之间必须保留独立验证步骤。

用最少改动建立对照

选定一条服务器、一个测试应用和一个目标，先在当前网络测试，再保持配置不变切换到另一可用网络。若只有一条服务器失败，可在同一分组选择另一条比较；若全部服务器都失败，回到本地入口和网络条件检查。比较时不要同时换应用、路由、DNS 与服务器，否则无法知道哪个变化起了作用。

连接被拒绝、连接超时、认证失败和证书错误含义不同。被拒绝通常说明目标或本地端口没有接受连接；超时表示路径在等待时间内未完成；认证失败要核对配置和服务状态；证书错误应先检查系统时间、域名和所需安全参数。不要用关闭证书验证作为长期修复，它会掩盖真正配置问题。

本地端口被占用时，先识别占用进程。如果是旧的客户端实例，正常退出后重启；如果是其他必要程序，修改当前客户端端口，并同步修改手动代理的应用设置。只改客户端而不改应用，会留下新的入口错误。切勿为了释放一个端口而结束不明系统进程。

断开后的网络恢复与备份

停止客户端后不能联网，桌面端优先检查系统代理是否仍指向本地监听地址；TUN 场景检查接口和路由是否正常退出。Android 则检查是否开启了阻止非 VPN 连接的系统选项。恢复应按各平台原始设置进行，不要把清空全部网络配置作为第一步，更不要在远程工作会话中随意重置网络。

升级后出现异常时，先用备份对照设置变化，检查是否启动了不同安装位置的副本。确需回退，应依据客户端支持的流程操作，并注意配置格式可能已经变化。保留旧配置副本和当前配置副本，不在唯一一份数据上反复覆盖。恢复成功后再补做自动更新、启动项和分流验证。

日志通常包含时间、目标地址、规则与错误原因，分享时只截取复现前后的必要范围，并隐藏认证信息。临时提高日志级别后应在排查结束时恢复，避免长期产生过多记录。向他人描述问题时附上系统、客户端名称、入口方式和已做过的对照，不要只给一张“无法连接”的截图。

常见问答速查

恢复完成后，分别检查浏览器、常用应用、局域网服务和休眠后的连接状态，确认不是只修复了单一测试目标。将最终可用的入口、路由和 DNS 记录到备份说明中；下次排错从这份基线开始。需要重新走一遍操作主线时，返回入门指南，不要把整套手册中的进阶选项一次性全部启用。