v2rayN
Windows x64 图形客户端,提供桌面版与经典 WPF 版两个界面分支。
// PLATFORM SELECTOR
四个平台分别列出适用客户端、主要安装包、备选架构和基础系统要求。切换平台时,页面地址会同步对应锚点。
// WINDOWS PACKAGES
桌面版采用新一代跨平台 UI,适合首次安装和希望统一桌面体验的用户;经典 WPF 版延续传统 Windows 界面与操作布局,适合已有使用习惯的环境。两种入口都属于 v2rayN,选择差异主要在图形界面技术与交互布局。
Windows x64 图形客户端,提供桌面版与经典 WPF 版两个界面分支。
| 检查项 | 建议 |
|---|---|
| 处理器架构 | 本页 Windows 安装包面向 x64 系统。可在“系统信息”的系统类型字段中确认。 |
| 安装权限 | 安装程序需要写入应用目录。受管理设备出现权限提示时,应按本机管理策略处理。 |
| 首次启动 | 启动后先导入订阅或单条配置,更新订阅分组,再选择配置并启动内核。 |
| 系统代理 | 客户端启动不等于系统流量已经接入。需要根据使用方式开启系统代理或配置应用代理。 |
// MACOS PACKAGES
macOS 安装包按处理器架构拆分。Apple M 系列芯片选择 Apple Silicon arm64 版本,Intel 处理器选择 x64 版本。架构必须匹配;仅凭设备外观或购买年份判断容易出错,下载前应打开系统信息核对芯片字段。
macOS 桌面图形客户端,分别提供 Apple Silicon 与 Intel 安装包。
| 检查项 | 建议 |
|---|---|
| 芯片类型 | 从系统信息查看芯片或处理器名称。M 系列对应 arm64,Intel 处理器对应 x64。 |
| 安装文件 | 下载完成后打开 dmg,将应用按系统提示放入应用程序目录。 |
| 首次打开 | 根据系统安全提示确认应用来源与打开操作,不要反复下载不同架构的文件尝试覆盖。 |
| 代理权限 | 开启系统代理或相关网络能力时,系统可能要求确认权限。设置完成后再检查客户端状态。 |
// ANDROID PACKAGES
一般使用场景先选择采用 Xray 内核的 v2rayNG。明确需要 v2fly 内核、已有配置按 v2fly 行为维护,或需要对应兼容路径时,再使用 v2flyNG。两款客户端都提供 arm64 与通用版,2015 年后的主流手机通常先选 arm64。
采用 Xray 内核的 Android 图形客户端,适合作为常规首选。
采用 v2fly 内核的 Android 图形客户端,适合明确的内核兼容需求。
| 检查项 | 建议 |
|---|---|
| 架构版本 | 主流手机优先尝试 arm64。只有架构不明或提示不兼容时,才改用通用版。 |
| 客户端选择 | 常规场景先用 v2rayNG;明确需要 v2fly 内核兼容路径时使用 v2flyNG。 |
| 安装权限 | 通过浏览器或文件管理器打开安装包时,系统可能要求确认该来源的安装权限。 |
| 首次连接 | 导入订阅后先更新分组并选择配置,再启动连接。仅添加订阅地址不会自动选中配置。 |
// LINUX PACKAGES
Linux 安装包先按发行版包管理体系选择 deb 或 rpm,再按设备处理器选择 x64 或 arm64。Debian、Ubuntu 及其衍生发行版通常使用 deb;Fedora、RHEL 系及采用 rpm 包管理体系的发行版通常使用 rpm。
Linux 桌面图形客户端,提供 deb、rpm 及两种处理器架构安装包。
设备命令返回 aarch64 或 arm64 时,选择以下架构版本。包格式仍需与发行版匹配。
| 检查项 | 建议 |
|---|---|
| 包格式 | 使用 apt、dpkg 体系通常选择 deb;使用 dnf、yum、rpm 体系通常选择 rpm。 |
| 处理器架构 | x86_64 或 amd64 选择 x64;aarch64 或 arm64 选择 arm64。 |
| 桌面环境 | v2rayN 是图形客户端,应在具备可用桌面会话的环境中安装和运行。 |
| 系统代理 | 不同桌面环境的系统代理入口可能不同。启动客户端后还需确认桌面环境是否读取对应代理设置。 |
// AFTER DOWNLOAD
客户端安装完成只是准备阶段。真正开始使用前,还要导入配置、选择运行项、确定代理范围,并检查连接状态。
STEP 01
使用与系统和架构匹配的安装包完成安装。首次启动后先确认客户端主界面能够正常打开,不要急于同时修改端口、DNS、路由和系统代理。一次只处理一个环节,出现问题时更容易定位。
STEP 02
在订阅分组中添加有效地址并执行更新,或导入单条 vmess、vless、trojan 等配置。导入后检查协议、服务器地址、端口与传输设置是否被正确识别,再选择需要运行的配置。
STEP 03
启动内核后,根据用途选择系统代理、应用内代理或路由分流。直连、代理与拦截规则会影响最终访问路径;首次配置可先使用客户端提供的常规路由模式,确认连接后再添加自定义规则。
// SUBSCRIPTION
添加订阅地址后,还需要执行更新、打开对应分组并选中一条配置。订阅更新失败时,先核对地址是否完整、设备时间是否准确,以及当前网络能否访问订阅来源。不要在同一次排查中连续更换客户端、端口和协议,否则难以判断真正的故障点。
查看订阅导入教程// ROUTING
系统代理决定应用是否把请求交给客户端,本地路由规则决定客户端接到请求后采用直连、代理还是拦截。客户端显示已启动但浏览器仍无法连接时,应分别检查配置是否选中、本地监听端口、系统代理状态和路由模式,而不是只观察一个开关。
阅读协议与内核参考// UPDATE PATH
跨较大版本更新时,建议先记录订阅分组、本地监听端口、路由模式、DNS 选项和自定义规则。安装新版后逐项确认这些设置是否仍符合当前用途。若只是排查连接问题,优先查看客户端日志与错误提示,不要把升级作为唯一处理手段。
查看故障排查问题// PACKAGE NOTES
桌面平台对应 v2rayN,Android 常规首选 v2rayNG,明确需要 v2fly 内核时再选择 v2flyNG。先确定客户端型号,再在同一张卡内选择架构和安装包格式,可以避免下载到名称相似但用途不同的文件。
x64、x86_64 与 amd64 通常指向同一类桌面处理器架构;arm64 与 aarch64 通常对应同一类 64 位 ARM 架构。安装包文件名和系统信息的写法不一定完全相同,应根据架构含义对应,而不是只寻找一模一样的字符串。
Android 通用版包含更广的架构支持,适合无法确认设备信息或专用架构包无法安装的情况。已经确认设备采用 arm64 时,优先使用 arm64 包即可。通用版不是功能增强版,两者主要差异在打包的处理器架构范围。
客户端能够打开,只能说明程序安装环节基本完成。后续还要检查订阅、协议参数、运行配置、系统代理和路由规则。若提示端口占用,应定位占用进程或修改本地监听端口,并同步调整依赖该端口的应用代理设置。
// DOWNLOAD FAQ
下面的问题集中处理版本、架构、包格式和首次启动。订阅更新、路由分流与连接错误的进一步处理可进入常见问题页。
首次安装可先选择桌面版,它采用新一代跨平台 UI。已经熟悉经典 Windows 界面,或现有维护流程依赖 WPF 版菜单布局时,可以继续选择经典 WPF 版。两者都是 v2rayN,核心用途基本一致,不需要同时安装并运行。
打开系统信息并查看芯片或处理器字段。显示 Apple M 系列芯片时选择 Apple Silicon arm64 安装包;显示 Intel 处理器时选择 Intel x64 安装包。不要仅按设备名称判断,因为相近外观的机型可能采用不同处理器。
2015 年后的主流 Android 手机通常优先选择 arm64 版本。它只包含对应架构资源,文件更集中。无法确认设备架构,或者 arm64 包提示不兼容时,再下载通用版。两种安装包的主要功能一致,差异在支持的处理器架构范围。
一般 Android 使用场景优先选择采用 Xray 内核的 v2rayNG。明确需要 v2fly 内核、已有配置按 v2fly 行为维护,或服务说明指定对应内核时,再选择 v2flyNG。导入配置前仍需确认协议与传输参数是否兼容。
Debian、Ubuntu 及其衍生发行版通常选择 deb;Fedora、RHEL 系及采用 rpm 包管理体系的发行版选择 rpm。确定包格式后,还要检查系统是 x86_64 还是 arm64。两个判断都正确,安装包才与当前环境匹配。
安装包只提供客户端程序。首次启动后还需要导入有效配置或订阅、更新订阅分组、选择具体配置并启动内核。若希望浏览器或其他应用接入,还要根据使用方式开启系统代理,或把应用代理地址指向客户端的本地监听端口。