按平台选择 开源客户端，从订阅导入到路由分流逐项配置。
客户端负责管理配置，内核负责处理连接。先确认订阅能解析，再决定应用流量如何进入客户端，最后调整分流规则。
这几个环节各自解决不同问题。订阅分组保存配置来源，更新后生成可选择的服务器条目；系统代理或 TUN 模式决定哪些应用请求会被接收；路由预设决定已接收的请求走直连、代理还是阻断出口。列表中有条目，不代表系统代理已经开启；代理已经开启，也不代表每个请求都会走代理出口。排查时分开确认，能避免反复重装客户端却没有改变实际配置。
下方设置窗按常见操作顺序组织。各客户端的菜单名称可能不同，示例用于解释设置含义，不是完整运行配置。首次使用可按教程完成最小连接，再逐项添加订阅更新、私有地址直连和应用接管设置。
订阅分组把来源地址与服务器条目关联，适合需要定期更新配置的场景。在 v2rayN 中先添加分组名称和订阅地址，保存后执行更新订阅；在 v2rayNG 中通过订阅设置添加地址，再返回列表更新。单条分享链接只导入一个配置，不会自动成为可更新的订阅。分组名称用于本地辨认来源，地址则应来自可信提供方。更新失败时先检查地址是否完整、是否过期以及返回格式，避免把网页登录地址当成订阅链接。
订阅分组 → 添加
分组名称：个人订阅
订阅地址：填写提供方给出的订阅链接
保存 → 更新订阅 → 选择配置路由规则按匹配条件把请求送到不同出口，解决局域网访问和代理访问混在一起的问题。先选客户端提供的预设，再根据实际需求添加域名或 IP 规则。规则通常按顺序匹配，较具体的例外应放在宽泛规则之前。直连出口适合私有地址等目标，代理出口使用当前选择的服务器，阻断出口用于明确拒绝的请求。预设名称并不是跨客户端通用标准，不能只看“全局”字样就判断全部应用已被接管，还要检查系统代理或 TUN 设置。
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}系统代理通过操作系统的代理设置，把遵循这些设置的应用请求交给客户端，适合先用浏览器验证连接。在 v2rayN 中选择配置后开启系统代理，并检查浏览器是否使用系统设置。部分应用有自己的代理选项，需要单独填写本地监听地址和端口；另一些应用不会读取系统代理。开启后仍无法访问时，应区分应用未进入代理与服务器连接失败。退出客户端前清除系统代理，能避免系统继续指向已经停止监听的本地端口。
连接测试：开启系统代理
结束使用：清除系统代理
本地监听地址：127.0.0.1
监听端口：以客户端当前设置为准TUN 模式借助虚拟网络接口接收流量，适合需要覆盖不读取系统代理的应用。桌面客户端可能需要提升权限，并处理虚拟接口、DNS 与系统路由；安卓客户端通常通过系统 VPN 授权接管流量。首次连接应先验证基础配置，再增加接管范围，避免把路由问题与服务器问题混在一起。已有 VPN、虚拟网卡或其他代理程序可能影响结果。开启后检查局域网访问和域名解析，异常时先关闭该模式恢复基础网络，再调整设置。
桌面：TUN 模式 → 按提示授予权限
安卓：启动服务 → 允许系统 VPN 连接
验证：目标应用、域名解析、局域网访问图形界面与内核承担不同职责，协议能否运行取决于实际内核及其配置能力。v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核，v2rayN 可按所选配置与客户端提供的选项使用不同内核。切换前核对协议、传输和安全参数，不能把所有配置视为可直接互换。遇到不支持的字段时，先确认配置要求，再选择匹配的客户端或内核。保存一份可用配置后再调整，出现错误时通过日志定位字段，不要连续更改多个设置。
配置类型 → 确认协议与传输
内核设置 → 选择兼容内核
启动服务 → 查看启动日志
修改失败 → 恢复已保存的配置桌面端选择 v2rayN，安卓端优先了解 v2rayNG。安装包要同时匹配操作系统与处理器架构。
v2rayN · 桌面版 / WPF 版
Windows 用户可在 v2rayN 桌面版与经典 WPF 版之间选择。桌面版采用跨平台界面，便于在不同桌面系统上保持相近的操作习惯；WPF 版面向 Windows，适合已有使用经验、希望沿用经典菜单布局的用户。两种界面不能代替系统要求检查，下载前仍需阅读安装说明，确认系统环境与运行依赖。
首次安装建议先保留默认监听设置，导入一条已知可用的配置，再开启系统代理，用浏览器完成基本验证。只有在目标应用没有读取系统代理时，再考虑单独设置应用代理或启用 TUN 模式。这样可以把安装问题、应用接管问题和远端连接问题分开处理。
更新前备份订阅分组、自定义路由和必要的本地设置。迁移到另一种界面时，核对配置导入方式，不要直接覆盖正在运行的目录。结束使用后检查系统代理是否清除；若其他代理工具也会修改系统设置，应明确由哪个程序负责接管，避免相互覆盖。
v2rayN · Apple Silicon / Intel
macOS 使用 v2rayN 桌面版。先在系统的“关于本机”中查看芯片信息，Apple Silicon 对应 arm64 安装入口，Intel 对应 x64 入口。处理器架构决定安装包选择，不能仅凭电脑外观或购买年份判断。安装后按系统提示完成应用打开与必要授权，再进入订阅和代理设置。
系统代理与 TUN 模式不是同一个开关。前者影响遵循系统设置的应用，后者涉及更广的流量接管，并可能要求额外权限。先用系统代理验证浏览器访问，再判断是否需要扩大覆盖范围。办公环境中的设备管理策略也可能限制代理修改，应先确认设备允许进行相关设置。
切换无线网络、接入有线网络或从睡眠中唤醒后，如果表现发生变化，先确认当前网络服务的代理设置，再检查客户端是否仍在运行。应用无法访问而浏览器正常时，优先查看应用自身的网络选项。局域网设备打不开时则检查私有地址直连规则，不要直接把全部流量改成代理。
v2rayNG · Xray / v2flyNG · V2Fly
安卓端优先了解 v2rayNG，使用 V2Fly 配置生态时可考虑 v2flyNG。两款客户端采用不同内核，选择依据应是配置要求与操作习惯，而不是名称是否相似。主流现代手机通常选择 arm64；无法确认架构时查看设备信息，并结合下载页的通用版说明决定。安装权限只对当前使用的安装来源授予。
复制单条分享链接后，可从客户端的剪贴板导入入口添加配置；拿到订阅地址时，应进入订阅设置保存来源并执行更新。完成导入后选中配置，启动服务并允许系统 VPN 连接。系统授权用于建立本地流量接管，不会替用户生成服务器信息，也不能替代有效的订阅来源。
若锁屏后连接经常中断，检查电池优化、后台运行与厂商自启动管理。按应用代理设置会改变实际覆盖范围，修改后要用目标应用验证，不能只观察状态图标。已有 VPN 服务可能与客户端争用系统接管能力，测试前先确认当前活动服务。订阅链接应按私密配置保存，截图分享时遮住地址和认证信息。
v2rayN · deb / rpm
Linux 桌面环境使用 v2rayN 桌面版，按发行版的软件包体系选择 deb 或 rpm，同时确认设备是 x64 还是 arm64。Debian、Ubuntu 等发行版通常使用 deb 包，Fedora 等发行版通常使用 rpm 包。软件包格式与处理器架构是两项独立条件，选对其中一项并不代表安装文件一定适用。
安装后先从应用菜单启动客户端，检查界面与内核能否正常运行，再导入订阅。不同桌面环境对系统代理的管理方式存在差异，浏览器也可能保留独立设置。验证时先确认目标应用实际读取了哪个代理配置，必要时在应用中填写客户端的本地监听地址与端口，而不是反复切换服务器。
TUN 模式涉及权限和路由，应按客户端说明启用。不要为了一个开关长期以高权限运行所有桌面程序。配置登录自启动前先完成手动启动测试，并确认退出客户端后网络能恢复。遇到依赖或权限错误，记录提示与启动日志，再参考安装大全对应章节；自启动问题和连接问题应分别处理。
区分项目、内核与客户端，才能判断配置兼容性。开源协议说明代码使用条件，连接效果仍取决于配置与网络环境。
V2Ray 源于 Project V 的代理工具生态，以可配置的入站、出站和路由机制组织网络连接。入站接收本地请求，出站定义请求如何发出，路由将匹配条件与出口关联。图形客户端把这些设置整理为可操作的界面，负责订阅管理、配置生成、进程启动和日志展示。界面显示已经启动，只能说明部分启动流程完成，仍需检查实际请求是否进入了正确的入口。
“客户端”“内核”“订阅”不是三个可互换的名称。客户端是日常操作工具，内核执行协议与传输逻辑，订阅是配置来源。下载安装客户端后，还需要准备合法取得、适用于当前内核的连接配置。客户端本身不提供订阅来源，也不会因为切换界面而改变服务端要求。理解这层关系，有助于在出现错误时找到负责该问题的环节。
V2Fly 延续 V2Ray 的社区开发与维护，Xray 从相关代码生态发展而来，两者共享部分概念和协议背景，但具有各自的开发方向与功能演进。相似的 JSON 字段不代表所有参数都能互换。协议名称之外，还要核对传输方式、安全设置、服务端能力以及当前内核是否实现所需特性。REALITY 属于安全与传输相关能力，不能只凭一个协议标签判断整套配置是否兼容。
v2rayNG 采用 Xray 内核，v2flyNG 采用 V2Fly 内核；v2rayN 提供桌面图形管理，并可根据客户端选项与配置类型使用相应内核。选择时先看现有配置的要求，再看平台与界面习惯。如果某个字段被拒绝，应记录准确错误信息，核对该字段属于哪个内核体系。单纯更换订阅名称或重命名配置，不会使不兼容的参数获得支持。
v2rayN、v2rayNG 与 v2flyNG 的客户端项目采用 GPL-3.0 开源协议。开源意味着代码可以依据协议进行阅读、使用、修改和分发；涉及修改后分发时，需要履行相应的许可义务。客户端、内核以及随应用使用的其他组件可能适用不同许可，不能用客户端的一张协议标签替代全部组件的许可说明。普通使用者可以先了解客户端的开源属性，开发和分发者则应阅读具体许可文本。
开源是透明的开发方式，不是对所有连接结果的保证。服务器是否可用、订阅是否有效、认证参数是否正确、网络是否允许相应传输，仍需要逐项确认。本站使用中文说明整理选择与配置路径，不给客户端添加主观评分，也不把社区维护等同于固定更新周期。需要对比三款产品时，应围绕平台、内核与配置能力查看具体差异，而不是根据名称推断性能。
客户端更新、内核更新和订阅更新是不同操作。客户端更新可能改变界面、配置生成方式与运行依赖；内核更新影响协议实现和字段支持；订阅更新从来源地址重新获取服务器配置。订阅更新不会自动修复系统代理，应用更新也不会使过期的订阅恢复有效。遇到问题时先记录最近改动，再检查对应层次，避免同时更新所有内容而失去定位线索。
调整前备份订阅分组、自定义路由和已确认可用的配置。备份中可能包含订阅地址、认证信息与服务器参数，应保存在受控位置，不要随日志公开提交。向他人描述错误时，可保留字段名称、错误类型和操作顺序，隐藏敏感值。分享完整订阅与分享单条配置的范围不同，二者都应视为可能具有访问权限的信息。
路由配置也需要维护。域名分类和 IP 分类依赖客户端所使用的数据文件；分类内容变化可能使同一目标命中不同规则。规则顺序、DNS 策略和默认出口会共同影响结果。首屏路由窗只演示匹配与出口的关联，不是可直接启动的完整配置。真实使用时，必须在出站配置中定义对应标签，并确认未匹配请求所用的默认出口。
最近三篇文章从客户端差异、Linux 部署和桌面界面选择切入。基础连接完成后，再按实际平台阅读对应细节。
从适用平台、内核家族、订阅与路由功能、界面习惯四个维度横向对比三款客户端，给出桌面端与安卓端的选型建议。
阅读选型对比 →分别演示在 Debian/Ubuntu 和 Fedora 系发行版上安装 deb、rpm 包，配置桌面登录自启动，并处理权限与系统代理问题。
阅读 Linux 部署 →WPF 版只面向 Windows，Avalonia 桌面版覆盖 Windows、macOS 与 Linux。对比界面、运行依赖与适用场景，并说明如何选择。
阅读桌面版差异 →