桌面设备先看 v2rayN，安卓设备先看 v2rayNG。安装包需要同时匹配操作系统与处理器架构；客户端负责管理配置，实际连接还需要可用的服务器参数或订阅地址。
新安装可先了解 Desktop 桌面版；已经习惯经典界面的用户，可以查看 WPF 版。两者界面框架不同，选型时应结合系统要求与现有配置，不必仅因为界面变化就迁移。
下载前在系统“关于”中确认设备架构。首次启动后先找到订阅分组和服务器列表，再检查内核是否正常启动。遇到运行依赖提示时，按下载页对应说明处理，不要混用不同版本的程序文件。
如果以前装过其他代理工具，先确认系统代理当前指向哪里。退出旧客户端后再测试新客户端，能减少端口占用和代理设置被反复覆盖的问题。
根据“关于本机”显示的芯片选择安装包：Apple Silicon 使用 arm64，Intel 使用 x64。架构选择正确以后，再按系统提示完成应用安装与首次打开。
系统代理权限和 TUN 所需权限不是同一件事。建议先完成普通系统代理连接，确认服务器可用，再考虑虚拟网卡模式。首次授权失败时，应返回系统设置检查对应项目，而不是连续重复安装。
若应用启动正常但浏览器无法连接，先核对系统代理地址与端口，再检查是否有其他网络工具同时接管流量。对安全提示的处理路径，可查看博客中的 macOS 安装与权限说明。
v2rayNG 使用 Xray 内核，适合先从常见分享链接和订阅导入开始；v2flyNG 属于 V2Fly 内核路线，可作为对应配置场景的备选。选择时以配置所需功能为依据，不以客户端名称判断连接能力。
较新的主流设备通常选择 arm64；不确定架构时，先查设备信息，再了解通用安装包的适用范围。导入配置后选择一个服务器，启动连接时按系统提示确认 VPN 授权。
连接容易在后台中断时，要检查电池优化与后台运行限制。Wi-Fi 和移动数据环境可能有不同的 DNS 与网络条件，应分别测试并记录现象，再决定是否调整客户端设置。
先按发行版的软件包体系选择 deb 或 rpm，再确认设备属于 x64 还是 arm64。桌面版用于图形环境中的配置管理，安装完成后仍需检查桌面环境的代理设置是否与客户端一致。
部分应用读取系统代理，部分应用有独立代理设置，因此浏览器能连接并不代表所有程序都已接入。先用一个明确支持代理的应用完成验证，再逐个检查其他应用的流量入口。
需要 TUN 时，还要考虑权限、现有路由和 DNS 管理方式。不要同时更改多个网络管理组件；保存原设置后一次调整一项，出现异常才能判断具体是哪一步影响了连接。
把配置分成五个独立环节：先获取服务器参数，再确定执行内核，最后处理流量入口与出站规则。以下示意用于解释设置含义，不会修改设备上的客户端。
订阅用于批量维护服务器配置，适合需要定期同步节点的场景。在订阅分组中添加地址和便于辨认的名称，再执行更新，检查服务器列表是否出现对应分组。分享链接则可从剪贴板导入，两种入口不要混用。首次连接尚未建立时，可先尝试不通过代理更新；如果地址只在特定网络下可访问，再按实际条件调整。更新失败先看错误提示、地址有效期与系统时间，不必立即重装客户端。订阅地址可能包含访问凭据，应避免截图公开。
订阅分组 → 添加订阅地址 → 更新订阅内核负责执行连接、解析协议并处理路由，客户端界面负责生成和管理配置。v2rayN 可在支持的配置中使用 Xray 或 sing-box，但切换并不等于所有参数都能原样迁移。先确认服务器所用协议、传输方式与扩展字段，再选择能够解释这些参数的内核。切换后检查启动日志和实际连接，尤其留意不支持字段、端口占用或配置生成失败。已经正常运行的配置不需要频繁更换内核；只有明确的兼容需求或故障线索出现时，再做单项对照测试。
系统代理决定支持该设置的应用如何进入客户端，并不直接决定流量最终走直连还是代理。自动配置系统代理会把系统入口指向本地监听端口；清除系统代理用于撤销该入口；不改变系统代理则保留已有系统设置。初次使用可先选择自动配置，再用浏览器验证。若只有部分应用生效，应检查应用是否读取系统代理，而不是直接判定服务器失效。退出客户端前也要确认代理设置已经恢复，避免本地监听停止后，应用仍向原端口发送请求。
路由按匹配条件选择出站，适合把局域网、指定域名或特定地址交给不同连接路径。先理解默认路由模式，再添加少量明确规则，避免一开始导入大量来源不明的规则。域名规则依赖客户端获得域名信息，地址规则则依赖目标地址，两者还会受到 DNS 策略影响。规则顺序需要结合内核的匹配机制检查，不能只看名称判断结果。测试时同时查看访问日志与目标是否可达；页面打开成功只说明连接成立，不足以证明它使用了预期出站。
| 匹配规则 | 出站 |
|---|---|
| geosite:cn | direct |
| geoip:private | direct |
TUN 通过虚拟网卡接入流量，可用于不读取系统代理的应用，但需要配合权限、路由与 DNS 设置。建议先确认普通代理连接正常，再启用 TUN，这样能把服务器问题与流量接入问题分开。开启前记录原网络配置，并关闭可能冲突的其他虚拟网卡工具。启用后分别测试浏览器、目标应用与局域网访问，检查是否出现解析失败或路由回环。若网络异常，先关闭 TUN 并确认恢复，再阅读日志定位原因，不要同时改动内核、节点与 DNS。
普通连接验证 → 检查权限 → 启用 Tun 模式 → 测试 DNS 与路由先让一条配置稳定运行，再增加分流和虚拟网卡功能。每一步都保留一个可以观察的结果，遇到错误就停在当前环节排查，避免把安装、订阅和网络问题混在一起。
先从下载页选择对应平台与架构的安装包，完成安装后打开客户端。桌面使用 v2rayN，安卓优先了解 v2rayNG；教程中的菜单名称可能随界面变化，但订阅管理、服务器选择和启动连接的基本顺序一致。
如果拿到的是订阅地址，在订阅分组中新增一项并更新；如果拿到的是单个分享链接，使用从剪贴板导入入口。导入后先看分组和服务器类型是否正确，检查是否存在空列表或解析错误，再选择一个配置作为测试对象。
客户端不会自动生成可用服务器。订阅由提供方维护，地址失效、额度耗尽或配置调整都可能影响连接。保管订阅时应像保管访问凭据一样谨慎，向他人咨询问题时先遮盖地址中的敏感部分。
桌面端先选定服务器，再启用自动配置系统代理，让支持系统代理的应用接入客户端。安卓端启动连接时，需要确认系统的 VPN 授权。第一次测试先使用客户端已有的基础路由配置，不急着叠加自定义规则。
观察日志是否出现内核启动失败、监听端口占用或协议参数错误。启动按钮状态变化只说明客户端进入运行流程，不能替代实际访问测试。如果有其他代理软件同时运行，先暂停其中一款，避免两个程序互相修改入口。
服务器选择、系统代理和路由模式是三项不同设置。更换服务器后，仍要确认应用读取的是当前客户端的监听端口；调整路由后，也要确认测试请求已经真正进入客户端。
使用浏览器访问一个稳定页面，再测试日常需要连接的应用。分别确认能否解析域名、是否可以建立连接，以及访问日志中有没有对应请求。如果浏览器正常而某个应用失败，应先检查那个应用的代理设置与网络入口。
出现异常时，一次只改一项：先换一个已知可用配置，或先换网络环境，不要同时更换内核、路由和 DNS。记录错误提示、操作顺序与发生时间，通常比反复点击测速更有助于定位问题。
连接验证通过后，再逐步添加分流规则或启用 TUN。结束使用时，检查系统代理是否恢复；更新客户端前备份配置，更新后重新测试同一组访问目标，方便判断变化来自哪里。
理解“客户端、内核、协议”三个层次，比记住某个按钮的位置更重要。它们分别负责配置管理、连接执行和通信约定，不能互相替代。
Project V 是围绕 V2Ray 形成的开源代理工具生态，核心能力包括协议处理、传输、DNS 与路由。V2Fly 延续 V2Ray 的社区维护路线；Xray 从相关技术基础发展出自己的内核与扩展能力。两条路线有共同背景，也有各自的功能与配置差异，不能简单理解为只换了名称。
客户端把这些能力整理成图形界面，让订阅、服务器列表与常用开关更容易管理。内核才是实际执行连接的部分。因此，界面能够识别某个分享链接，不代表当前选用的内核一定支持其中全部参数；出现连接问题时，需要同时检查导入结果和内核日志。
协议、传输和安全层也要分别理解。VMess、VLESS、Trojan 与 Shadowsocks 属于常见配置中的协议名称；WebSocket、gRPC 等描述传输方式；TLS 与 REALITY 涉及连接的安全机制。能否使用某种组合，取决于服务器配置与客户端内核的共同支持，而不是只看协议标签。
v2rayN 面向桌面配置管理，在 Windows、macOS 与 Linux 上提供对应入口，适合集中管理订阅、切换服务器并调整代理与路由。v2rayNG 面向安卓设备，使用 Xray 内核路线；v2flyNG 同样面向安卓，但采用 V2Fly 内核路线。三款客户端均属于开源项目，选择重点是设备平台和所需配置的兼容性。
开源意味着代码可以依照相应许可证被阅读、使用与参与维护。客户端、内核和附带依赖可能采用不同许可证，具体授权范围应以各项目随发布提供的许可文本为准。免费客户端与订阅服务也是两回事：软件的使用方式，不决定服务器提供方的服务条件、配额或有效期。
本站按这三款客户端组织下载与中文教程，不把客户端名称当成连接质量指标。实际体验还受到服务器资源、网络环境、DNS、路由规则与应用行为影响。评估一套配置时，应固定测试条件、检查日志，并区分本地设置问题与远端服务问题。
客户端更新、内核更新、订阅更新和规则数据更新是不同操作。前两者影响程序行为，订阅更新影响服务器参数，规则数据则影响域名与地址分类。遇到异常时先确认最近变动的是哪一层，不要把所有内容一并重置。
升级前保存现有配置和重要设置，阅读变化说明。完成升级后，用原先正常的服务器与相同应用验证，再继续调整其他选项。保留一次可回溯的设置记录，能够减少重新配置时的遗漏。
“无法连接”需要进一步拆分：是订阅更新失败、内核未启动、域名解析失败，还是连接建立后中断？先记录具体症状，再检查对应环节。系统时间偏差、端口占用与过期参数，都可能表现成相似的访问失败。
分享日志前应删除订阅地址、账户信息和服务器凭据。只保留错误类型与必要的上下文，通常已经足够说明问题。常见症状可先查阅 FAQ，需要从基础概念逐章学习时，使用 完整手册。
按遇到的问题选读：macOS 安装权限、FakeDNS 与 TUN 配合，以及新手常见概念。文章用于补充具体场景，首次安装仍建议按使用指南完成基础连接。
分步处理 macOS 提示无法验证开发者、应用已损坏、网络扩展与系统代理授权等问题，附隐私与安全性设置的放行路径。
阅读文章 →讲清 FakeDNS 用保留地址池替代真实解析的工作方式，它如何配合域名分流与 TUN，以及哪些场景该开、哪些该关。
阅读文章 →集中回答新手最常卡住的十个问题：装哪个客户端、订阅从哪导入、Xray 与 V2Fly 内核区别、系统代理与 TUN 怎么选。
阅读文章 →