v2rayN
首推 7.24.1Desktop 是新一代跨平台 UI,适合首次使用以及需要在不同桌面系统之间保持操作习惯的用户;WPF 是经典稳定版,保留熟悉的 Windows 界面。先选一种安装即可,不需要为了使用不同协议同时运行两版。
客户端 / 安装包选择
先选系统,再选架构。桌面使用 v2rayN,安卓首选 v2rayNG,v2flyNG 作为内核取向不同的备选。
同一客户端,两种界面。以下入口均面向 x64 系统。
Desktop 是新一代跨平台 UI,适合首次使用以及需要在不同桌面系统之间保持操作习惯的用户;WPF 是经典稳定版,保留熟悉的 Windows 界面。先选一种安装即可,不需要为了使用不同协议同时运行两版。
| 检查项 | 选择与要求 |
|---|---|
| 系统架构 | 本页 Windows 包为 x64。在“设置 → 系统 → 系统信息”查看系统类型;不要把 x64 包当作原生 arm64 包。 |
| 系统环境 | 使用仍接收安全更新的 Windows;具体最低系统与运行时要求以安装程序提示为准。 |
| 目录与权限 | 解压到可写目录,避免权限受限位置。普通系统代理与 TUN 的权限需求不同,按实际功能授予权限。 |
下载完成后先退出已运行的代理程序,避免监听端口或系统代理相互覆盖。安装后进入 v2rayN 的“订阅分组设置”,创建分组、填写订阅地址,再执行“更新订阅”。有单条分享链接时可从剪贴板导入服务器,不要把完整配置 JSON 当作订阅地址粘贴。
第一次连接先使用系统代理,选择服务器后查看日志是否正常启动。部分版本常见本地 SOCKS 与 HTTP 端口分别为 10808 和 10809,但应以设置页实际值为准。只有目标程序不遵循系统代理、且确实需要接管其流量时,再阅读 TUN 配置说明。迁移 Desktop 与 WPF 前先备份,不要让两版同时写入同一份配置。
打开“关于本机”,按芯片名称选择 DMG。
Apple Silicon 机型选择 arm64,Intel 处理器机型选择 x64。判断依据是“关于本机”的芯片或处理器字段,不是电脑购买时间,也不是当前浏览器的名称。v2rayN 在 macOS 使用跨平台桌面界面。
| 检查项 | 选择与要求 |
|---|---|
| Apple Silicon | “关于本机”显示 Apple 芯片时,选择 arm64 DMG,优先使用对应架构的应用。 |
| Intel | “关于本机”显示 Intel 处理器时,选择 x64 DMG;arm64 应用不能直接替代。 |
| 系统与许可 | 使用仍接收安全更新的 macOS,并确认当前应用的最低系统要求。首次打开可能需要确认系统安全提示。 |
不要长期从挂载的磁盘映像中运行应用。先完成复制,再退出映像并启动“应用程序”目录中的 v2rayN。若系统阻止打开,仅在确认下载来源后,按提示进入“系统设置 → 隐私与安全性”处理。不要为了省略这一步而整体关闭系统安全机制。
导入订阅、更新服务器列表后,再开启系统代理并验证浏览器连接。系统代理并不会自动覆盖所有终端程序;终端工具可能需要独立设置代理地址。启用 TUN 时涉及权限与网络路由,建议先确认普通代理可用,再按文档逐项配置。更新前退出旧应用,保留可恢复的配置备份。
继续查看 macOS 安装配置 →v2rayNG 首推,v2flyNG 备选。按顺序选择,不必同时连接。
Android 日常使用优先选择 v2rayNG。2015 年后的主流手机通常选择 arm64;系统架构无法确定时,选择通用版。协议与传输是否可用,仍取决于订阅配置与所带内核,不是装上客户端就能自动补全服务端参数。
需要使用 v2fly 内核生态配置时,可选择 v2flyNG。它是独立的安卓客户端,不是给 v2rayNG 安装的扩展。不要假定两款应用支持完全相同的配置字段;包含特定内核能力的分享链接,应先确认兼容性再导入。
| 检查项 | 选择与要求 |
|---|---|
| arm64 | 适合支持 64 位应用的 ARM 设备;较新的主流手机通常适用,但硬件年份不能替代系统架构判断。 |
| 通用版 | 不确定架构时优先考虑。通用包不能绕过应用的最低 Android 系统版本要求。 |
| 安装与连接 | 为用于安装的浏览器或文件管理器临时允许安装应用;连接时按系统提示授予 VPN 权限。 |
下载 APK 后从系统下载列表或文件管理器打开。若提示无法安装,先查看具体错误:架构不匹配、系统版本过低、空间不足和签名冲突需要分别处理。不要第一步就卸载旧应用;先导出必要配置,确认是否能从相同来源覆盖升级,避免丢失订阅与路由设置。
安装后在“订阅设置”添加订阅地址,保存后回到主界面执行更新,再选择服务器并连接。首次连接会出现系统 VPN 授权;这表示应用建立本地流量接管接口,并不表示已经验证远端连接成功。若锁屏后连接中断,再检查系统电池优化与后台运行限制,只对确实需要的应用调整设置。
继续查看 Android 安装配置 →先区分发行版包格式,再核对 x64 或 arm64 架构。
Debian、Ubuntu 等使用 deb 包管理体系的系统选择 deb;使用 RPM 包管理体系的发行版选择 rpm,并确认发行版与依赖兼容。以下主入口为 x64;ARM 桌面设备使用下方 arm64 入口。图形客户端需要可用的桌面会话。
| 检查项 | 选择与要求 |
|---|---|
| 包管理体系 | deb 与 rpm 不能仅改扩展名互换。使用系统的软件安装器打开对应安装包。 |
| 运行依赖 | 发行版需要满足包声明的依赖、系统库与桌面运行环境要求;遇到依赖错误应先阅读安装器信息。 |
| 代理与权限 | 桌面系统代理是否被应用读取取决于应用本身;TUN 另涉及网络接口、路由与权限配置。 |
在系统信息页确认架构与发行版,下载后用图形软件安装器处理依赖。安装器报告系统库版本不足时,不要强制忽略依赖,也不要混装其他发行版的基础库。相同包格式只说明使用同类包管理体系,并不代表任意发行版都能运行同一个构建。
启动 v2rayN 后先导入订阅、选择服务器,确认内核运行与本地监听正常,再设置代理。浏览器、终端和桌面应用对代理的读取方式可能不同;某个程序未走代理时,先检查它自身的网络设置。需要让更多应用使用 TUN 时,按文档处理权限,避免长期以高权限运行整个桌面会话。
继续查看 Linux 安装配置 →三款客户端均用于管理代理配置,安装包本身不等于连接服务。先准备有权使用的订阅地址、单条分享链接或完整配置文件,区分它们的导入入口。订阅地址通常需要填入订阅设置,分享链接可通过剪贴板或扫描导入,完整 JSON 则应使用对应的配置导入方式。格式放错位置时,反复下载客户端通常不会解决问题。
订阅链接可能包含访问凭据。排错时优先描述错误类型、菜单路径与日志关键行,不要把完整地址发到公开讨论区。导入后先执行更新;如果列表为空,检查订阅地址是否完整、分组是否被过滤,以及客户端是否能访问订阅服务。
在列表中选中实际要使用的服务器,查看日志是否出现配置解析或端口占用错误。桌面端通常先配置系统代理,Android 则确认连接及 VPN 授权。系统代理是让遵循系统设置的应用使用本地代理;TUN 是另一种流量接管方式,两者不应在尚未理解用途时同时反复切换。
验证时既要确认目标应用能够连接,也要检查局域网访问、域名解析和路由是否符合预期。规则可能将部分请求送往直连出站,这不一定是异常。需要细分流量时再配置路由规则,并先备份当前可用设置;不要把规则问题误判成安装包问题。
退出客户端后再替换或覆盖安装,避免文件仍被占用。升级前备份订阅分组、路由规则和自定义设置,尤其注意跨界面版本、跨安装来源或跨设备迁移。安卓遇到签名冲突时,先确认旧应用来源与数据导出方式;卸载可能同时删除本地配置。
客户端界面版本与内核版本是不同概念。Xray 与 V2Fly 同属 Project V 相关生态,但具体协议、传输和配置字段并非始终一致。仅因界面名称相近,就直接复用所有高级字段,可能造成启动失败。下载时选对平台,配置时再按协议能力选择,详细差异可查阅概念速查。
DOWNLOAD / FAQ
先确认安装包类型,再定位系统权限、配置导入或代理接管问题。