订阅地址管理配置来源导入不等于已连接
系统代理决定应用入口先检查应用是否遵循代理
路由规则决定连接出口再检查规则是否命中
按连接经过的顺序理解设置：配置来源、应用入口、路由出口，最后再考虑 TUN 接管。
打开客户端后，先不要同时改动所有开关。服务器列表保存可用配置，订阅分组负责批量更新，系统代理负责向应用公布本地代理入口。三者各有作用：列表里有配置，不代表浏览器已经使用代理；系统代理已开启，也不代表所选服务器能够连接。把每一层单独验证，才容易看清问题发生在哪里。
打开「订阅分组设置」，填写便于辨认的别名，把完整的 V2Ray 订阅链接粘贴到「可选地址(URL)」，保存后执行「更新当前订阅」。分组把地址与服务器列表关联起来，后续更新不必逐条复制分享链接。相比单条手工导入，订阅更适合持续接收配置变更，但更新会改写组内条目。更新前保留自行修改的配置，完成后查看日志与分组筛选。订阅链接可能包含访问凭据，不要放进公开截图。
示例地址仅用于说明字段，不提供订阅服务。
先选中一个服务器并设为活动服务器，再在底部系统代理入口选择「自动配置系统代理」。这个选项修改操作系统的代理设置，让遵循该设置的应用连接到客户端的本地端口；它不是服务器连通性的保证，也不等于所有程序都会接入。相比逐个配置应用，系统代理更便于桌面浏览器上手。终端、游戏或自带代理设置的程序仍需分别检查。停止使用时选择「清除系统代理」，避免应用继续连接已经退出的客户端。
应用是否遵循系统设置，需要单独验证。
先确认应用已经进入客户端，再从底部路由入口选择预设。「绕过大陆」按规则将部分连接交给直连出站，「全局」通常将一般流量交给代理出站，具体仍以生成的规则为准。路由解决的是出口选择，不负责让应用进入代理。相比长期使用全局预设，分流可以让本地服务与代理访问分别处理。自定义规则时优先检查顺序、域名匹配和 DNS 解析结果；每次只修改一项，用同一个目标重试，再观察日志中的出站变化。
预设名称和可用规则以当前界面为准。
先用系统代理完成基础连通验证，再考虑启用 TUN。它通过虚拟网络接口接管符合条件的流量，比只修改系统代理设置覆盖的应用范围更广，也更依赖权限、路由与 DNS 配置。启用前记录当前状态，确认没有其他网络工具同时接管默认路由。Windows 通常需要相应管理权限，其他桌面系统按客户端提示处理。开启后分别检查网页、本地设备与名称解析；如果出现整体断网，先关闭 TUN 恢复基线，再查看日志，而不是继续叠加设置。
先验证活动服务器，再检查权限、虚拟网卡和 DNS。示意保持关闭，不代表推荐一直关闭。
桌面使用 v2rayN；安卓优先了解 v2rayNG，再按内核需求考虑 v2flyNG。
下载前，打开系统信息确认处理器架构，再选安装包类型。客户端名称相近，不表示安装包可以互用；同一款客户端的桌面界面与安卓界面也并不相同。这里的入口先进入下载页对应平台，便于一起查看安装说明和可用选项。不要根据文件大小判断哪个包更适合，架构、系统和软件包格式才是选择依据。
选择 v2rayN。下载页区分新一代跨平台界面的桌面版与经典 WPF 版，按使用习惯和系统要求选择，不必为了完成首次导入同时安装两版。
先在「设置 → 系统 → 系统信息」查看系统类型。安装后保留客户端所需的配套文件；遇到启动提示，按下载页说明处理运行环境。首次连接先用系统代理验证，TUN 留到基础连接正常后再配置。
前往下载 Windows 客户端 →选择 v2rayN，并区分 Apple Silicon 与 Intel 安装包。打开「关于本机」，查看显示的是芯片名称还是 Intel 处理器，再进入对应入口。
首次打开时如有系统安全提示，先确认文件来源，再按系统界面处理。不要为了启动程序关闭整套系统保护。订阅导入逻辑与其他桌面系统相近，但网络权限、系统代理入口及 TUN 授权方式应以本机提示为准。
前往下载 macOS 客户端 →优先了解采用 Xray 内核的 v2rayNG；需要 V2Fly 内核配置时，再考虑 v2flyNG。较新的主流设备通常选择 arm64，架构不确定时查看通用包说明。
安装后先添加订阅分组、更新配置并选中服务器，再启动连接。系统会请求建立 VPN 连接，这是本地流量接管所需的授权界面。若后台连接频繁中断，检查电池优化和后台运行限制，不要只反复更新订阅。
前往下载 Android 客户端 →选择 v2rayN，再按发行版选择 deb 或 rpm 格式。除常见的 x64 外，下载页也提供 arm64 对应入口，处理器架构与软件包格式需要同时匹配。
先确认图形桌面环境和发行版要求，再用系统的软件安装界面处理安装包。不同桌面环境对系统代理的应用范围可能不同；浏览器可以访问而终端不通时，分别检查程序的代理设置，不要直接认定客户端启动失败。
前往下载 Linux 客户端 →先让一条配置稳定工作，再增加分流规则或接管方式。
准备好客户端和有权使用的订阅地址。客户端负责读取配置并建立连接，本身不会自动生成远端服务器；安装完成后列表为空属于正常情况。下面以 v2rayN 桌面界面为主，安卓使用 v2rayNG 时，订阅分组、活动配置和连接授权分别在手机界面完成。不同界面的菜单位置可能变化，操作目标保持一致。
进入「订阅分组 → 订阅分组设置」，新增分组，填写别名与完整地址后保存。回到订阅分组菜单，执行「更新当前订阅」。只有看到更新完成并且列表出现条目，才进入下一步；单纯点击确定只是保存地址，不会证明地址可用。
如果列表仍为空，先取消不必要的分组筛选，再检查日志。地址过期、返回登录页面、格式不兼容以及本地网络请求失败，都可能表现为空列表。复制地址时避免带入换行、空格或聊天软件附加的标点。不要把订阅地址贴到公开讨论区求助，描述报错并隐藏敏感部分即可。
查看订阅导入步骤 →在列表中选择准备使用的服务器，通过右键菜单设为活动服务器。接着在主窗口底部选择「自动配置系统代理」，路由先使用符合当前需求的现有预设。首次连接不需要同时开启 TUN、修改 DNS 和添加自定义规则，保留简单配置更方便定位故障。
确认客户端仍在运行，再打开浏览器测试。浏览器扩展如果独立控制代理，可能覆盖系统设置；使用自定义网络配置的程序也可能不读取系统代理。此时先检查应用设置，而不是重复安装客户端。准备退出时先清除系统代理，可以减少应用继续指向本地已停止端口的情况。
区分系统代理与路由 →用同一个目标重复测试，观察页面能否完成加载，再查看客户端日志。列表中的延迟结果只说明对应测试条件下的表现，不等于真实下载速度，也不能替代完整的网页访问。能打开首页但资源加载失败时，要继续检查相关域名的路由和解析情况。
如果无法连接，先判断内核是否正常启动，再看服务器连接、域名解析与应用入口。每次只改一个条件，保留修改前后的结果。更换服务器能够恢复时，问题更可能在远端配置或线路；所有服务器同时失败时，则优先检查本地网络、代理端口和其他网络工具的冲突。
查看连接验证方法 →先区分客户端、内核和协议，再判断配置能否导入、能否运行。
Project V 是理解 V2Ray 相关技术生态的背景。随着社区发展，V2Fly 延续相关项目的维护，Xray 则形成了另一条独立发展的内核路线。它们共享部分概念，但功能推进、协议扩展与配置要求并不完全相同。搜索「V2Ray 官网」时，也要先分清正在寻找的是项目文档、客户端说明，还是远端服务的配置页面。
图形客户端提供服务器列表、订阅管理和设置入口，内核负责依据配置处理网络连接。因此，界面能够识别一条分享链接，只能说明完成了部分解析；真正启动时，还要看所用内核是否支持链接包含的协议、传输与安全参数。讨论兼容性时，把客户端和内核分别说明，比只说「用了 V2Ray」更容易得到准确帮助。
v2rayN、v2rayNG 与 v2flyNG 都是免费开源客户端。v2rayN 面向桌面使用场景，提供订阅分组、系统代理与路由等管理入口；v2rayNG 面向安卓，采用 Xray 内核；v2flyNG 则为需要 V2Fly 内核的安卓配置提供另一种选择。这里的开源指代码按项目许可证开放，不表示客户端会附带可用服务器，也不代表某个订阅来源的服务质量。
许可证需要按组件分别理解。v2rayN 与 v2rayNG 客户端采用 GPL 系列许可，V2Fly、Xray 内核采用 MPL 系列许可；客户端、内核和依赖组件并不是同一份软件。普通使用者可以从开源属性了解维护方式；需要修改、重新分发或集成时，应进一步阅读所采用组件的具体许可证与附带声明，而不是仅凭一个「开源」标签推断全部义务。
VMess、VLESS 和 Trojan 等名称只描述配置的一部分。传输方式、TLS 设置、服务端名称、路径以及其他安全参数也会影响连接。以 VLESS 协议为例，导入时不能只保留地址和端口，再把其余字段当作可选装饰。使用 REALITY 等特性时，还需要确认当前内核的支持情况与服务端配置一致。遇到无法运行的配置，先对照字段和内核能力，不要凭协议名称直接换客户端。
订阅也不是单一文件格式。有的订阅返回多条分享链接，有的返回编码后的链接集合，还有的提供原生配置。图形客户端可以识别的输入范围有差异，原生 JSON 配置与链接列表不能简单互换。若来源提供多个格式选项，先选与客户端匹配的格式，再观察导入日志。不要将包含认证信息的订阅交给不熟悉的在线转换页面。
更新客户端、更新内核与更新订阅分别解决不同问题。客户端更新影响界面和配置管理，内核更新影响连接处理及协议特性，订阅更新则从来源获取新的服务器参数。列表过期时先更新订阅；配置提示不支持某项特性时，再检查内核和客户端的兼容说明。把三个动作混为一谈，可能在没有改变故障原因的情况下引入新的变量。
社区维护意味着功能会持续变化，教程中的界面位置也可能调整。更新前保存必要的配置与自定义规则，阅读变更说明，尽量一次只更新一个环节。更新后先复测原来正常的目标，再尝试新功能。旧界面截图可以辅助理解，但菜单名称、可选路由与权限提示，应以当前安装的客户端为准。
从具体故障和配置差异入手，先确定检查范围，再修改设置。
浏览器走不了代理和终端命令不走代理是两类问题：分别检查系统代理状态、浏览器扩展冲突以及终端环境变量的设置方法。
阅读文章 →解释 Base64 订阅、原生 JSON 配置和 vmess:// vless:// 分享链接的结构差异，以及在 v2rayN 中导入和互相转换的方法。
阅读文章 →梳理 Xray 与 V2Fly 两条内核分支的由来，对比 XTLS Vision、REALITY 等特性的支持情况，说明 v2rayNG 与 v2flyNG 该怎么选。
阅读文章 →