v2rayN
Desktop:新一代跨平台 UI。适合首次安装,或希望在不同桌面系统中使用相近界面的用户。界面组织与经典版可能不同,查找订阅、路由和系统代理设置时,应以当前界面中的菜单名称为准。
WPF:经典稳定版。采用传统 Windows 桌面界面,适合已经熟悉经典操作布局、希望延续现有使用习惯的用户。两版的选择重点在界面与运行环境,不代表同一条配置会因为界面不同而获得更好的线路质量。
CLIENT PACKAGES / 系统与架构
桌面选择 v2rayN,Android 首选 v2rayNG。先确认操作系统,再选择芯片架构与安装包格式。
三款客户端均可免费使用、代码开源。本站提供入口整理与配置说明,客户端发布与开发由各自项目维护。
以下两个入口均为 x64 安装包。先在「设置 → 系统 → 系统信息」确认系统类型。
Desktop:新一代跨平台 UI。适合首次安装,或希望在不同桌面系统中使用相近界面的用户。界面组织与经典版可能不同,查找订阅、路由和系统代理设置时,应以当前界面中的菜单名称为准。
WPF:经典稳定版。采用传统 Windows 桌面界面,适合已经熟悉经典操作布局、希望延续现有使用习惯的用户。两版的选择重点在界面与运行环境,不代表同一条配置会因为界面不同而获得更好的线路质量。
| 检查项 | 要求与处理 |
|---|---|
| 系统与架构 | 面向现代 64 位 Windows;本页入口为 x64,不适用于 32 位系统。 |
| 运行环境 | 具体系统最低版本与运行组件以所选构建的安装提示为准,不以文件名判断兼容性。 |
| 权限 | 普通系统代理与 TUN 的权限需求不同;启用 TUN 时可能需要管理员授权。 |
下载得到 ZIP 文件后,先将压缩包完整解压到个人可写目录,再运行其中的安装程序。不要直接在压缩包浏览窗口中启动,也不要把新旧版本的文件混合复制到同一目录。安装结束后启动 v2rayN,确认主界面能够正常打开,再进入订阅管理。
如果电脑已经运行其他代理程序,先退出旧程序并检查系统代理状态。多个客户端同时修改代理端口,容易造成浏览器无法访问或退出后仍保留旧代理。首次使用先完成普通系统代理连接,确认可用之后再研究 TUN,可以减少排查变量。
已有配置的用户,应在切换 Desktop 与 WPF 之前导出或备份配置。不要默认两套程序会自动共享全部数据;先在新界面核对订阅分组、路由规则和监听端口,再决定是否移除旧安装。
打开苹果菜单中的「关于本机」,根据「芯片」或「处理器」字段选择安装包。
Apple Silicon 对应 arm64。「关于本机」显示 Apple M 系列芯片时,优先使用此入口。不要仅凭电脑购买年份或外观判断架构,同一系列机型可能存在不同处理器版本。
Intel 对应 x64。处理器字段显示 Intel 时选择此入口。原生架构包能减少额外的兼容层需求;安装时出现架构不匹配提示,应先重新确认芯片,而不是反复修改权限。
| 检查项 | 要求与处理 |
|---|---|
| 芯片架构 | Apple Silicon 选 arm64,Intel 选 x64;安装包应与设备原生架构对应。 |
| 系统兼容 | 使用所选构建支持的 macOS 版本;若系统提示版本过旧,先确认兼容要求。 |
| 授权范围 | 按系统提示授予网络相关权限;TUN 与普通系统代理的接入方式不同。 |
打开 DMG 后,将应用复制到「应用程序」目录,再从该目录启动。不要长期从已挂载的磁盘映像运行,否则更新、权限记录或磁盘映像卸载都可能影响后续使用。安装完成后可以推出磁盘映像,保留下载文件作为个人安装记录。
首次打开若遇到系统安全提示,先确认文件来源与所选架构,再根据「系统设置 → 隐私与安全性」中的具体提示处理。不要为了启动单个应用而全局关闭系统安全机制。若提示应用不兼容,优先查看系统版本要求,而不是把所有错误都归结为权限。
导入配置后,先检查应用是否成功启动服务,再设置系统代理。部分应用不读取系统代理,需要应用内单独指定代理,或在确认普通连接正常后评估 TUN。不同接入方式的范围说明见使用手册的代理模式章节。
优先选择 v2rayNG。仅在已有配置或内核兼容需求明确时,再评估 v2flyNG。
v2rayNG 使用 Xray 内核,提供订阅导入、路由设置与分应用代理等图形操作。2015 年后的主流手机通常先选 arm64,但部分设备仍采用 32 位系统,应以设备实际支持的应用架构为准。
通用版包含多种架构,适合暂时无法判断设备类型的情况。它与 arm64 版的区别主要在打包范围,不是代理模式或订阅类型的区别。安装后仍需导入自己的服务器配置,并完成系统连接授权。
v2flyNG 使用 v2fly 内核,可作为需要该内核配置兼容性的备选。界面相近不代表所有协议、传输选项与配置扩展都能互换;迁移前应核对订阅内容涉及的功能,不要仅根据文件后缀判断支持情况。
架构选择方式与上方一致:确认系统支持 64 位应用时选 arm64,不确定时可选通用版。两款客户端可以分别保存配置,但 Android 的 VPN 连接通常不能由它们同时占用,测试前先停止另一款客户端。
| 检查项 | 要求与处理 |
|---|---|
| 架构与系统 | arm64 包需要支持 64 位应用的系统;最低 Android 版本以安装器的兼容提示为准。 |
| 安装权限 | 按需允许当前浏览器或文件管理器安装应用,安装结束后可收回该来源的权限。 |
| 网络授权 | 启动连接时确认系统 VPN 授权;后台运行受省电与自启动策略影响。 |
下载 APK 后,从下载列表或文件管理器打开。若提示与现有应用冲突,先核对当前安装的是哪款客户端、使用了哪个发布渠道;不同签名的构建可能无法直接覆盖。不要急于卸载,先导出必要配置,避免丢失手工添加的服务器与规则。
首次启动连接会出现 Android 系统的 VPN 授权窗口。授权用于将设备流量接入本地客户端,并不意味着配置已经可用。授权后仍需检查服务器是否被选中、服务是否启动,以及订阅信息是否完整。后台断连时,再检查电池优化、自启动与后台联网限制。
分应用代理会改变哪些应用进入连接。排查时先确认测试浏览器是否在允许或排除名单中,再检查路由。若另一款 VPN 应用正在工作,应先断开原连接。具体操作参见使用文档,内核差异参见客户端选型笔记。
先确认发行版的包管理体系,再确认处理器架构。deb 与 rpm 不能只按文件大小选择。
deb 面向使用 Debian 包管理体系的发行版,rpm 面向使用 RPM 包管理体系的发行版。格式一致只是安装前提,仍需让包管理器检查库依赖与发行版兼容性。不要通过强行忽略依赖来解决安装错误。
x64 在 deb 文件名中通常写作 amd64,在 rpm 中常写作 x86_64;arm64 在 rpm 中常写作 aarch64。这些名称描述处理器架构,不是客户端功能等级。普通桌面电脑与 ARM 设备应分别选择对应构建。
| 检查项 | 要求与处理 |
|---|---|
| 桌面环境 | 需要可运行图形应用的桌面会话;本页提供图形客户端安装包。 |
| 包与依赖 | 按发行版选择 deb 或 rpm,依赖与基础库版本由系统包管理器判断。 |
| 架构与权限 | 按 x64 或 arm64 选择;TUN 可能需要额外的系统权限与路由设置。 |
在文件管理器中打开安装包,使用发行版的软件安装工具完成依赖检查。若桌面安装器报告缺少组件,应先处理依赖来源和系统兼容性,再重新安装;同一个 rpm 文件不能保证在所有采用 RPM 的发行版上直接运行。
首次启动后,先确认客户端服务可正常运行,再配置桌面系统代理。不同桌面环境、浏览器与应用读取代理设置的方式可能不同;能打开客户端窗口,不代表所有应用都已经接入。优先用一个明确遵循系统代理的应用测试,再扩展到其他程序。
启用 TUN 会涉及虚拟网络接口、路由与 DNS。先记录原有网络配置,确认普通代理已经可用,再按手册逐项设置。权限不足时应针对具体功能处理,不要把整个桌面会话长期作为高权限环境运行。
AFTER INSTALL / 配置接续
安装包解决程序部署,订阅、接入方式与路由决定实际连接。按顺序操作,比一次修改多个设置更容易定位问题。
准备有权使用的订阅地址或服务器参数,在客户端的订阅管理中添加分组并执行更新。确认列表出现配置后,选中一个服务器,再启动服务。订阅地址可能包含访问凭据,不要把完整地址贴到公开截图或问题反馈中。
随后选择系统代理或 Android 的 VPN 接入方式,用明确的目标应用测试。服务未启动、应用未接入与远端不可达是不同层面的问题,应分别检查。全局与绕过模式负责路由选择,不能代替启动服务或系统授权。
按步骤完成首次连接 →更新前保存订阅分组、自定义路由与 DNS 设置,记录监听端口及 TUN 状态。退出旧进程后再安装,避免程序文件被占用。新版本启动后,先核对数据目录与配置是否正确读取,不要马上重建全部订阅。
版本文字与包文件名用于识别发布信息,选包仍应以系统、架构和构建类型为准。更新后出现问题时,先阅读日志并确认差异;恢复连接后再逐项启用进阶功能,保留一组可用配置作为排查基线。
查看使用手册与维护步骤 →PACKAGE NOTES / 下载问答
需要。客户端负责读取配置、接入应用流量并调用内核;安装包不附带可用服务器或订阅。请准备有权使用的订阅地址或服务器参数,在客户端中导入后再选择代理模式。
首次使用可先选择 Desktop 桌面版,它采用新一代跨平台界面。熟悉传统 Windows 操作布局的用户可选择经典稳定的 WPF 版。两者都是 v2rayN,切换前应备份订阅分组与自定义规则,不要让两个实例同时接管系统代理。
2015 年后的主流手机通常先选 arm64,但仍需确认系统支持 64 位应用。不能确认架构或 arm64 安装提示不兼容时,可选择包含多种架构的通用版。通用版体积通常更大,并不代表连接效果更好。
先备份订阅分组、自定义服务器、路由规则和 DNS 设置,记录系统代理与 TUN 的启用状态。退出旧客户端后再安装更新;启动新版本时先确认配置读取正常,再恢复连接。备份中可能包含敏感连接信息,应保存在个人可控的位置。
先确认订阅已更新且已选择服务器,再检查系统时间、服务是否启动以及日志中的错误。桌面端核对系统代理或 TUN,Android 核对 VPN 授权与分应用设置。先测试一组已知可用配置,再逐项调整路由与 DNS,避免同时改动多个变量。