v2rayN 桌面端 · v2rayNG 与 v2flyNG 安卓端
先选操作系统，再选处理器架构。下载入口按客户端分组，版本信息放在卡片内；安装后的订阅导入与路由设置见使用教程。
首次安装可先选桌面版。桌面版采用 Avalonia 跨平台界面，适合需要在不同桌面系统间保持操作习惯的用户；经典 WPF 版只面向 Windows，适合沿用原有窗口布局和操作流程。两者都是 v2rayN，界面版本与服务器协议是不同概念，不应仅凭界面名称判断某条分享链接能否导入。
这里提供的是 x64 安装包，适用于相应的 64 位系统。打开 Windows 设置中的“系统 → 系统信息”，查看系统类型和处理器信息，再决定是否使用本页入口。下载得到 ZIP 后，先完整解压到独立文件夹，再运行其中的安装程序。直接在压缩包预览里双击可能造成附带文件未展开，后续启动失败时也不易定位原因。
安装后先启动客户端并导入配置，再启用系统代理。系统代理主要影响遵循系统代理设置的应用，并不等同于接管全部网络流量。初次排查连接问题时，保持 TUN 关闭，先验证普通代理链路。确有需要再按教程启用 TUN，并阅读权限提示，避免把界面选择、驱动权限与服务器配置问题混在一起处理。
| 检查项 | 本页安装包要求 | 确认方式 |
|---|---|---|
| 处理器架构 | x64；本页两个入口均为 x64 包 | 系统信息中的系统类型 |
| 系统与运行环境 | 建议使用仍获支持的 Windows 10 / 11；实际最低要求以所选发行版说明为准 | 安装器提示与客户端发行说明 |
| 文件与权限 | 完整解压；安装位置应可访问；启用 TUN 时另行处理提升权限请求 | 先以普通用户启动主界面 |
若安装器提示缺少运行环境，先记录提示里的准确组件名称和架构。不要把所有启动异常都归因于服务器，也不要通过随意复制其他软件目录里的文件来修补。更换桌面版与 WPF 版之前，先备份配置，退出原程序；验证新界面能读取设置后再决定是否保留旧版。
打开系统菜单中的“关于本机”查看芯片信息。显示 Apple M 系列芯片时选 Apple Silicon 版；显示 Intel 处理器时选 Intel 版。两种包的功能定位相同，区别主要是处理器架构。不要依据电脑外观、购买年份或屏幕尺寸选择，准确的芯片名称比这些线索更可靠。
下载完成后打开 DMG，将 v2rayN 拖到“应用程序”目录，再从该目录启动。磁盘映像是安装载体，不宜长期作为运行位置。应用复制完成后可推出磁盘映像；以后更新时先退出正在运行的客户端，再替换应用，避免系统提示文件正在使用或旧进程继续接管代理。
如果系统阻止首次打开，先区分提示是架构不符、系统版本不满足，还是安全机制要求确认。对明确的安全确认，可阅读系统设置中“隐私与安全性”的对应信息后处理具体应用。不要为启动一个客户端而关闭系统整体安全保护，也不要对来源和作用不清楚的命令进行批量授权。
| 检查项 | 选择依据 | 安装注意 |
|---|---|---|
| 芯片 | Apple Silicon 对应 arm64；Intel 对应 x64 | 从“关于本机”读取芯片或处理器名称 |
| 系统环境 | 具有桌面图形环境的 macOS；最低系统版本随发行版变化 | 出现系统版本提示时按发行说明确认 |
| 代理权限 | 系统代理与 TUN 的权限范围不同 | 先导入配置，再按需要开启相应模式 |
安装成功不代表系统代理已启用。首次运行后选择已导入的服务器，再检查客户端中的代理开关与系统网络设置是否一致。需要测试应用访问时，先确认该应用是否遵循系统代理；如果应用自行指定了代理地址，应同时检查地址和端口，不要仅凭浏览器能访问就判断所有应用都已接管。
v2rayNG 是 Android 图形客户端，本页以 Xray 内核版本作为安卓首选。2015 年后的主流手机通常可先选 arm64，但部分设备虽然处理器支持 64 位，系统仍采用不同的应用运行环境。无法确认时选通用版，并以系统安装器的兼容性提示为准。通用版和 arm64 版是架构选择，不是功能等级。
打开下载的 APK 时，Android 可能要求允许当前浏览器或文件管理器安装应用。仅为正在使用的来源开启安装权限，安装结束后可在系统设置中重新关闭。首次启动并开启连接时会出现 VPN 授权，这是客户端接管流量所需的系统流程。授权前先确认请求来自刚安装的客户端；通常无需取得设备的特殊管理权限。
导入订阅后需要执行更新，单纯添加地址不一定立即生成服务器列表。连接建立后，如果锁屏或切换应用导致服务停止，再检查电池优化、后台活动与厂商的自启动限制。调整时只针对正在使用的客户端，不必将所有应用设为常驻；持续连接的资源消耗也应结合实际使用需求决定。
v2flyNG 适合需要 V2Fly 内核行为或已有相关配置的用户。选择备选客户端时，应先确认所用协议与传输设置是否兼容，不应把切换客户端当成所有连接错误的通用解决方案。V2Fly 与 Xray 属于相关的技术生态，但各自的功能演进不同，具体字段与协议支持仍须结合客户端所带内核判断。
从 v2rayNG 转用 v2flyNG 时，先保留原有订阅信息与手动配置，再在新客户端中重新导入。不要假定两个应用会自动共享私有数据。测试前先停止原客户端的 VPN 服务，同一时刻让一个客户端接管连接，便于确定当前生效的配置，也能减少系统 VPN 授权被来回替换造成的混淆。
| 检查项 | 选择依据 | 注意事项 |
|---|---|---|
| 应用架构 | arm64 或通用版 | 主流新设备优先 arm64；不确定时使用通用版 |
| 系统兼容性 | Android 版本须满足当前 APK 要求 | 最低版本以发行说明和安装器提示为准 |
| 必要授权 | 安装来源权限与 VPN 服务授权 | 后台限制在连接后单独检查 |
遇到“应用未安装”时，依次检查剩余存储空间、架构兼容性和是否存在不同签名的已安装版本。先备份再处理已有应用，不要直接卸载后才查找原配置。订阅链接往往带有个人访问参数，截图、问题反馈和共享剪贴板时均应隐藏这些内容。
Linux 选择安装包需要同时确认发行版的软件包格式和处理器架构。Debian、Ubuntu 系通常使用 deb；Fedora 等发行版使用 rpm。普通 Intel 或 AMD 64 位电脑选 x64；运行 arm64 系统的设备选对应 arm64 包。包格式相同不代表任意发行版版本都可安装，运行库与包依赖仍应由本机软件管理器检查。
下载后可使用系统的图形软件安装器打开软件包，阅读依赖与安装位置提示，再确认安装。若管理器报告依赖不满足，先核对当前发行版版本及软件源状态，不要直接强制忽略依赖。安装完成后从应用菜单启动 v2rayN；这是桌面图形客户端，应在可用的桌面会话中运行，而不是把普通启动流程等同于后台服务部署。
Linux 桌面环境对系统代理的处理并不完全一致。启用客户端系统代理后，仍要检查目标应用是否采用桌面代理设置。浏览器、自带代理设置的应用和命令行程序可能使用不同来源的配置。首次连接先验证一个明确遵循代理的应用，随后再处理其他程序，能更快判断问题位于订阅、出口配置还是应用自身。
| 检查项 | 安装包选择 | 确认方式 |
|---|---|---|
| 包管理体系 | deb 或 rpm | 发行版的软件中心与包管理器 |
| 处理器架构 | x64 或 arm64 | 系统信息；amd64 / x86_64 对应 x64，aarch64 对应 arm64 |
| 运行环境 | 桌面图形会话及包所需的运行库 | 安装器的依赖检查；具体系统要求随发行版而变化 |
| TUN 权限 | 按客户端与系统要求单独授权 | 先验证普通代理，再处理 TUN 模式 |
需要开机后自动启动时，优先区分“桌面登录后启动”和“系统启动时运行”。普通桌面使用应先配置前者，并确认启动时配置文件路径可读。不要为了启用 TUN 而让整个图形界面长期以提升权限运行。完整安装和自启动设置可继续阅读Linux 安装配置章节。
先确定当前设备的操作系统，再确认处理器架构，最后选界面版本或包格式。这三项各自解决不同问题：操作系统决定客户端入口，架构决定程序能否运行，界面版本影响操作方式。文件名里的 x64、amd64、arm64 不是服务器所在地，也不决定可用协议。按这个顺序选择，通常不需要把所有安装包逐个尝试。
本页客户端都可免费使用，客户端本身与服务器服务是两件事。安装包包含运行客户端所需的软件，不包含个人订阅或可直接使用的服务器配置。准备有使用授权的分享链接或订阅地址，了解其有效期和支持协议，再进入连接步骤。订阅服务的可用性、费用与维护方式由对应提供方决定，不能从客户端版本号推断。
下载入口会读取同源版本清单，更新卡片内版本信息与对应文件地址。页面中的静态入口用于保留可点击的安装包路径；浏览器脚本不可用时，仍可使用这些入口。不同客户端独立发布版本，数字大小不代表功能强弱，也不能跨客户端直接比较。升级选择应结合系统兼容性、具体修复内容和已有配置需求。
安装包是程序分发文件，订阅分组、服务器条目和自定义路由属于个人配置。更新程序之前先使用客户端提供的导出或备份功能，不要只保留下载目录中的 ZIP、DMG 或 APK。切换客户端时，优先采用分享链接或重新添加订阅的方式迁移，并逐项核对自定义字段，避免把一个客户端的全部设置目录直接交给另一个客户端读取。
备份文件中可能保存服务器密码或订阅访问参数，应放在个人可访问的位置。准备问题反馈时，保留报错类型、操作系统、应用架构和触发步骤即可；配置截图中的地址、账户信息与访问参数应先隐藏。这样既能提供排查所需的信息，也能减少凭据随截图或日志扩散的风险。
单条分享链接用于添加一个服务器配置，订阅地址用于获取和更新一组配置。复制有效分享链接后，在客户端中使用从剪贴板导入的入口；使用订阅时先添加订阅分组，填入地址，再执行更新。不要把网页介绍页当作订阅地址，也不要把订阅地址粘贴到只接受单条分享链接的输入框。更新成功后检查列表是否出现，并选择需要使用的条目。
桌面端先使用系统代理验证基础连接，Android 端通过系统 VPN 授权启动服务。路由预设决定不同请求匹配哪个出口，系统代理与 TUN 决定哪些应用流量进入客户端，两者不能互相替代。尚未理解规则前，先沿用一个明确的预设，不要同时更改 DNS、路由、传输设置和内核选项，否则很难判断哪项调整改变了结果。
确认客户端服务已启动后，再用实际需要访问的应用验证。界面中的连接状态只说明本地服务状态，不等于远端请求一定成功。若某个应用可用而另一个不可用，先检查应用的代理设置和路由命中，不必马上重新下载。若所有应用都失败，按订阅是否过期、服务器信息是否完整、系统时间是否正确的顺序检查，再阅读具体错误日志。
关闭客户端前先停止连接或恢复系统代理，尤其是在切换两种桌面界面或测试多个安卓客户端时。遗留的代理地址可能使浏览器继续向已退出的本地服务发送请求，表现为普通网页也打不开。遇到这种情况，先核对系统代理状态，而不是反复安装。操作截图与分步说明见v2rayN 与 v2rayNG 使用教程；权限、平台差异和路由细节见全平台安装配置大全。
不需要。首次使用可选 v2rayN 桌面版，习惯经典 Windows 界面的用户可选 WPF 版。两种界面不应同时接管系统代理。切换前先退出原客户端，并备份订阅分组与自定义路由设置。
2015 年后的主流手机通常优先选 arm64，但处理器支持 64 位不代表系统一定提供 64 位应用环境。无法确认架构时可选通用版；安装器提示不兼容时，检查系统版本与应用架构，不要反复安装同一文件。
先确认 Apple Silicon 与 Intel 安装包是否选对，并将应用从磁盘映像拖到应用程序目录。若系统阻止运行，阅读提示后在系统设置的隐私与安全性中确认具体应用的打开操作。不要关闭系统整体安全保护。
客户端本身不提供服务器或订阅服务。需要准备有使用授权的分享链接、订阅地址或服务器配置，导入后选择可用配置，再开启系统代理或 Android VPN 服务。订阅地址可能包含访问凭据，不应公开分享。
保留订阅分组、手动添加的服务器、自定义路由规则和需要沿用的客户端设置。使用客户端提供的导出或备份功能，将备份放在个人可访问的位置。先退出客户端再升级，升级后确认配置仍在，重新检查代理模式与权限。