客户端 / 安装包 / 系统架构
桌面端选择 v2rayN，安卓端优先选择 v2rayNG。先核对系统与处理器，再选择安装包。
按平台选择
下载按钮对应具体安装文件。系统最低要求可能随发布变化，下面列出选包前需要核对的项目，不以单一系统版本代替兼容性检查。
Desktop 是新一代跨平台 UI；WPF 是经典稳定版。首次接触 v2rayN 可先从 Desktop 开始，已有 WPF 使用习惯的用户可继续选择经典界面。界面方案与代理协议是两个层面，不能用界面名称判断某项协议是否可用。
这里的两个入口都是 x64 压缩包。下载后先完整解压到本地目录，再运行其中的安装程序；不要在压缩包预览窗口中直接启动。若安装器提示缺少运行环境，应按该发布包的提示处理，不要从不明来源补充同名组件。
切换界面版本前先导出配置，关闭正在运行的旧实例。两个程序若同时监听相同端口，会产生占用冲突；托盘中仍有图标时，应确认旧客户端已真正退出。
打开系统菜单中的“关于本机”，先看芯片或处理器一栏。显示 Apple 芯片时选择 Apple Silicon，显示 Intel 处理器时选择 Intel 版。不要仅按电脑购买年份或外观选包，型号跨代可能使用不同架构。
下载 DMG 后打开磁盘映像，将应用复制到“应用程序”目录，再从该目录启动。首次打开若出现安全提示，先核对下载是否完成、架构是否匹配，再按照“隐私与安全性”中针对该应用的提示操作。无需为了启动单个应用而关闭整机安全保护。
客户端启动后仍需导入服务器配置。系统代理只影响采用系统代理设置的应用；浏览器可用而某个程序仍直连，不一定是安装包问题。应继续检查程序代理行为与客户端路由。
2015 年后的主流手机通常优先选择 arm64。仍需确认设备系统支持对应架构；少数设备的处理器与系统位数并不一致。无法判断时可选通用版，包内包含多种架构组件，体积通常更大。
v2rayNG 采用 Xray 内核，适合需要对应协议与传输功能的配置。首次启动连接时，系统会要求确认 VPN 连接权限；这项权限用于建立本地流量接管通道，不代表已经取得远端服务器配置。
安装 APK 时，仅为实际使用的浏览器或文件管理器开启所需的安装来源权限。完成后可按系统设置收回该权限。若已有其他 VPN 类应用运行，应先处理连接冲突，再启动客户端。
需要 V2Fly 配置兼容性时，选择这一备选客户端。v2flyNG 与 v2rayNG 的内核不同，不应仅凭名称相近就认为配置字段完全通用。导入前先确认配置使用的协议、传输层与安全选项。
架构选择方法与上方相同：支持对应架构的设备选 arm64，无法确认时考虑通用版。通用包扩大的是处理器架构覆盖范围，不会自动增加内核不具备的协议功能，也不会绕过系统版本要求。
从其他客户端迁移时，使用可识别的分享链接或订阅重新导入，再逐项恢复路由与 DNS 选项。应用内部数据目录不适合作为不同客户端之间的直接迁移格式。
| 检查项 | 选包与运行要求 |
|---|---|
| 处理器与系统 | arm64 包需要系统支持对应架构；设备不明时选择通用包前，仍要确认系统兼容性。 |
| 系统版本 | 以 APK 安装器与当前发布包要求为准，不同客户端的最低要求可能不同。 |
| 安装权限 | 允许实际下载来源安装应用，注意已有应用签名冲突与可用存储空间。 |
| 连接权限 | 启动时确认系统 VPN 授权，避免其他 VPN 类应用同时接管连接。 |
| 后台运行 | 遇到锁屏断开时，检查电池优化、后台限制与客户端日志，而不是反复更换安装包。 |
卡片中的发布标记与安装文件名称可能来自不同的清单字段。不要只根据文件名判断当前已安装版本；安装后可在客户端的应用信息中确认。
先分发行版包格式，再分处理器架构。Debian、Ubuntu 系通常选择 deb；Fedora、RHEL 系通常选择 rpm。x64 对应常见的 amd64 或 x86_64 标记，arm64 也常标作 aarch64，两组不能互换。
下载后使用发行版的软件安装器打开文件，阅读依赖提示再继续。相同包格式并不保证适配所有发行版版本，尤其要注意系统库与桌面运行环境要求。安装器报告依赖不满足时，不应通过强制忽略依赖来掩盖问题。
v2rayN 是图形客户端，需要桌面会话。安装完成后先从应用菜单启动，检查配置目录可写与日志是否正常。系统代理设置是否被具体应用采用，取决于桌面环境和应用实现；TUN 则还涉及权限与网络路由。
安装前后检查
客户端负责管理配置并启动本地代理服务，服务器配置则决定连接到哪里、使用什么协议以及如何认证。完成安装只解决了本地程序准备工作，不能替代订阅或服务器账户。应使用自行取得且有权使用的配置，并确认配置中的协议、传输方式和安全选项受所选内核支持。
Project V 是相关代理工具的技术生态，V2Fly 与 Xray 是其中不同的内核路线。v2rayN 提供桌面图形管理界面，安卓端的 v2rayNG 与 v2flyNG 则分别采用对应内核。图形界面与内核各有职责：前者负责配置管理和操作入口，后者处理协议与流量。换客户端或升级之前，需要同时考虑配置兼容性，而不是只比较名称。
准备好订阅链接或单条服务器分享链接后，在客户端中使用对应的导入入口。订阅适合按分组管理多个配置，单条链接适合明确导入某个服务器。导入完成后先检查服务器地址、端口与协议类型，再选中需要使用的配置。若导入结果为空，应先检查链接内容与格式，不要立即改动系统网络设置。
桌面端常见的系统代理模式会修改系统代理设置，但只有遵守这些设置的应用才会使用代理。TUN 通过虚拟网络接口接管符合条件的流量，还需要结合权限、路由和 DNS 设置判断行为。首次配置时应尽量只启用一种接管方式，确认工作正常后再调整，避免同时改变多个条件而难以定位问题。
安卓端首次启动连接时会出现系统 VPN 授权提示。授权通过后，还应查看客户端是否成功启动、所选服务器是否正确、日志是否报告连接或解析错误。状态图标只能说明本地服务处于某个运行状态，不能单独证明每个应用的远端连接都已成功。
入门指南按导入、选中配置、代理模式和日志检查串起操作顺序；需要理解字段含义时，再查阅 V2Ray JSON 配置手册。先完成最小可用配置，再增加复杂分流，更容易判断每项设置的作用。
更新前导出服务器配置，记录订阅分组、本地端口、路由规则、DNS 与自定义参数。导出文件和订阅地址可能含有认证信息，应保存在自己控制的位置，提交问题截图时遮住相关字段。备份的目的在于保留可恢复的配置，不应把含凭据的文件作为公开故障附件。
关闭客户端后再安装更新，避免后台进程仍在使用旧文件。更新完成后先核对服务器列表与选中状态，再启动本地服务观察日志。跨客户端迁移时，优先通过受支持的链接或导出格式重新导入，不直接把整个数据目录覆盖到另一个应用中。
若更新后连接异常，应记录错误出现的环节：应用无法启动、内核启动失败、订阅下载失败、域名解析失败，还是服务器连接失败。不同环节对应不同检查对象。反复重装通常会丢失有用的现场信息，也无法解决远端配置失效或本地端口冲突。
浏览器未完成下载时，先检查下载记录中的失败原因与本地可用空间；文件尚未完整保存就尝试打开，可能触发解析或格式错误。文件已经下载但安装器拒绝继续时，应检查处理器架构、系统版本、安装权限和已有应用签名，而不是把所有失败都归因于网络。
安装完成却无法启动时，先查看系统提示与客户端日志，确认运行环境、文件访问权限以及配置目录是否可写。程序可以启动但不能连接时，再核对服务器配置、系统时间、域名解析和本地监听端口。将下载、安装、启动和连接分开处理，能减少无关设置的改动。
下载相关问题
先确认系统和架构，再处理权限、依赖及配置迁移。
首次安装可先选 Desktop，它采用新一代跨平台界面。WPF 是经典稳定版，适合习惯原有 Windows 界面的用户。两者都是 v2rayN，界面选择不代表服务器协议发生变化；迁移前应导出配置，避免让两个实例同时占用同一本地端口。
2015 年后的主流手机通常优先选择 arm64，但仍需确认处理器与系统均支持对应架构。无法确认架构时可选通用版，它包含多种架构组件，安装包通常更大。出现解析或安装失败时，还应检查系统版本、存储空间与已有应用签名。
客户端安装包不包含可直接使用的服务器账户或订阅。安装后需要导入自行取得且有权使用的服务器配置或订阅链接，再选择服务器、设置代理方式并查看连接日志。订阅地址可能包含访问凭据，不应公开分享。
先在“关于本机”中核对芯片类型，并确认下载已完成。打开 DMG 后将应用复制到“应用程序”目录，再按系统“隐私与安全性”面板中针对该应用的提示处理。不要直接关闭整机安全保护；如果提示应用损坏或架构不符，应重新检查安装包与系统兼容性。
按发行版的包管理体系选择。Debian、Ubuntu 系通常使用 deb，Fedora、RHEL 系通常使用 rpm；还要区分 x64 与 arm64。包格式正确不等于系统依赖一定满足，安装时应阅读软件安装器报告的依赖与系统库要求。
先导出服务器配置，记录订阅分组、路由规则、本地监听端口和自定义设置，然后退出客户端再安装更新。不同界面或客户端之间不应直接覆盖配置目录。更新后先检查服务器列表与日志，再恢复系统代理或 TUN；备份文件应按敏感资料保存。