v2rayN
首推 7.24.1两版不需要同时运行。它们可能使用相同的本地代理端口，同时启动容易出现监听失败或系统代理指向错误。切换前退出原程序，保留订阅与自定义路由备份，再在新界面中确认活动配置。
CLIENT PACKAGES / 客户端安装包
V2Ray 客户端下载
系统与架构选择
桌面选 v2rayN，Android 优先选 v2rayNG。先确认系统，再选安装包；客户端安装完成后，仍需导入你有权使用的配置。
01 / 确认系统下面的页签按设备系统分类，不按订阅类型分类。
02 / 核对架构x64、arm64 与芯片和系统环境有关，不能只看品牌。
03 / 导入配置安装后再设置订阅、代理模式与路由，逐步验证连接。
Windows 客户端
以下两个入口均为 x64 包。初次使用先看桌面版，熟悉经典界面再选 WPF 版。
系统要求与安装检查
| 检查项目 | 选择依据 |
|---|---|
| 处理器与系统 | 本页提供 x64 安装包。到系统设置的“系统信息”查看系统类型，不要把这些包当作原生 ARM64 包使用。 |
| 运行环境 | 兼容范围以安装程序提示为准；若提示缺少运行组件，按明确的组件名称处理，不要从不明弹窗安装运行库。 |
| 安装位置 | 先解压到可写目录，安装完成后从正常程序入口启动；避免将临时解压目录当作长期配置存放位置。 |
| 代理权限 | 普通系统代理与 TUN 的权限需求不同。先验证普通代理，再按需要调整 TUN，减少同时改动造成的排查难度。 |
安装成功不等于所有应用都已使用代理。浏览器通常会读取系统代理，部分软件有自己的网络设置，需要单独核对。
macOS 客户端
在系统菜单打开“关于本机”，看“芯片”或“处理器”一栏，再选择对应 DMG。
v2rayN
7.24.1打开 DMG 后，按安装界面指引将应用放入“应用程序”，再从应用目录启动。首次打开遇到系统安全提示时，先阅读提示内容，核对应用来源与系统设置中的说明，不要为了启动程序直接关闭整套系统保护。
系统要求与安装检查
| 检查项目 | 选择依据 |
|---|---|
| 芯片架构 | Apple M 系列对应 arm64，Intel 对应 x64；以系统信息为准，不根据购机年份判断。 |
| 系统兼容 | 安装器或首次启动提示是兼容性判断依据。旧系统无法启动时，先确认具体系统版本与错误信息。 |
| 应用位置 | 将应用安装到“应用程序”后运行，避免一直从挂载的磁盘映像启动，以免退出映像后找不到程序。 |
| 网络权限 | 涉及系统代理、网络扩展或 TUN 时按功能要求授权；只导入订阅并不会自动启用所有网络模式。 |
连接验证时先关闭其他代理客户端，再检查当前网络服务的代理设置。不同网络服务可以保留不同设置，切换网络后应重新确认。
Android 客户端
先选客户端，再选架构。2015 年后的主流手机通常优先尝试 arm64，架构不明确时考虑通用版。
v2rayNG
首推 2.2.6v2rayNG 采用 Xray 内核，适合围绕该内核功能使用配置的场景。首次连接会请求系统 VPN 授权；授权后仍要选择活动配置并启动服务。若设备已有其他使用 VPN 通道的应用，应先确认是否发生通道占用。
v2flyNG
备选 · V2Fly 内核 1.10.31V2Fly 与 Xray 属于相关但分别演进的内核家族，具体协议、传输与配置字段的支持范围存在区别。如果订阅包含某一内核专属特性，应根据提供方的明确说明选择客户端，而不是只比较应用名称。
系统要求与安装检查
| 检查项目 | 选择依据 |
|---|---|
| 设备架构 | arm64 对应 64 位 ARM 运行环境，通用版覆盖多种架构。出厂年份只用于初步判断，不替代系统信息。 |
| 安装授权 | 系统可能要求为当前浏览器或文件管理器开放安装权限。只授权你实际使用的安装来源，完成后可恢复原设置。 |
| 更新覆盖 | 已有应用签名与新包不一致时可能无法覆盖安装。先备份配置并了解原安装来源，不要直接卸载导致设置丢失。 |
| 后台运行 | 连接稳定性受电池优化、后台活动和系统清理策略影响。先观察后台中断现象，再有针对性地调整权限。 |
导入订阅后先更新并选中配置，确认分应用代理规则没有排除测试应用。若只有锁屏后断开，优先检查后台策略，不必重新导入整份订阅。
Linux 客户端
先匹配发行版的软件包格式，再匹配架构。下面的主要入口是 x64，ARM 设备使用卡片内的 arm64 入口。
v2rayN
7.24.1v2rayN 是桌面图形客户端，适合在已有桌面会话中管理订阅与代理。安装包格式、CPU 架构与运行依赖是三项独立条件，任何一项不匹配都可能导致安装或启动失败。不要通过把 deb 改成 rpm 扩展名来转换软件包。
系统要求与安装检查
| 检查项目 | 选择依据 |
|---|---|
| 软件包体系 | Debian、Ubuntu 系通常使用 deb；RPM 系使用 rpm。安装前查看本机发行版及包管理器，不按桌面主题判断。 |
| 处理器架构 | x86_64、amd64 通常对应 x64；aarch64 通常对应 arm64。ARM 单板设备尤其需要核对系统实际架构。 |
| 桌面与依赖 | 需要兼容的图形桌面环境与运行依赖。包管理器报告缺失依赖时，先解决依赖，再继续启动应用。 |
| 代理作用范围 | 桌面系统代理不保证被所有程序读取。浏览器、终端和其他应用可能各有代理设置，需要分别验证。 |
若程序能启动但浏览器没有走代理，先检查桌面代理设置和应用自身网络选项。包安装成功、内核运行正常、应用采用代理是不同层次，不应混为一个问题。
安装后的
连接检查顺序
下载完成后先把客户端正常启动起来，再处理配置。每次只确认一个环节：安装、导入、选择、代理、验证。同时换客户端、换内核和改 DNS，往往会让一个简单问题变得难以复现。
先导入订阅，再选活动配置
订阅地址用于获取连接配置，不等于客户端本身。导入后执行更新，确认当前分组确实出现配置条目，再选中要使用的一项。如果更新失败，先检查地址是否完整、是否需要通过代理更新，以及原网络能否访问订阅地址。不要把地址中的凭据部分公开给他人。
先测连接，再确认应用流量
端口连通测试与真连接测试观察的层次不同，单个测试结果不能代替实际访问验证。桌面端开启合适的系统代理模式后，使用会读取系统代理的浏览器检查访问；Android 端确认 VPN 服务已运行，并核对测试应用是否被分应用规则排除。
先看日志，再决定是否重装
出现问题时记录发生时间、活动配置、代理模式及日志错误关键词。监听端口占用、订阅参数失效、域名解析失败分别对应不同处理方向。重装会增加配置迁移成本，却不一定改变网络条件。完整操作见订阅导入教程，字段含义见配置参考，连不上时从连接排查开始。
下载与安装
常见问题
v2rayN 桌面版和经典 WPF 版应该选哪个？
第一次使用可以先选桌面版，它采用新一代跨平台界面。已经熟悉 Windows 经典布局、希望延续原有操作习惯，可以选经典稳定的 WPF 版。两种入口不是不同的订阅服务；迁移前先备份配置，关闭旧程序后再启动另一版，避免本地端口冲突。
Android 的 arm64 和通用版有什么区别？
arm64 包面向 64 位 ARM 运行环境，2015 年后的主流手机通常可优先尝试。通用版包含多种架构支持，适合架构不明确或 arm64 安装失败的情况。出厂年份只是参考，最终以设备处理器和系统运行环境为准；安装失败也要检查系统兼容性与已有应用签名。
安装客户端后会自动获得可用配置吗？
不会。客户端负责读取配置、管理连接与执行路由规则，你仍需准备有权使用的订阅地址或连接参数。安装后先导入订阅、更新分组并选择配置，再开启合适的代理模式。不要把订阅地址贴到公开截图或日志中，因为地址可能包含访问凭据。
下载按钮没有反应，应该怎么检查？
先查看浏览器下载列表，确认是否在等待确认、被暂停或受下载目录权限影响，再尝试重新打开对应安装包链接。页面脚本未加载时，按钮仍保留完整文件地址。若多次失败，记录所选平台、按钮名称与浏览器错误提示，不要通过反复更换客户端来排查单纯的下载故障。
更新客户端前需要保留哪些设置？
先通过客户端支持的备份或导出入口保存配置，并记录订阅分组、自定义路由、DNS、入站端口与分应用设置。关闭正在运行的客户端后再更新。不同客户端或不同界面版本的配置格式不一定相同，迁移时优先使用明确支持的导入方式，不要直接覆盖陌生的配置目录。
安装成功但无法连接，还需要重新下载吗？
通常先检查当前配置是否选中、订阅是否有效、系统时间是否准确，再查看日志中的具体错误。桌面端确认系统代理与本地监听端口，Android 端确认 VPN 授权与后台运行权限。下载或重装不能修复失效订阅、错误参数及代理模式设置，先定位故障层再决定是否更换安装包。