CLIENT SETTINGS
先区分服务器参数、路由规则和系统代理。三者分别决定连接到哪里、请求走哪条出站，以及哪些应用会把流量交给客户端。下方为设置项示意，实际菜单会随客户端更新调整。
在 v2rayN 的「订阅分组 → 订阅分组设置」中新建分组，填写便于识别的备注与订阅地址，保存后再更新。分组适合把不同来源的服务器列表分开维护，避免更新时混淆。首次连接尚未建立时，先尝试「更新订阅（不通过代理）」；只有已存在可用代理且订阅地址需要它访问时，再选择通过代理更新。分享链接通常描述单个服务器，订阅地址用于获取一组配置，二者应放入对应的导入入口。更新后先确认列表出现条目，再选择服务器测试。
路由分流把请求交给直连、代理或阻断出站，而不是修改服务器的连接参数。先用内置路由方案建立可用基线，再到路由设置添加域名或地址规则。规则通常按顺序自上而下匹配，具体域名应放在宽泛规则之前。「IPIfNonMatch」表示域名规则未命中时，解析地址后继续尝试 IP 规则，可能增加解析开销。与单纯切换系统代理相比，路由负责的是进入内核之后的去向；应用没有使用代理时，即使规则正确也不会生效。
浏览器等遵循系统代理设置的应用，可先使用「自动配置系统代理」。它会写入系统的代理入口，但不等于所有程序都会采用该入口。遇到忽略系统代理的应用，再评估 Tun；此模式通过虚拟网络接口接管流量，通常涉及管理员权限、路由与 DNS。首次排查不要同时运行多个接管网络的工具，以免互相覆盖。关闭客户端前检查是否需要「清除系统代理」。安卓端则应留意系统 VPN 授权，以及其他 VPN 类应用是否占用了同一接口。
Xray 与 V2Fly 共享部分生态背景，但协议扩展、配置字段和功能支持并不完全相同。涉及双内核的配置迁移，应先核对目标客户端实际提供的内核选项，而不是只看分享链接能否导入。v2rayNG 使用 Xray，v2flyNG 采用 V2Fly 路线，两者是分别安装的客户端，并非同一按钮切换。桌面端也应以当前版本可选内核为准。更换内核后重新启动服务，先读启动日志，再验证连接；出现未知字段时应处理兼容性，而不是反复切换路由。
PLATFORM SELECTOR
安装包先看操作系统与处理器架构，再看安装格式。桌面平台使用 v2rayN，安卓优先查看 v2rayNG；v2flyNG 适合需要 V2Fly 内核兼容性的场景。下载页集中列出对应入口与安装要求。
首次安装可先查看桌面版，它采用跨平台界面；已经熟悉经典窗口布局的用户，也可以选择 WPF 版。两种界面都需要正确的服务器配置，不能仅凭界面外观判断协议是否受支持。安装前到系统「设置 → 系统 → 系统信息」确认系统类型，再选择下载页提供的架构入口。
启动后先导入一条可用配置，选择服务器，再设置系统代理与路由模式。普通浏览器访问正常以后，才考虑是否需要 Tun。若启用 Tun 时提示权限不足，应根据提示使用所需权限重新启动，而不是连续修改服务器端口。更换安装目录前备份配置，避免订阅分组与自定义路由随目录清理而丢失。
前往下载 →在苹果菜单打开「关于本机」，显示 Apple 芯片的设备选择 Apple Silicon 安装包，显示 Intel 处理器的设备选择 Intel 安装包。架构选错可能造成启动失败，或依赖额外的兼容环境。完成安装后先运行客户端，确认界面与日志窗口能够正常打开，再导入订阅。
如果程序启动成功但浏览器仍未经过代理，先核对当前网络服务的代理设置，再检查浏览器是否使用独立代理扩展。无线网络与有线网络可能对应不同的系统配置。遇到系统安全提示，应先确认下载来源与提示内容，再按系统提供的授权路径操作；不要把关闭系统保护作为常规安装步骤。
前往下载 →多数较新的安卓手机适合 arm64 包；不确定设备架构，或安装时明确提示包不兼容，可以查看通用版入口。优先选择采用 Xray 内核的 v2rayNG，需要 V2Fly 内核兼容性时再评估 v2flyNG。两者的分组、应用设置与连接状态分别保存，安装另一款客户端后仍需重新确认配置。
首次连接会触发系统 VPN 授权，确认后客户端才能通过该接口接管流量。如果已经运行另一个 VPN 类工具，应先断开再测试。亮屏时可用、锁屏后断开，通常应检查电池优化、后台活动限制与省电策略。应用分流还可能排除特定程序，因此浏览器可用并不代表每个应用都会经过同样的出站。
前往下载 →先确认发行版使用的包格式：Debian、Ubuntu 一类系统通常选择 deb，Fedora 一类系统通常选择 rpm；随后区分 x64 与 arm64。不要把包格式和处理器架构混为一谈。图形客户端需要合适的桌面运行环境，精简系统或仅有远程终端的环境，应先确认是否具备运行图形界面的条件。
不同桌面环境对系统代理的实现存在差异。设置自动代理后，应检查应用是否读取桌面代理配置；终端程序也可能需要单独设置自身代理。Tun 涉及虚拟接口与权限，应根据当前发行版和客户端的要求处理。内核无法启动时先看日志里的端口占用、资源路径或权限错误，避免把运行环境问题误判为订阅失效。
前往下载 →下载客户端只完成本地工具的准备。连接还需要有效的服务器参数或订阅地址，客户端安装包本身不提供可用服务器。订阅地址可能包含访问凭据，截图、求助或分享日志前应遮盖地址与身份信息。
查看全部客户端 →PROJECT V / CORE / CLIENT
理解客户端与内核的分工，可以减少配置迁移时的误判。界面负责管理参数，内核负责执行网络连接；订阅服务提供参数，路由规则决定请求去向。这几层发生错误时，检查入口各不相同。
Project V 是围绕网络代理工具形成的开源项目体系，V2Ray 是其中常见的核心名称。V2Fly 延续了相关社区开发路线，维护 V2Ray 内核及其配套能力。日常所说的「V2Ray 客户端」往往指带界面的管理工具，而不是单独运行的核心程序。把两者区分开，才能判断一个功能是在界面菜单中配置，还是取决于底层内核是否实现。
内核通常负责入站监听、出站连接、路由匹配和 DNS 等处理。图形客户端则把这些选项组织成服务器编辑框、订阅分组和参数设置。用户保存界面选项后，客户端生成或调整内核所需的配置，再启动服务。因此，导入成功只说明界面识别了链接，不代表远端参数正确，也不代表内核已经成功运行。
Xray 从 V2Ray 生态发展而来，在协议与传输能力上有自己的演进方向。VLESS、VMess、Trojan 等名称描述的是不同协议，REALITY 则涉及连接的安全机制，不能把这些标签都理解为可相互替换的节点类型。服务器使用了哪种组合，本地就需要匹配协议、传输、安全参数以及对应内核的能力。
迁移配置时，优先逐项核对地址、端口、用户标识、传输方式、TLS 或 REALITY 参数。某些字段只能在特定内核中使用，客户端也可能没有把全部选项暴露到界面中。出现「未知字段」或不支持的安全类型时，应先核对兼容性。随意清空 SNI、关闭证书验证或改写传输路径，可能让原本明确的问题变得更难定位。
v2rayN 是桌面图形客户端，适合在一个窗口里管理服务器、订阅、系统代理与路由。v2rayNG 面向安卓，通过系统 VPN 接口接管应用流量，采用 Xray 内核；v2flyNG 则为偏向 V2Fly 内核的安卓使用场景提供另一种选择。三个项目的功能更新节奏不同，不能把其中一款客户端的菜单路径直接套到另一款上。
这三款客户端以 GPL-3.0 协议开源，内核与附带组件还需要分别看各自的许可说明。开源协议规定了代码使用、修改与再分发的条件，并不替代服务器服务条款，也不决定连接质量。客户端软件可以免费使用，但服务器、订阅或其他网络服务是否收费，应以对应服务提供方的规则为准。
客户端更新可能同时改变界面、配置生成方式和内核能力。升级前保留订阅分组、自定义路由与关键参数，记录当前能够正常连接的配置。更新后先测试同一服务器、同一路由与同一网络，再逐项启用新增功能。这样可以区分升级引入的变化与服务器本身的波动，而不是一次更换所有变量。
查看更新说明时，优先关注配置迁移、系统要求、内核调整和已知问题，不要只比较版本数字。遇到异常时，日志里的首条错误通常比后续重复报错更有价值。求助前可整理系统平台、客户端类型、操作步骤和已经排除的条件，但应移除订阅地址、用户标识及其他连接凭据。详细流程见排查手册。
TECHNICAL NOTES
技术笔记按具体设置项展开。已能正常连接、需要调整流量去向，先看路由规则；客户端提示服务启动失败，则先读日志与配置错误。不要在启动错误尚未解决时反复更换分流方案。
内核启动失败时，如何读懂日志里的报错行？按端口占用、JSON 语法错误、未知字段、geo 文件缺失四类场景，逐项定位与修复。先处理启动条件，再验证服务器连接。
阅读技术笔记 →以大陆网站直连、境外网站走代理、广告域名阻断为目标，逐步配置路由规则集。结合规则顺序与域名策略判断请求去向，避免宽泛规则提前命中，遮住后面的特定规则。
阅读技术笔记 →区分 domain:、full:、regexp:、geosite:、geoip: 等匹配写法，理解自上而下的规则优先级。添加自定义域名前先确定匹配范围，再检查规则所引用的数据文件是否可用。
阅读技术笔记 →