CLIENT WORKBENCH / 安装包选择
v2rayN 桌面客户端 · v2rayNG 与 v2flyNG 安卓客户端
先选系统，再看架构。桌面用 v2rayN，Android 首选 v2rayNG。安装包负责装好程序，订阅和代理设置是下一步。
平台标签可用方向键切换。链接中的平台锚点可直接打开对应清单。
DESKTOP / x64
下载v2rayN 桌面版新一代跨平台 UI。首次安装可以从 Desktop 开始，桌面系统之间的界面习惯更容易衔接。此入口为 x64 安装压缩包，下载后先解压，再运行其中的安装程序。
CLASSIC WPF / x64
下载v2rayN 经典 WPF 版经典稳定版，采用 Windows WPF 界面。已经熟悉服务器列表、托盘菜单和既有设置位置的用户，可继续使用这一分支。它不是另一款代理软件，主要区别在界面技术与操作布局。
两个入口都是 v2rayN。先选一个安装；切换界面版本前，备份订阅分组与路由设置。
| 检查项 | 选择与准备 |
|---|---|
| 系统与架构 | 优先使用仍获系统更新的 Windows 10 / 11；本页两个包均为 x64。到「设置 → 系统 → 关于」查看系统类型。 |
| 安装格式 | ZIP 压缩包。解压到可写的本地目录后运行安装程序，不要在压缩包预览窗口内直接启动。 |
| 运行环境 | 是否需要额外 .NET 运行库，以当前发行包及启动提示为准；需要时安装对应架构与类型的运行库。 |
| 代理权限 | 常规系统代理先用普通权限运行；启用 TUN 时可能需要管理员权限和虚拟网络接口支持。 |
文件名里出现 Setup，外层仍然可能是 ZIP。先完成解压，让安装程序与附带文件保持在同一目录，再按提示安装。路径尽量简短，避免把工作目录放在只读位置、同步盘占用的目录或需要额外权限的位置。启动失败时先看错误文本；运行库、权限与配置损坏是不同问题，重装之前先分清是哪一类。
打开 v2rayN 后，在「订阅分组设置」中新增分组，填入自己的订阅地址并保存，再通过「更新订阅」获取节点。选中准备使用的服务器，确认客户端已经启动，最后在系统代理菜单中选择「自动配置系统代理」。系统代理负责应用入口，路由负责流量去向，两者不是同一个开关。
如果从旧版迁移，先退出旧客户端，避免两套程序抢同一组本地端口。订阅地址通常可以重新更新，手动节点、定制路由与 DNS 则需要另外保留。建议先完成一次普通系统代理连接，再尝试 TUN；基础链路还没通就叠加虚拟网卡，排查清单会越写越长。
查看 Windows 完整安装与配置章节 →
APPLE SILICON / arm64
下载 Apple Silicon 版使用 Apple Silicon 芯片的电脑选这个入口。arm64 对应芯片架构，不是系统版本编号。到苹果菜单的「关于本机」查看「芯片」一栏；显示 Apple M 系列时，选择此包。
INTEL / x64
下载 Intel 版使用 Intel 处理器的电脑选 x64 包。「关于本机」显示 Intel 处理器时选这一项。不要根据电脑外观或购买年份猜架构；芯片名称比记忆可靠，也省一次返工。
| 检查项 | 选择与准备 |
|---|---|
| 处理器 | Apple Silicon 选 arm64，Intel 选 x64；在「关于本机」确认。 |
| 系统兼容 | 使用仍获系统更新的 macOS；具体最低版本以当前应用发行要求和系统安装提示为准。 |
| 安装格式 | DMG 磁盘映像。打开后将应用复制到「应用程序」，再从本地应用目录启动。 |
| 网络权限 | 调整系统代理或启用 TUN 时，按明确的系统授权提示操作；普通启动不等于已接管网络。 |
下载 DMG 后，等待浏览器保存完成，再打开磁盘映像。将 v2rayN 复制到「应用程序」，不要长期在挂载的映像内运行。复制完成并确认本地应用可启动后，可以推出映像。系统如果给出阻止打开的提示，先阅读原因，再到「系统设置 → 隐私与安全性」查看对应记录；不要用全局关闭安全检查来替代具体处理。
首次启动先导入订阅、更新节点，再选择服务器。启用系统代理后，在「系统设置 → 网络」中查看当前网络服务的代理设置，可以帮助确认客户端是否完成了入口配置。切换 Wi-Fi、有线网络或工作网络后，代理状态可能需要重新检查。浏览器能联网不代表所有终端程序都会使用系统代理。
准备使用 TUN 时，先保存一份正常工作的基础配置，随后按应用提示申请权限。连接结果异常时，先关掉新启用的模式回到基础配置，而不是同时替换节点、DNS 和路由。退出客户端前关闭代理，尤其是在安装新版或更换客户端时，避免系统继续指向已经停止监听的本地端口。
查看 macOS 完整安装与配置章节 →
Xray 内核 · 订阅分组 · VPN 模式
arm64-v8a / 常用架构
下载v2rayNG arm642015 年后的主流手机通常先选 arm64。包体只包含对应架构内容，适合确认支持 64 位应用的设备。最终以设备运行环境为准，处理器支持 64 位不一定代表系统开放了相同的应用支持。
v2fly 内核 · 按配置兼容性选择
arm64-v8a / 常用架构
下载v2flyNG arm64适合明确需要 v2fly 内核、且设备支持 arm64 应用的用户。已有配置来自相同内核生态时，可以作为备选客户端。协议与传输选项仍需和服务端一致，内核名称不能代替配置检查。
UNIVERSAL / 多架构包
下载v2flyNG 通用版不确定架构时选通用包。v2flyNG 与 v2rayNG 是不同应用，配置与权限需要分别设置。切换测试时先停止另一款客户端的连接，同一时刻只让一款应用接管 VPN。
| 检查项 | 选择与准备 |
|---|---|
| 应用架构 | 主流设备优先 arm64；无法确认时选通用版。安装器报架构不兼容时，重新核对系统实际支持情况。 |
| 系统版本 | 最低系统要求随客户端发行变化，以安装器提示为准；通用版不会降低最低系统要求。 |
| 安装权限 | APK 安装需要允许当前浏览器或文件管理器「安装未知应用」。完成后可收回该来源的安装权限。 |
| 连接权限 | 首次连接需要确认系统 VPN 授权；后台持续运行可能需要在电池设置中放宽对应应用的限制。 |
打开已下载的 APK 后，根据系统提示给当前来源安装权限。这里的「来源」是打开文件的应用，例如浏览器或文件管理器，不是把整台手机的安全设置全部改掉。安装器提示「应用未安装」时，先记录完整原因，再检查架构、存储空间、系统版本及旧版签名；不要把所有失败都归到下载文件上。
在 v2rayNG 的「订阅分组设置」保存订阅地址，返回主界面后执行「更新订阅」。如果拿到的是单条分享链接，应使用「从剪贴板导入」，不要把它填进订阅地址栏。导入完成后选中节点，点击连接按钮并确认 VPN 授权。VPN 模式提供应用流量入口，具体直连或代理仍由路由设置决定。
后台断连时，先检查应用是否被系统电池策略暂停，再检查节点日志。为对应客户端调整后台权限即可，不必给所有应用放宽限制。v2rayNG 使用 Xray 内核，v2flyNG 使用 v2fly 内核；两者支持的配置细节可能不同，尤其是特定协议和传输组合。已有服务配置明确要求 Xray 特性时，优先保持使用 v2rayNG。
查看 v2rayNG 订阅导入与首次连接教程 →
DEB / x64
下载v2rayN deb 包Ubuntu、Debian 等使用 DEB 包管理体系的 x64 桌面选此入口。文件名中的 amd64 与常见的 x86_64 指向同类架构，不限定处理器品牌。安装时交给系统软件安装器处理依赖。
RPM / x64
下载v2rayN rpm 包Fedora、openSUSE 等 RPM 体系的 x64 桌面从此入口开始。使用相同包格式不代表发行版依赖完全相同；安装器提示缺少库或包版本冲突时，应按当前发行版处理。
ARM64 桌面另选对应包，不要安装上方 x64 文件：
| 检查项 | 选择与准备 |
|---|---|
| 桌面环境 | 需要可运行图形应用的 Linux 桌面会话；本页提供的是图形客户端，不是服务端部署包。 |
| 处理器架构 | x86_64 / amd64 选 x64；aarch64 / arm64 选 ARM64。到系统「关于」或硬件信息页确认。 |
| 包管理体系 | Ubuntu、Debian 选 deb；Fedora、openSUSE 等 RPM 体系选 rpm，同时检查当前发行版依赖兼容性。 |
| 权限与依赖 | 安装软件包需管理权限；日常图形界面通常以普通用户启动，TUN 另按提示授权。 |
选择 Linux 包时有两道检查：先看包管理体系，再看处理器架构。DEB 和 RPM 是安装格式，x64 与 ARM64 是运行架构，这两组不能互相替代。把扩展名改成另一种格式也不会完成转换。双击安装包交给系统软件安装器，确认依赖提示后安装；如果安装器明确提示发行版不兼容，先停止，别强行忽略依赖。
安装后从应用菜单启动 v2rayN，新增订阅分组并更新节点。Linux 桌面的系统代理是否生效，还取决于桌面环境和应用自身：浏览器可能读取桌面代理，命令行工具却未必读取。先用明确支持系统代理的应用测试，再处理其他程序的代理入口。节点可用、应用未走代理，两种现象要分开记录。
需要登录后自动运行时，在桌面环境的「启动应用程序」或同类设置中添加 v2rayN。登录自启动与系统开机服务是两回事：图形客户端应在用户会话就绪后启动。更新前正常退出应用，保留个人配置；启用 TUN 后若出现网络异常，先恢复普通代理方式，再检查权限、接口与路由。
查看 Linux 桌面安装与自启动说明 →下载完成只是第一段工序。客户端、订阅、流量入口与路由各管一层，按顺序设置更容易定位问题。先让最简单的连接工作，再追加分流、DNS 与 TUN；一次只改一个设置，日志才有参照。
01 / 配置来源
确认拿到的是可更新的订阅地址，还是以 vmess://、vless:// 等开头的单节点链接。订阅放进「订阅分组设置」，分享链接走剪贴板导入。网页地址、登录页地址和订阅地址不一定相同，导入前先核对服务提供的说明。
02 / 代理入口
桌面端启用系统代理，Android 完成 VPN 授权。节点出现在列表里，只说明导入成功；程序已经启动并且应用流量进入客户端，才算进入连接测试。其他代理程序应先停止，避免端口占用、系统代理互相覆盖或 VPN 冲突。
03 / 结果确认
用日常浏览器访问需要测试的目标，查看客户端日志是否出现连接记录。能访问后再选择合适的路由模式。系统代理与「绕过局域网及大陆地址」等路由选项分属不同层；切换路由不会自动补上遗漏的系统代理设置。
版本号会随下载清单更新，桌面客户端和安卓客户端各自维护，不需要追求数字一致。是否升级，应结合当前功能需求与发行变化判断。已有配置能正常工作时，先备份再更新；遇到故障时，记录升级前后差异，比来回重装更有用。完整步骤见使用教程，平台细节见全平台安装配置文档。
先分清安装问题与连接问题，再动设置。
首次安装可以先选 Desktop 版，它使用新一代跨平台界面。熟悉经典 Windows 界面、需要沿用既有操作习惯时，选择 WPF 版。两者都属于 v2rayN；下载前按包名区分，切换前备份配置，不要让两套客户端同时接管系统代理。
2015 年后的主流手机通常先选 arm64，但仍应以设备实际支持的应用架构为准。无法确认架构时可选通用版。安装失败还可能与下载中断、系统版本、签名冲突或安装权限有关，不能只根据购买年份判断。
安装包提供客户端程序，不包含可直接使用的订阅。订阅地址或分享链接由所使用的服务或自行部署的服务端提供。v2rayN 在「订阅分组设置」中保存地址后更新订阅；v2rayNG 在「订阅分组设置」中保存地址后更新订阅。地址可能带有访问凭据，不应公开分享。
先备份订阅分组、路由设置与必要配置，再退出旧客户端。相同应用且签名兼容时，Android 通常可以覆盖安装；桌面端按安装程序提示更新。出现签名冲突、切换发行包或更换界面版本时，不要直接删除旧数据，先确认新客户端能够导入配置。
先确认浏览器已经完成下载，文件扩展名与所选平台相符。Windows 的 ZIP 包需要先解压；Android 使用 APK；macOS 使用 DMG；Linux 按发行版选择 DEB 或 RPM。若下载中断，可重新下载；若系统阻止安装，查看明确的系统提示，不要直接关闭全部安全防护。
安装、导入、启动代理是三个不同环节。先选中节点并启动客户端，再检查桌面端的系统代理是否启用，或 Android 的 VPN 授权是否完成。浏览器代理设置、其他代理程序、路由规则和 DNS 都可能影响结果。按日志中的具体错误逐项排查，不要连续修改多个设置。