Windows
v2rayN桌面版采用跨平台界面，经典 WPF 版沿用传统桌面操作方式。两种入口先按界面偏好与系统要求选择，不要把界面差异误认为节点协议差异。安装前在系统设置中确认设备架构，首次启动后先导入一条可用配置，再设置系统代理。
迁移配置时保留原订阅分组和自定义路由。若应用没有跟随系统代理，先检查应用自身设置，再考虑其他接管方式。
图形客户端负责管理配置，内核负责执行连接。先确认服务器信息完整，再决定哪些应用进入代理、哪些请求需要直连。下面按桌面、安卓与配置结构拆解操作，右侧片段只说明局部字段，不是可以直接连接远端服务器的完整配置。
在订阅分组设置中添加地址，保存后执行更新，再检查服务器列表是否出现协议、地址与端口。订阅链接与单条分享链接的入口不同，不能只凭链接长度判断格式。为不同来源建立独立分组，可避免更新时混淆节点。订阅地址通常包含访问凭据，应只保存在自己的设备中；排查时记录错误提示，不要把完整地址贴到公开页面。
选中活动服务器后，先确认内核已启动，再设置系统代理。系统代理向遵循系统设置的应用提供本地代理地址，并不等于所有程序都会经过代理。路由模式则决定进入内核的请求交给哪个出站，两者属于不同层次。首次使用可保持默认路由，先验证浏览器访问，再逐项调整规则；需要接管更多应用时，再阅读虚拟网卡模式的权限与冲突说明。
端口可达不代表协议握手成功。TCPing 主要反映建立 TCP 连接的情况，真连接测速还会涉及代理握手与目标请求，但同样不能代表所有网站的体验。选择节点后，以客户端日志、浏览器请求和出口地址共同判断连接是否生效。若测速成功而应用仍失败，优先检查应用是否使用系统代理，再检查路由和 DNS，不要立即反复更换服务器。
{ "inbounds": [ { "tag": "socks-in", "listen": "127.0.0.1", "port": 10808, "protocol": "socks", "settings": { "auth": "noauth", "udp": true } } ]}v2rayNG 可通过剪贴板导入单条分享链接，也可在订阅设置中保存订阅地址并更新内容。导入前确认剪贴板没有多余说明文字，导入后检查服务器类型与传输参数。节点名称只是备注，不能据此判断实际协议。首次配置建议先测试一条信息完整的服务器，确认可连接后再整理订阅分组，这样更容易区分格式问题与服务器本身的问题。
首次启动连接时，Android 会显示 VPN 连接授权。允许后，客户端才能通过系统提供的接口接收应用流量。设备上同时运行其他 VPN 类工具可能产生占用冲突，应先确认当前连接归属。按应用代理决定哪些应用进入客户端，路由规则决定这些请求如何出站；排除应用后，该应用的连接不会再由同一套路由接管，排查时需要分开检查。
若熄屏后断开，先检查系统电池策略、后台活动权限与客户端通知状态。若只在移动网络或无线网络下失败，记录切换前后的日志，区分域名解析、远端握手与底层连接超时。不要一次修改多个设置，否则难以判断哪项调整有效。对 REALITY 或特殊传输节点，还需核对当前内核是否支持对应参数，不能把客户端界面相似当作兼容依据。
{ "routing": { "domainStrategy": "AsIs", "rules": [ { "type": "field", "ip": ["geoip:private"], "outboundTag": "direct" } ] }}入站描述内核在本机如何接收连接，常见字段包括监听地址、端口、协议与认证方式。只供本机应用使用时，回环地址可以明确限制监听范围；改为局域网可访问之前，应先考虑认证和防火墙。应用填写的是本地入站端口，而不是远端服务器端口。出现地址占用错误时，先检查其他客户端或旧进程，再修改端口，并同步更新应用中的代理设置。
路由依据域名、目标 IP、端口或入站标签选择出站。规则通常按顺序匹配，宽泛规则放在前面，可能使后面的精确规则失去作用。引用 geosite 与 geoip 时，需要对应规则数据可用；使用某个出站标签时，也必须存在同名出站。添加规则前先保存原配置，再用明确目标测试匹配结果，避免同时修改 DNS、嗅探与路由而失去排查线索。
出站负责连接远端服务，或执行直连、阻断等动作。VLESS、VMess 与 Trojan 是不同的代理协议，REALITY 则属于安全传输相关机制，不能只替换协议名称就完成转换。订阅通常提供远端地址、身份信息、传输与安全参数，但不同格式携带的信息范围不同。手动迁移时需逐项核对，尤其注意服务端名称、传输路径、公钥与所选内核的支持情况。
{ "outbounds": [ { "tag": "direct", "protocol": "freedom", "settings": {} }, { "tag": "block", "protocol": "blackhole", "settings": {} } ]}桌面端优先从 v2rayN 开始；安卓端按节点能力选择 v2rayNG 或 v2flyNG。客户端名称、内核家族与处理器架构是三个不同维度：先选系统，再确认芯片，最后核对协议支持。下载页集中展示安装入口与适用说明，避免把格式相似的包混用。
桌面版采用跨平台界面，经典 WPF 版沿用传统桌面操作方式。两种入口先按界面偏好与系统要求选择，不要把界面差异误认为节点协议差异。安装前在系统设置中确认设备架构，首次启动后先导入一条可用配置，再设置系统代理。
迁移配置时保留原订阅分组和自定义路由。若应用没有跟随系统代理，先检查应用自身设置，再考虑其他接管方式。
按“关于本机”显示的芯片选择 Apple Silicon 或 Intel 安装包。使用适配本机架构的包，可以减少兼容层带来的额外变量。首次启动如遇系统安全提示，应先核对应用来源与系统要求，再按下载页说明处理，不要为了启动程序长期关闭系统保护。
系统代理生效范围取决于应用是否遵循相关设置。排查时同时确认本地监听端口、活动服务器与浏览器的代理选项。
优先了解使用 Xray 内核的 v2rayNG；需要 V2Fly 内核兼容性时，再考虑 v2flyNG。主流设备通常使用 arm64 包，架构不确定时可查看通用版说明。两款应用的内核能力不同，涉及 REALITY 或特定传输参数时，应先查协议要求，不能只照搬界面选项。
首次连接需要系统 VPN 授权。连接后保持通知可见，并检查电池管理策略，区分应用被后台限制与远端服务器断开。
先按发行版包管理体系选择 deb 或 rpm，再区分 x64 与 arm64 架构。安装图形客户端后，仍需检查桌面环境中的代理设置；浏览器、终端与其他应用可能各有独立代理入口。软件安装成功只说明程序可运行，不代表系统中的全部连接已经进入代理。
保留现有网络设置作为参照。遇到本地端口占用或权限问题，先阅读日志，再调整客户端选项，避免多个代理进程同时接管流量。
查看全部客户端 →安装包选择之后，接着完成订阅导入与连接验证。
“V2Ray”在日常讨论中可能指项目、内核，也可能泛指相关客户端。定位问题时应把这几个层次分开：图形界面决定设置如何录入，内核决定字段如何执行，服务端配置决定连接需要哪些参数。名称相近并不意味着功能完全相同，也不意味着所有配置都能直接互换。
Project V 是理解 V2Ray 的项目背景。V2Ray 以模块化配置组织代理连接，把接收请求的入站、选择路径的路由与实际发起连接的出站分开。V2Fly 是延续 V2Ray 开发的社区项目，其内核与相关规则数据构成了这一生态的重要部分。理解这种配置模型，比记住某个界面的按钮位置更有迁移价值。
当教程提到 SOCKS 入站、域名规则或直连出站时，说的是内核中的职责划分，不是三台独立设备。一个客户端可以同时管理多个服务器，但每次请求最终走哪个出站，仍由实际运行的配置决定。图形界面生成的内容也可能随客户端设置改变，因此排查应以当前运行状态和日志为准，而不是只看保存过的节点名称。
Xray 从 V2Ray 相关代码发展而来，形成了自己的功能演进路线。XTLS Vision、REALITY 等特性通常需要按 Xray 的支持情况核对；V2Fly 则有自己的配置与传输能力演进。共同的项目背景不代表两者在所有字段、传输组合和默认行为上保持一致。复制配置前，先确认来源针对哪个内核，再检查客户端实际调用的内核。
协议名相同也不足以判断兼容。还需要检查传输方式、安全层、流控参数和身份信息。遇到“不识别字段”或“握手失败”时，应分别定位配置解析与网络连接两个阶段。前者优先查内核支持和字段写法，后者再查服务器地址、系统时间与安全参数。阅读 Xray 与 V2Fly 差异说明，可进一步区分节点要求与客户端能力。
v2rayN 是桌面图形客户端，提供服务器管理、订阅更新、代理设置与路由配置入口；实际连接能力还取决于所选内核。v2rayNG 面向安卓设备，以 Xray 内核相关能力为主要使用背景；v2flyNG 则是采用 V2Fly 内核的安卓备选。三款客户端均属于开源软件，选择时应把平台、内核和使用场景放在应用名称之前核对。
开源协议规定代码使用、修改与分发的条件。客户端、内核和规则数据是不同项目组成的部分，具体授权应分别查看随软件提供的许可说明。开源属性有助于理解软件来源与实现，但不能替代配置审查，也不能证明某个订阅来源可靠。本站整理安装与使用文档，不提供远端服务器账户；客户端本身也不会因为安装完成就自动具备可用的服务器连接信息。
客户端更新、内核更新、订阅更新与规则数据更新不是同一件事。更新界面程序不一定改变订阅内容，更新订阅也不一定改变内核能力。升级前应记录活动服务器、代理模式与自定义路由，并保留必要的配置备份。升级后先复测此前可用的场景，再启用新特性；如果同时更换服务器、调整 DNS 并修改分流规则，失败时很难确定原因。
排查记录可以只包含发生时间、客户端名称、内核类型、错误摘要与复现步骤。分享日志前应删除订阅地址、身份标识和其他敏感参数。证书类错误先看设备时间与服务端名称，连接超时先看地址可达性和网络差异，只有特定应用失败则先看代理接管范围。客户端对比用于选型，常见问题用于快速定位，疑难手册则按症状展开完整检查流程。
完成首次连接之后，再处理内核选择、路由顺序和 TLS 参数。阅读时先确认问题发生在哪一层，使用文章中的检查顺序逐步缩小范围。配置示例需要结合实际服务器参数与内核能力调整，不宜把局部片段直接覆盖到现有配置中。
针对证书无效、握手失败等提示，依次检查设备时间、SNI 与伪装域名是否一致、allowInsecure 开关和指纹设置，逐项排除常见的 TLS 报错原因。先确认错误出现在证书验证还是连接建立阶段，再决定下一项检查；不应把跳过证书验证当作常规解决方案。
阅读 TLS 排查步骤 →从 domainStrategy 讲到 geosite、geoip 规则的书写顺序，给出国内直连、国外走代理、广告拦截三类常见场景的路由示例。重点检查规则是否被前面的宽泛条件提前匹配，以及 outboundTag 是否对应真实出站；分流结果还需要结合 DNS 与目标地址验证。
阅读路由配置说明 →梳理两个内核家族的由来，对比 XTLS Vision、REALITY 等特性的支持情况，并说明 v2rayNG 与 v2flyNG 应该怎么选。迁移前按协议、传输、安全层和字段逐项核对，避免只因节点名称相同便认为配置可以直接复用；客户端界面支持填写也不等于内核能够执行。
阅读内核差异说明 →查看全部文章 →还可查阅首次连接与订阅格式专题。