桌面选择 v2rayN，Android 优先选择 v2rayNG。
先确认操作系统与芯片架构，再选择安装包。
同一款 v2rayN，两种界面。首次安装优先选择 Desktop；沿用经典操作习惯可选 WPF。
将压缩包完整解压到可写入的本地文件夹，再查看其中的安装或启动入口。不要在压缩软件预览窗口中直接运行，也不要只拖出单个程序文件；同目录的依赖文件可能是启动所必需的。若安装过程提示缺少运行环境，先阅读提示中的名称与架构，再按对应要求补齐。
Desktop 与 WPF 是界面选择，不代表订阅类型。已有配置迁移到另一界面前，先导出备份。测试新界面时退出旧进程，避免两份客户端同时修改系统代理。连接结束后通过客户端清除系统代理，再退出程序，可减少下次启动浏览器时残留代理设置造成的断网。
| 项目 | 安装前确认 |
|---|---|
| 处理器架构 | 本页两个入口均为 x64。打开系统“关于”查看系统类型，不要将 x64 包视为其他架构的原生安装包。 |
| 系统与运行环境 | 使用受支持且已更新的 Windows；具体最低系统版本与运行环境要求，以该包的安装提示为准。 |
| 目录与权限 | 解压目录需要可写入；系统代理与网络权限受设备策略影响，不必为普通启动默认授予管理员权限。 |
如果窗口一闪而过，先检查是否解压完整、运行环境是否匹配，再查看日志。反复重新下载通常不能解决端口被其他程序占用的问题。
打开系统菜单中的“关于本机”，按“芯片”或“处理器”信息选择对应架构。
打开磁盘映像后，按窗口中的安装指引将应用放入“应用程序”，随后从该目录启动。不要长期在挂载的映像中运行，以免卸载映像后入口失效。首次启动若出现系统安全提示，先确认文件来源与提示类型，再在系统设置中查看具体原因；不要直接停用系统安全机制。
如果连接开启后只有部分应用能够访问网络，先检查这些应用是否遵循系统代理。普通系统代理与接管设备流量的模式并不相同，后者可能涉及额外权限。先使用常规代理完成基本连接验证，再按实际需求处理进阶网络权限，能够减少首次安装时的变量。
| 项目 | 安装前确认 |
|---|---|
| 芯片架构 | Apple M 系列选择 ARM64，Intel 处理器选择 x64。优先使用匹配设备的原生包。 |
| 系统兼容性 | 最低系统版本随应用及其运行环境变化；若系统提示不兼容，应先核对要求，而不是反复更换下载方式。 |
| 网络设置 | 确认当前网络服务允许修改代理。公司或学校管理的设备可能需要管理员批准。 |
从旧设备复制配置后，需要重新核对本地路径、代理端口与权限。配置文件可导入，不等于平台相关设置会自动适配。
先选 v2rayNG。需要 V2Fly 内核适配时，再评估 v2flyNG；两款客户端各自管理配置。
下载完成后，从浏览器下载记录或文件管理器打开 APK。系统要求允许安装来源时，只为当前用于打开文件的应用授予必要权限，安装结束后可收回。首次连接会出现系统 VPN 授权对话框，确认客户端名称后再允许；授权成功并不代表订阅中的配置一定有效。
先导入配置并选中一项，再启动连接。Android 通常只允许一个用户级 VPN 服务同时工作，其他同类连接可能被替换或阻止。若切回桌面后连接中断，再检查电池优化、后台运行与厂商省电策略，不要一开始就修改大量网络参数。
v2flyNG 不是 v2rayNG 的附加组件。切换时需要重新导入订阅或配置，不能假定两款客户端的自定义设置完全通用。内核支持的功能也存在差异；遇到不支持的字段，应先核对配置需求，而不是把订阅失败直接归因于安装包。
| 项目 | 安装前确认 |
|---|---|
| 应用架构 | 优先 arm64；处理器支持 64 位不一定代表设备系统支持 64 位应用，拿不准时可尝试通用版。 |
| 系统版本 | 具体最低版本由当前 APK 决定；通用版解决的是架构选择，不会降低应用所需的系统版本。 |
| 覆盖安装 | 相同应用的不同分发渠道可能签名不同。遇到签名冲突先备份配置，不要立即卸载旧应用。 |
| 连接权限 | 首次连接需确认系统 VPN 授权；持续运行可能需要调整该应用的电池优化设置。 |
先按发行版选择 deb 或 rpm，再确认 x64 与 ARM64。本页提供的是桌面图形客户端。
使用发行版的软件安装器打开下载的软件包，阅读依赖解析结果后再继续。x64 在文件名中也可能写作 amd64 或 x86_64，ARM64 可能写作 arm64 或 aarch64。不要通过重命名扩展名转换包格式，也不要使用忽略依赖的方式强行安装。
此处 rpm 文件名带有目标发行环境标识，不代表所有 rpm 系统都能直接运行。若软件安装器报告系统库版本不足，应先核对发行版兼容性。完成安装后在当前用户的桌面会话中启动，先用普通权限验证连接；图形桌面的系统代理、应用自身代理与终端环境变量是不同层面的设置，需分别确认。
| 项目 | 安装前确认 |
|---|---|
| 包管理格式 | 依发行版选择 deb 或 rpm，具体支持范围取决于包元数据与系统依赖。 |
| CPU 架构 | x64 对应 amd64 或 x86_64；ARM64 对应 arm64 或 aarch64。不能交叉安装原生包。 |
| 图形环境 | 需要可用的桌面会话及应用要求的图形库；仅有命令行的服务器不属于本页安装步骤的适用场景。 |
| 代理作用范围 | 系统代理是否生效取决于桌面环境与目标应用；终端工具可能需要单独配置。 |
安装成功但窗口无法显示时，优先检查桌面会话与图形依赖。窗口正常但连接失败时，再转向配置、端口、DNS 与路由排查。
安装完成只是起点。将配置导入、连接验证与分流调整分开进行，出现问题时更容易定位。
客户端不附带可用线路。先确认配置来源与有效期，再通过订阅管理、剪贴板或二维码入口导入。订阅地址用于获取一组可更新配置，单节点分享链接则通常只导入一项，两者不能随意替换使用。
订阅地址可能包含访问凭据。不要将原始地址、二维码或完整配置截图发布到公共页面。
完成更新后选中一项配置，确认本地端口未被占用，再开启需要的代理模式。桌面应用是否遵循系统代理各不相同；移动端则需要确认系统连接授权。先验证一个明确的目标应用，避免把局部问题误判为所有连接都失效。
首次测试不要同时开启多个代理客户端，也不要同时改动 DNS、路由与内核。
基础连接正常后，再根据使用范围设置直连与代理规则。规则顺序会影响实际命中结果，改变解析方式也可能影响 IP 规则。每次只改一组设置，记录修改前后的现象；确认稳定后导出备份，便于升级或迁移时恢复。
跨设备使用配置需要手动导入，并重新核对路径、本地端口与平台权限。
先区分安装问题与连接问题。能打开客户端，不代表配置已经准备完成。
首次使用优先选择 Desktop 桌面版，它采用新一代跨平台界面。经典 WPF 版适合已经熟悉原有 Windows 界面与操作流程的用户。两者不必同时安装；切换前导出配置，并避免同时开启系统代理或占用相同本地端口。
2015 年后的主流手机通常优先选择 arm64，但最终应以设备支持的应用架构为准。部分设备的系统仍可能只支持其他架构。不确定架构或遇到架构不兼容提示时，可尝试通用版；通用版也不能绕过系统版本要求或安装签名冲突。
客户端只负责管理配置与建立连接，安装包不包含可用订阅或账号。需要从可信来源取得配置，导入订阅或分享链接，更新并选中配置，然后设置代理模式。先确认连接能够建立，再按需求调整分流与 DNS。
升级前使用客户端提供的导出或备份功能，保留订阅分组、自定义路由、DNS 设置及本地端口记录。退出旧客户端后再安装。跨客户端迁移时不要直接覆盖整个数据目录，应重新导入并核对平台差异。备份中可能包含访问凭据，应妥善保存。
下载中断时先检查网络、磁盘空间与浏览器下载记录，再重试对应安装包。系统阻止安装时，先阅读具体提示，区分架构不匹配、权限不足、签名冲突或安全策略限制。不要直接关闭系统防护；受管理设备应先咨询管理员。
版本文字与文件入口来自清单中的不同字段，可能出现更新节奏不同的情况。不要仅凭文件名判断已安装版本。安装后在客户端的“关于”页面确认实际版本；如果与预期不符，先保留现有配置，等待清单更新或重新检查下载入口。