v2rayN
首推Windows x64 提供 Desktop 与经典 WPF 两个安装入口。首次安装可先选 Desktop;已有经典界面使用习惯,可选 WPF。
入口下载的是 ZIP 压缩包。先解压到独立文件夹,再打开其中的安装程序;不要直接在压缩包预览窗口中运行。
Android 首推 v2rayNG,桌面端选择 v2rayN。先确认系统与处理器架构,再下载对应安装包。
安装包用于安装客户端;订阅地址与连接配置需另行准备。已安装的用户,升级前先导出当前配置。
选择系统标签后查看安装包。链接中的平台标记可保存,重新打开时会回到对应系统。
Windows x64 提供 Desktop 与经典 WPF 两个安装入口。首次安装可先选 Desktop;已有经典界面使用习惯,可选 WPF。
入口下载的是 ZIP 压缩包。先解压到独立文件夹,再打开其中的安装程序;不要直接在压缩包预览窗口中运行。
| 检查项目 | 本页安装包要求 | 查看位置 |
|---|---|---|
| 处理器架构 | x64;不适用于 32 位系统 | 设置 → 系统 → 系统信息 → 系统类型 |
| 操作系统 | 优先在仍获系统更新的 Windows 10 / 11 上使用;具体最低版本以安装程序提示为准 | 设置 → 系统 → 关于 |
| 安装环境 | 能够解压 ZIP、写入安装目录;依赖缺失时按安装程序提示处理 | 下载文件夹与安装界面 |
先退出正在运行的 v2rayN,再进行覆盖安装。如果旧客户端开着系统代理,建议先在托盘菜单关闭系统代理,避免安装期间浏览器仍指向已停止的本地端口。安装完成后,打开客户端检查订阅分组是否仍在,再恢复代理设置。
Desktop 与 WPF 是界面方案的区别,不是订阅服务的区别。选择其中一种即可,不需要为了连接同时启动两版。两份程序若使用相同的本地监听端口,可能互相冲突;需要试用另一版时,先彻底退出当前版本,并单独备份配置目录。
安装后先在订阅分组中添加地址并执行更新。需要让浏览器使用代理时,再开启系统代理;需要覆盖不读取系统代理的应用时,阅读 使用文档中的 TUN 说明,不要把系统代理开关与 TUN 当作同一项设置。
在苹果菜单打开“关于本机”。显示 Apple M 系列芯片时选 Apple Silicon;显示 Intel 处理器时选 Intel。
| 检查项目 | 本页安装包要求 | 查看位置 |
|---|---|---|
| 芯片架构 | Apple Silicon 使用 arm64;Intel 使用 x64 | 苹果菜单 → 关于本机 |
| 操作系统 | 使用仍获系统更新的 macOS;最低版本以应用安装提示为准 | 系统设置 → 通用 → 关于本机 |
| 安装权限 | 可将应用复制到应用程序目录;修改网络配置时按系统提示授权 | 访达与系统设置 |
下载 DMG 后双击挂载,将应用复制到“应用程序”,再从该目录启动。确认复制完成后,可以推出磁盘映像。不要长期从挂载的映像里运行客户端,否则更新或清理下载文件时容易混淆实际使用的位置。
首次启动若出现系统安全提示,先阅读提示全文,核对应用名称和文件来源,再查看“系统设置 → 隐私与安全性”提供的操作。不要为了启动应用关闭系统范围的安全保护;系统明确提示文件损坏或存在风险时,应停止安装并重新确认下载情况。
导入订阅后,先选择配置并启动,再决定是否设置系统代理。切换网络、睡眠唤醒或退出客户端后,如果浏览器无法访问,先检查系统代理是否仍指向本地监听端口。只有客户端正在运行且端口一致时,这项设置才能正常转发请求。
Android 优先选择 v2rayNG。2015 年后的主流手机通常选 arm64;无法确认系统架构时,可以选择通用版。
清单版本文字与包名版本可能暂时不同。安装前查看系统安装界面显示的版本,安装后以客户端“关于”页面为准。
已有配置明确面向 v2fly 内核时,可考虑 v2flyNG。选择前先确认协议、传输方式与配置字段是否受客户端内置内核支持。
| 检查项目 | 本页安装包要求 | 查看位置 |
|---|---|---|
| 设备架构 | arm64 包要求系统支持 arm64-v8a;不确定时选通用版 | 设备规格或系统应用兼容信息 |
| 系统版本 | 以安装界面的兼容性判断为准;旧系统可能无法安装当前包 | 设置 → 关于手机 → Android 版本 |
| 安装权限 | 为实际打开 APK 的浏览器或文件管理器允许本次安装 | 设置 → 应用 → 特殊应用权限 → 安装未知应用 |
| 连接权限 | VPN 模式首次启动时需确认系统连接请求 | 客户端启动连接后显示的系统对话框 |
下载完成后,在浏览器的下载记录或文件管理器中打开 APK。系统要求授权时,只给当前负责打开文件的应用授予安装权限;安装结束后,可回到设置关闭该权限。不同手机的菜单名称可能略有差别,以系统实际显示为准。
处理器支持 64 位,不等于系统一定支持 64 位应用。部分旧设备使用不同的系统构建,因此不能只按手机发布年份判断。如果 arm64 包无法安装,先查看系统提示;若提示不兼容再尝试通用包,不要反复下载同一个文件。
安装后打开“订阅分组设置”,填写备注与订阅地址,保存并返回主界面执行订阅更新。列表出现配置后,选中要使用的一项,再点击连接。首次启用 VPN 模式时确认系统授权;如果手机已有其他 VPN 连接,需要先决定保留哪一个,因为同一用户下通常只能有一个活动 VPN 服务。
v2rayNG 与 v2flyNG 的内核家族不同,不能只凭界面相似就假定配置完全通用。尤其涉及 VLESS、REALITY 或较新的传输字段时,应先核对内核能力。普通使用不需要同时开启两款客户端;需要对照差异时,查看三款客户端横向评测。
先按发行版选择 deb 或 rpm,再核对处理器架构。下面两个主要入口均为 x64;arm64 设备使用对应的小字入口。
| 检查项目 | 本页安装包要求 | 查看位置 |
|---|---|---|
| 桌面环境 | 可运行图形应用的桌面会话 | 系统设置 → 关于 |
| 处理器架构 | x64 对应 amd64 / x86_64;arm64 对应 arm64 / aarch64 | 系统信息中的硬件与架构项目 |
| 软件包格式 | 按发行版选择 deb 或 rpm,并满足包管理器列出的依赖 | 系统软件安装器 |
| 权限 | 安装需要相应系统权限;TUN 的授权需求与普通系统代理不同 | 安装及网络模式授权提示 |
在文件管理器中打开安装包,使用发行版的软件安装器查看包信息与依赖。遇到缺失依赖或版本不满足时,先处理系统提示,不要跳过依赖检查强行安装。安装完成后,从应用菜单启动 v2rayN,再进行订阅导入。
Linux 桌面的系统代理由桌面环境和应用共同决定。部分应用读取系统代理,部分应用需要在自身网络设置中填写本地代理地址。先确认客户端已启动,以及本地监听端口与应用填写的端口相同,再判断是否需要 TUN 接管流量。
使用 arm64 设备时,不要因为主要按钮更醒目就下载 x64 包。文件名中的 amd64 与 x86_64 都属于这里的 x64 入口,aarch64 对应 arm64。安装器若提示架构不匹配,应返回本页选择相应入口,而不是修改文件后缀。
先让一份配置正常启动,再添加分流、分应用代理或 TUN。逐项修改更容易定位问题。
打开客户端的订阅分组菜单,新增分组并粘贴完整地址。保存地址只建立了分组,不等于已经获取配置;回到订阅菜单执行更新后,再检查列表内容。地址包含访问参数时,应完整保留,不要把浏览器显示的省略文字当成完整地址。
订阅属于连接配置来源,客户端属于运行这些配置的工具。下载客户端不会自动生成可用订阅,也不会改变已有订阅的有效期。更新失败时先确认地址仍有效,再查看日志,不要通过反复安装应用替代排查。
选中一份配置并启动,确认客户端没有报告内核启动错误。Android 检查 VPN 授权,桌面端检查系统代理或应用代理是否启用。网页能否访问还取决于 DNS、路由和目标服务,不能只根据一个测试结果判断全部连接状态。
基础连接正常后,再按需要设置绕过局域网、域名策略或分应用代理。每次只修改一类设置,并保留可恢复的备份。需要完整学习顺序时,从手册中的核心概念开始,不必在首次安装时启用所有高级选项。
先按提示检查包类型与系统环境。连接阶段的问题可继续查看常见问题。
2015 年后主流手机通常优先选择 arm64,但仍需确认系统是否支持 64 位应用。无法确认架构,或 arm64 包提示不兼容时,选择通用版。通用版体积通常更大,不代表连接速度更快。
Desktop 使用新一代跨平台 UI;WPF 是面向 Windows 的经典稳定版。新安装可先选 Desktop,已有 WPF 使用习惯时可继续选择 WPF。两版菜单位置可能不同,切换前先备份订阅和设置。
客户端负责读取配置和建立连接,不附带可直接使用的订阅。安装后需要导入有权使用的订阅地址或配置,执行更新,再选择配置并启动。Android 首次启动通常还需确认系统 VPN 授权。
先检查安装包是否下载完成、剩余存储是否足够,以及架构是否匹配。覆盖安装失败还可能与已有应用签名不同或版本降级有关。先备份配置,再核对已安装版本与新包来源,不要直接卸载。
同一应用且签名兼容的覆盖升级通常会保留数据,但不能代替备份。更新前导出配置并记录订阅分组、路由和本地端口。跨客户端迁移、降级或卸载重装时,需要另行确认配置兼容性。
版本文字和文件路径由清单的不同字段提供,更新时可能暂时不一致。安装前查看系统安装界面显示的应用版本,安装后在客户端关于页面确认实际版本。不要根据页面文字改写下载地址或文件名。