V2Ray 客户端下载
v2rayN 与 Android 客户端

Windows 系统要求与安装

下载后先退出正在运行的旧客户端，尤其要检查任务栏托盘是否仍有程序驻留。将压缩包完整解压后运行安装程序，按提示完成安装。不要只从压缩包中拖出单个程序文件，否则同目录依赖可能缺失。若界面可以启动但内核立即退出，打开日志面板记录第一条明确错误，再判断是否存在端口占用或运行环境缺失。

桌面版与 WPF 版的区别主要体现在界面与操作布局，不应把更换界面版本当成网络故障的通用修复方法。初次配置时只运行一个客户端实例，避免两版同时修改系统代理。完成订阅更新后，在服务器列表中选中一项，再从托盘菜单设置「自动配置系统代理」。需要接管更多应用流量时，再单独验证 TUN 模式。

macOS 系统要求与安装

先从系统菜单打开「关于本机」，确认芯片类型，再下载对应 DMG。打开磁盘映像后，将应用复制到「应用程序」，等待复制完成后再运行。直接从磁盘映像启动容易使更新位置与实际使用位置不一致，后续排查时也难以判断正在运行的是哪一份程序。完成安装后可推出磁盘映像。

若系统阻止首次打开，先阅读「系统设置 → 隐私与安全性」中的具体提示，确认下载来源和应用身份后再决定是否继续。不要为了启动单个应用而关闭整套系统安全机制。进入客户端后先导入订阅并测试选中的服务器；若浏览器仍未使用代理，检查系统网络设置中的代理地址、端口是否与客户端本地监听一致。

从休眠恢复或切换网络后出现连接中断，先确认客户端仍在运行，再查看代理与 TUN 状态。退出客户端前可先清除系统代理，避免系统继续指向已经停止的本地端口。不同版本界面中的菜单位置可能调整，字段含义与验证顺序保持一致。

Android 系统要求与安装

下载 APK 后，从下载列表或文件管理器打开。若系统要求授权安装来源，进入对应应用的权限页面完成操作，再返回安装器继续。安装结束后，可按需要收回该来源的安装权限。遇到「应用未安装」，先查看是否存在架构不匹配、系统版本过低或已安装应用签名不同，不要反复下载同一个文件。

已有订阅和自定义规则时，不要立即卸载旧应用。先使用应用提供的导出或备份功能保存配置，再判断是否需要重新安装。v2rayNG 与 v2flyNG 的内核不同，不能仅凭名字相似就认为所有协议和字段完全通用。对 VLESS、REALITY 等配置，先确认所选客户端当前内核的支持情况，通常优先从 v2rayNG 开始验证。

安装并导入配置后，首次连接会出现系统 VPN 授权。该授权用于建立本机流量转发通道，并不表示订阅已经有效。连接开关打开后仍需测试实际访问。若锁屏后经常断开，检查系统对该客户端的电池优化、后台活动及网络限制；更改后再次锁屏验证，避免一次修改多个设置而无法定位原因。

Linux 系统要求与安装

先进入系统「关于」或硬件信息页面查看处理器架构，再确认发行版使用的包格式。用系统软件安装器打开下载的 deb 或 rpm，阅读依赖信息后完成安装。包管理体系相同，不代表任意发行版都能直接运行同一个包；若安装器提示运行库版本不足，应先核对发行版版本与包的构建目标，不要强制忽略依赖。

安装完成后从应用菜单打开 v2rayN。普通图形界面建议在当前用户会话中运行，不要为了绕开单个权限提示就将整个桌面程序长期以高权限启动。先验证本地监听和系统代理，再处理 TUN。不同桌面环境对系统代理的读取方式存在差异，部分应用需要在自身网络设置中选择系统代理或手动填写本地地址。

TUN 启用失败时，查看日志中的权限、虚拟网卡和路由报错，按具体错误处理。切勿同时启用多个代理程序的 TUN 接管。更换发行版或迁移设备前，单独备份订阅分组与自定义路由，避免把旧系统中的路径、网络接口名和权限设置直接照搬到新环境。