v2rayN
首推Desktop 使用新一代跨平台界面,适合首次安装或在不同桌面系统间切换的用户。WPF 是经典稳定版,适合熟悉传统菜单和托盘操作的用户。两套界面不需要同时装,也不要假定切换后会自动继承设置。
安装包 / 平台索引
先选操作系统,再按处理器架构与包格式下载。安装后,使用已有的订阅地址或节点配置完成连接。
Desktop 使用新一代跨平台界面,适合首次安装或在不同桌面系统间切换的用户。WPF 是经典稳定版,适合熟悉传统菜单和托盘操作的用户。两套界面不需要同时装,也不要假定切换后会自动继承设置。
先把 ZIP 完整解压到本机目录,再从解压后的文件夹启动安装程序。不要直接在压缩包预览里双击其中的程序;预览工具可能只把单个文件解到临时目录,安装时就找不到同一包内的其他文件。
如果安装程序提示缺少运行环境,记下提示里的组件名称、版本和架构,再按提示补齐。反复切换桌面版与 WPF 版并不能解决缺少依赖的问题。设备由单位管理时,先确认软件安装策略,不要用其他账户绕过限制。
已有配置时,先在旧客户端记录订阅分组、本地端口和当前代理模式,备份后再退出托盘进程。新客户端首次启动时先确认端口未被占用,再导入配置,最后开启系统代理。这样能区分配置迁移的问题和本地端口冲突。
| 检查项 | 适用条件 |
|---|---|
| 系统类型 | 本页两包均为 x64,核对「系统 → 关于」中的系统类型。 |
| 运行环境 | 以当前所选版本的安装提示为准。 |
只看到「64 位」还不够,继续确认处理器类型。x64 与 ARM64 都是 64 位,但不是同一架构。
在苹果菜单中打开「关于本机」。显示 Apple 芯片时选 Apple Silicon;显示 Intel 处理器时选 Intel。安装包选择取决于芯片,不取决于设备的外观或购买年份。
打开对应的 DMG。若窗口提供「应用程序」快捷方式,把客户端拖入该目录,等复制结束后推出磁盘映像,再从「应用程序」启动。不要把映像内临时挂载的副本当成已经安装的应用。
若系统提示应用不兼容,先确认重新下载的是当前芯片对应的包,再检查系统版本是否满足该版本要求。若出现安全策略提示,保留原始提示并确认来源与设备策略;芯片选错、应用被策略阻止是两类问题。
迁移时先退出旧客户端,再替换应用。替换应用程序不等于清空用户配置;如果新版本启动后仍显示旧订阅,先查看客户端当前使用的配置,不要为清空列表直接删除整个应用数据目录。
| 检查项 | 适用条件 |
|---|---|
| 芯片 | Apple 芯片对应 arm64,Intel 处理器对应 x64。 |
| 系统与权限 | 需符合该发行版的系统要求,并有权将应用复制到目标目录。 |
安装后,先在客户端确认配置可以加载,再测试依赖系统代理设置的应用。
2015 年后推出的主流手机通常选 arm64,但判断依据是系统支持的应用架构。若设备规格不明确,或安装器明确提示架构不匹配,可改试通用版。清单版本字段可能与包文件名不同;确认安装结果时,以系统应用详情显示的版本为准。
订阅明确适配 v2fly 时,可选 v2flyNG。能导入订阅不等于其中每个节点都可用。换客户端后先测试一个已知可用的节点,再决定是否迁移其余配置。
安装权限针对打开 APK 的应用,例如浏览器或文件管理器。个人设备允许安装时,只给当前来源授权,安装结束后可收回权限。若系统报告签名冲突,先备份旧配置,优先从原分发渠道升级;不要直接卸载尚未备份的旧版本。
如果能打开应用却无法启动连接,检查系统是否已让另一款应用保持 VPN 常驻,或是否已拒绝当前客户端的 VPN 请求。先在设备允许的范围内退出冲突的连接,再单独测试一个客户端,避免把系统接管冲突误判成 APK 架构问题。
| 检查项 | 适用条件 |
|---|---|
| 应用架构 | 支持 arm64-v8a 时选 arm64;架构不明时考虑通用版。 |
| 系统版本 | 需满足 APK 的最低系统要求;以系统安装器提示为准。 |
| 安装策略 | 系统须允许当前来源安装应用;工作资料可能另有限制。 |
部分设备的处理器支持 64 位,但系统只能运行 32 位应用。选包时以系统支持的应用架构为准。
ARM64 安装包: 下载 deb · arm64 下载 rpm · aarch64
在发行版的系统信息里查看版本和处理器架构。amd64 与 x86_64 都用于标记 x64;arm64 与 aarch64 通常标记同一类 ARM 64 位目标。先配对发行版的包格式,再核对架构,不要因为后缀相同就跨架构安装。
用发行版的软件安装工具打开本地包,检查它列出的依赖缺项。当前 rpm 文件名里的 el10 是构建目标标记,不代表所有支持 rpm 的发行版都满足依赖。如果工具提示无法满足依赖,先核对发行版版本和软件源;不要强制跳过依赖,也不要把改后缀当成格式转换。
安装成功后从桌面会话启动客户端。部分桌面环境的系统代理设置只影响会读取该设置的应用;若浏览器与终端表现不同,先区分各自如何读取代理,再决定是否需要改客户端模式。
| 检查项 | 适用条件 |
|---|---|
| 包格式 | Debian、Ubuntu 系通常选 deb;Fedora、RHEL 系通常选 rpm。 |
| 处理器 | 分别提供 x64 和 ARM64,不能用包格式推断架构。 |
| 桌面环境 | 需有可启动图形客户端的桌面会话,且发行版能满足包依赖。 |
通过远程终端管理的主机即使能安装这个包,也不意味着当前终端会话能打开图形界面。
新装只需为当前设备选一个包。升级前则应记录客户端名称、系统架构和原安装渠道,并单独备份订阅与手动配置。订阅可以重新拉取节点,但本机调整过的分流、端口和代理模式不一定随订阅恢复。
如果下载后系统把文件识别成网页,先看下载是否完整结束,以及文件类型是否符合所选入口。不应靠手动改扩展名继续安装。下载失败与安装失败的分界很明确:前者没有拿到预期格式的文件,后者才由系统安装器给出报错。
在另一台设备上准备安装文件时,以目标设备的系统和架构为准。把安装包复制过去并不会转移客户端的订阅配置;共享配置时,另选支持的导入方式,并妥善保管带有访问权限的订阅地址。
查看客户端对比首次启动后先确认程序能正常打开,接着导入订阅并手动更新。确认列表中出现预期条目,再选一个已知可用的节点测试。订阅拉取成功与节点建立连接是两次不同的请求,其中一次成功不能证明另一次正常。
先用一个可以确认代理设置的应用做对照,测试时只改一个选项。系统代理依赖应用读取系统设置;TUN 则涉及虚拟网络接口、系统权限和匹配范围。不要在首次排查时同时修改模式、DNS 与路由规则,否则很难定位是哪项设置改变了结果。
用同一应用、同一目标地址对比开启前后的表现。只在开启后失败时,先查看客户端的日志;两种状态都失败时,从本机网络开始查。记录问题时保留报错与发生步骤,删去订阅地址及其他访问凭据。
查看 v2rayN 配置教程不需要。初次安装可选桌面版;已有 WPF 操作习惯或配置的用户可继续选 WPF。切换前备份配置并退出旧客户端,避免两个实例同时占用本地代理端口。
不能。通用包主要用于覆盖更多处理器架构,不能解决系统版本不足、安装权限受限或应用签名冲突。优先查看系统安装器给出的原因,再决定是否更换包。
Debian、Ubuntu 系发行版通常使用 deb,Fedora、RHEL 系发行版通常使用 rpm。包格式匹配后仍要确认处理器架构与发行版依赖;文件能打开不等于可以安装。
客户端安装包不提供订阅或节点。请向服务提供方或网络管理员获取与所选客户端兼容的配置,再按教程导入。不要把带访问凭据的订阅地址发到公开渠道。
先不用重装。确认客户端能更新订阅、已选中节点,并检查应用是否使用了预期的代理模式。记录首条相关错误;若暂停代理后仍无法联网,先检查系统网络。