v2rayN
Windows x64 · ZIP 安装包
Desktop 是采用新一代跨平台界面的桌面版;WPF 是沿用经典界面的稳定版。首次安装可从 Desktop 开始;升级时如果仍想沿用熟悉的界面,可以继续选 WPF。
先选操作系统,再按处理器架构与安装包格式下载。桌面端选 v2rayN,Android 首选 v2rayNG。
如果是替另一台设备下载,请以那台设备的系统信息为准。
Windows x64 · ZIP 安装包
Desktop 是采用新一代跨平台界面的桌面版;WPF 是沿用经典界面的稳定版。首次安装可从 Desktop 开始;升级时如果仍想沿用熟悉的界面,可以继续选 WPF。
| 检查项 | 系统要求与选择 |
|---|---|
| 系统与架构 | 面向 Windows 10/11 x64;在「设置 → 系统 → 关于」查看系统类型,确认是基于 x64 的处理器。 |
| 格式 | 先完整解压 ZIP,再从解压目录运行安装程序。 |
| 运行条件 | 如安装程序报告缺少运行组件,按提示核对所需版本和架构。 |
如果电脑由单位管理,先向管理员确认安装权限。普通安装与后续启用 TUN 是两件事,不必为了下载或导入订阅预先提升权限。
macOS 桌面版 · DMG
在苹果菜单打开「关于本机」:芯片栏显示 Apple M 系列时用 Apple Silicon 版;处理器栏显示 Intel 时用 Intel 版。两种包对应不同芯片,不需要都下载。
| 检查项 | 系统要求与选择 |
|---|---|
| 架构 | Apple 芯片对应 arm64,Intel 处理器对应 x64。 |
| 系统版本 | 在「关于本机」查看版本;若系统提示应用要求更高版本,换架构不能解决。 |
| 安装位置 | 打开 DMG,把应用拖入「应用程序」,再从该目录启动。 |
复制完成后可推出磁盘映像。若启动失败,先区分芯片不匹配、系统版本不足和权限提示,不要把所有弹窗都当作同一个问题处理。
Xray 内核 · APK
2015 年后的主流手机可先考虑 arm64;最终以系统是否支持 arm64-v8a 为准。某些设备虽然装有 64 位处理器,但运行的是 32 位系统,遇到这种情况应改选通用版。
v2fly 内核 · APK
已有与 v2fly 内核匹配的配置时,可选这款客户端。两款 Android 应用不是彼此的升级包;换用前先确认订阅的协议与传输设置能被目标客户端识别。
| 检查项 | 系统要求与选择 |
|---|---|
| 架构 | 系统支持 arm64-v8a 时选 arm64,无法确认时选通用版。 |
| 系统版本 | 在「设置 → 关于手机」查看 Android 版本。安装器提示系统版本过低时,更换同版安装包的架构无效。 |
| 安装权限 | 系统可能要求对打开 APK 的浏览器或文件管理器单独授权。确认来源后再决定是否允许,安装完成可撤回授权。 |
Linux 桌面版 · deb / rpm
先按发行版选择包格式,再按当前系统的架构选包。rpm 文件名中的 el10 表示构建目标,不代表任意使用 rpm 的发行版都具备所需依赖。
| 检查项 | 系统要求与选择 |
|---|---|
| 包格式 | Debian、Ubuntu 系通常选 deb;使用 rpm 的系统需另核对发行版和包的构建目标。 |
| 架构 | 终端运行 uname -m。x86_64 对应 x64,aarch64 对应 arm64。 |
| 桌面环境 | 本页提供的是图形客户端,需能运行桌面应用,并由系统包管理器满足依赖。 |
如果包管理器报告依赖版本不满足,记下依赖名和发行版版本。不要强制忽略依赖,也不要仅靠改文件扩展名切换包格式。
同一客户端名称下有多个包,并不表示这些包可以互换。系统决定打开哪种安装文件,架构决定程序能否在目标设备上运行,发行版及其依赖则决定包管理器能否完成安装。比如,x64 和 arm64 都可能被系统设置概括为「64 位」,只看位数还不够。Linux 系统上,文件名中的 amd64 或 x86_64 指的是同一类架构,不是限定某个处理器品牌。
在虚拟机中安装时,看虚拟机里显示的系统与架构,不要直接照抄宿主机的信息。从旧电脑迁移时也一样:旧电脑能运行的安装包未必适合新电脑,但订阅地址通常可以在新客户端重新导入。若安装器已经明确提示系统版本或依赖不匹配,反复下载同一个包不会改变本机环境,先保留提示原文,再决定是否升级系统或换用与之匹配的包。
从当前客户端记录订阅分组名称、活动服务器和路由模式。如果使用过自定义 DNS 或修改过本地监听端口,也一并记录。客户端提供导出功能时,先把导出文件保存到应用目录之外;这样即使卸载时应用数据一起被移除,备份也还在。订阅地址可能包含访问凭据,备份应放在受控位置,排查问题时不要把完整链接贴进公开帖子或截图。
重新添加订阅通常可以取回服务端提供的列表,但不能保证恢复手工添加的服务器、此前选中的路由模式或本地覆盖项。把这些内容分开备份:订阅保留来源,手工配置保留导出文件或可重建的设置记录。换用另一款客户端时,优先导入可互通的订阅,再重新设置应用特有的选项;不宜把整份应用数据目录直接复制到另一款应用中。
首次启动后,先确认主窗口能打开,并检查服务器列表与订阅分组是否符合预期。新安装的列表为空是正常情况;已有配置却看不到条目时,先清除列表筛选,再检查当前分组和是否打开了正确的客户端。安装过程完成,不等于订阅已经更新,也不等于系统代理已经生效。这几个步骤分开做,更容易定位问题出在哪一环。
桌面端切换版本时,关闭旧窗口后还要确认托盘里的旧进程已退出;两个客户端同时运行,可能争用同一端口,或者先后更改系统代理。手机上首次连接时,系统可能弹出 VPN 连接请求,先核对弹窗里的应用名。若旧客户端正在连接,先断开,再切换到新客户端验证。只有在基本连接正常后,才有必要进一步调整路由、DNS 或 TUN。
先判断问题发生在选包、安装还是配置阶段,再按对应提示处理。
不用。首次安装可选 Desktop 桌面版;已有 WPF 使用习惯可继续选择经典版。切换前保存配置,测试时先退出旧客户端,避免两份程序争用本地端口或重复修改系统代理。
arm64 包适用于支持 arm64-v8a 的系统;通用包覆盖应用构建时打包的多种架构,体积通常更大。若设备架构不明,可先选通用包。通用包不能解决系统版本过低或签名冲突。
卡片上的版本号是发布清单的版本字段,不一定与包名同时更新。先核对应用名、平台和架构;如果下载的包与预期版本不符,先不要覆盖现有安装,待清单更新后再确认。
同一应用正常覆盖安装通常会保留应用数据,但卸载重装、换客户端或改变配置目录时不能依赖这一点。更新前备份可导出的配置,单独记录订阅分组与路由设置,安装后先检查列表再启动连接。
v2rayN 使用「订阅分组」添加并更新订阅;v2rayNG 从侧栏进入订阅分组设置,再回到列表更新订阅。下载客户端不等于获取订阅,订阅地址需由你的服务提供方或管理员提供。