V2Ray 客户端下载

系统要求与包类型

Windows 安装顺序

1. 先查看系统架构，再下载一个版本。把 ZIP 完整解压到独立目录，不要直接从压缩包预览窗口启动，也不要只拖出其中一个程序文件。
2. 打开解压目录里的安装程序，阅读安装提示并完成安装。若系统防护给出提示，先核实文件来源、名称和提示内容，再决定是否继续，不要为了安装而直接关闭防护。
3. 启动 v2rayN，添加订阅分组和订阅地址，保存后执行“更新全部订阅”。出现配置列表后选择一条配置，再按使用场景设置系统代理。

从 WPF 迁移到 Desktop 时，先保留原有设置备份，再检查新界面中的订阅分组、路由和 DNS。不要假定两个版本的配置目录或导入方式完全一致。测试时退出另一版本，避免本地监听端口冲突；退出客户端前清除系统代理，可以减少后续应用仍指向旧端口的情况。

系统要求与包类型

macOS 安装顺序

1. 打开下载的 DMG，把 v2rayN 复制到“应用程序”目录。复制完成后从应用目录启动，而不是长期在挂载的磁盘映像内运行。
2. 若系统阻止打开，先核对来源与系统提示，再到系统设置的“隐私与安全性”查看对应说明。不要用关闭系统安全机制的方式处理普通安装问题。
3. 导入订阅并更新配置。先用系统代理验证浏览器访问，再按需要设置 TUN；出现权限请求时，应确认请求来自当前启动的客户端。

安装包架构决定应用如何运行，路由规则决定流量如何转发，两者属于不同问题。应用无法启动时先看系统版本、处理器和权限；应用可以启动但访问失败时，再看配置、订阅与代理模式。更新前退出旧进程并保留设置备份，更新后核对本地端口，避免浏览器仍使用旧的手动代理配置。

系统要求与包类型

Android 安装与首次连接

下载后通过文件管理器打开 APK，阅读安装器提示。如果出现“应用未安装”，先检查架构、存储空间、系统兼容性以及是否存在签名不同的旧安装。不要直接卸载仍保存配置的应用；先导出可用设置，确认备份能够找到，再决定如何处理安装冲突。

打开客户端后添加订阅地址并更新，选择配置再点击连接。首次启动连接时，系统会显示 VPN 授权对话框；确认应用名称后再允许。安卓端使用的是系统 VPN 接口，与桌面端“自动配置系统代理”的操作不同，不能照搬桌面菜单路径。

v2rayNG 与 v2flyNG 可以作为不同方案进行比较，但同一时间只让一个应用建立 VPN 连接。切换客户端后重新确认选中配置与路由模式。若锁屏后连接中断，先检查后台限制，再查看日志，避免把省电策略引起的断连误判成订阅失效。

系统要求与包类型

Linux 图形安装顺序

1. 确认发行版、版本和系统架构，选择对应的包。双击下载文件，通过系统软件安装器查看包信息与依赖说明。
2. 使用软件安装器完成安装与依赖处理，再从应用菜单启动 v2rayN。若没有出现入口，先确认安装是否完成，再刷新桌面会话或重新登录。
3. 添加并更新订阅，选中配置后设置代理。不同桌面环境对系统代理的读取方式可能不同，应先用遵循系统代理的浏览器验证。

遇到依赖无法满足时，记录软件安装器给出的具体组件名称和所需版本，再核对发行版兼容性。不要为了完成安装而强行忽略依赖。TUN、系统代理与应用自己的代理设置属于不同层次，应逐项测试；终端工具也不一定自动遵循桌面系统代理。

需要登录后自动启动时，先确认手动启动和连接均正常，再在桌面环境的“启动应用程序”中添加客户端入口。安装与自启动的进一步说明见Linux 桌面部署教程。