客户端安装清单
先选操作系统，再选安装包。
桌面使用 v2rayN，安卓优先选择 v2rayNG。
客户端永久免费、代码开源。安装完成后，导入有效订阅，再设置代理模式。
两个入口均为 x64。先区分界面版本，再下载并解压安装。
使用新一代跨平台 UI，基于 Avalonia 界面框架。首次安装，或希望在不同桌面系统间使用相近界面的用户，可先从这个版本开始。
zip 压缩包 · 解压后运行安装程序
采用面向 Windows 的 WPF 界面，是经典稳定版。已经熟悉原有窗口布局、菜单与托盘操作的用户，可按原有使用习惯选择。
zip 压缩包 · Windows 专用界面
把下载的 zip 文件完整解压到本地目录，再运行其中的安装程序。不要在压缩包预览窗口内直接启动。启动后打开「订阅分组设置」，添加订阅地址，保存后执行「更新全部订阅（不通过代理）」。若当前网络无法访问订阅地址，先确认地址与网络条件，再决定是否调整更新方式。
选中可用配置后，再设置「自动配置系统代理」。普通浏览器使用可先从系统代理开始，不必一安装就开启 Tun。切换 Desktop 与 WPF 版之前，先导出或备份配置；测试新版本时退出旧实例，避免两个程序同时修改系统代理或占用相同端口。
| 检查项 | 选择依据 | 操作提示 |
|---|---|---|
| 处理器架构 | 本页提供 x64 安装包 | 打开「设置 → 系统 → 系统信息」，查看系统类型。 |
| 系统与运行环境 | 需要发行包支持的 Windows 环境 | 旧系统先确认兼容性；若提示缺少运行环境，按安装程序说明处理。 |
| 权限与接管方式 | 普通代理与 Tun 权限需求不同 | 启用 Tun 涉及虚拟网卡，可能需要管理员权限；普通启动不必预先提升权限。 |
本页不把单一最低系统版本套用到所有发行包。以当前包的安装提示为准；遇到启动失败，先记录提示内容，再到疑难解答按现象定位。
打开「关于本机」，按芯片名称选择 Apple Silicon 或 Intel。
「关于本机」显示 Apple M 系列芯片时选择此包。优先使用与处理器匹配的架构，减少依赖转译环境带来的差异。
dmg 磁盘映像 · arm64
打开 dmg 后，按映像中的提示把应用放入「应用程序」目录，再从该目录启动。首次打开若出现系统安全提示，先核对文件来源与提示原因，通过系统提供的确认流程处理；不要为启动应用而整体关闭系统防护。
完成订阅导入后，先用一个配置测试系统代理。系统代理主要影响遵循该设置的应用，不等于所有程序的流量都已接管。需要进一步使用 Tun 时，再查看权限、虚拟网卡与路由相关说明。更新应用前先退出旧进程，保留配置备份，不要把卸载应用与删除配置混为一步。
| 检查项 | 选择依据 | 操作提示 |
|---|---|---|
| 芯片 | Apple Silicon 对应 arm64；Intel 对应 x64 | 从苹果菜单打开「关于本机」，读取芯片或处理器字段。 |
| 系统版本 | 需要当前桌面发行包支持的 macOS | 系统较旧时先确认兼容性，不以芯片匹配代替系统版本检查。 |
| 应用与网络权限 | 按实际功能授予权限 | 普通代理测试通过后，再按需要配置 Tun 与相关权限。 |
切换芯片架构并不等于同步配置。迁移设备时，另行导出订阅分组与自定义规则，导入后复查本地路径、监听地址和代理模式。
先选 v2rayNG。2015 年后的主流手机通常选择 arm64，不能确认时查看设备架构。
下载 apk 后，按系统提示仅为当前使用的浏览器或文件管理器开放安装权限。启动 v2rayNG，进入「订阅分组设置」添加地址，返回后执行「更新订阅」。选中配置并点击连接按钮，在系统弹出的 VPN 连接请求中确认授权，再测试应用访问。
手机通常不能让多个 VPN 服务同时工作。连接失败时，先检查是否有其他 VPN 服务占用，再查看日志；若锁屏后经常断开，再检查系统电池管理与后台运行限制。不要把后台限制、订阅失效和配置不兼容都归为安装包问题。
v2rayNG 与 v2flyNG 都是图形客户端，但内核家族不同，配置能力不能完全等同。不要只因界面接近就假定所有分享链接都能互换。导入后若出现不支持的字段，先检查协议、传输与安全设置；涉及 REALITY 等配置时，应确认所选内核具备相应支持。
两个应用的配置与系统权限分别管理。试用备选客户端时，先停止原来的连接，再在新客户端导入并测试。订阅地址可能包含访问凭据，备份、截图和分享时应妥善处理，不要把完整地址公开到反馈内容中。
| 检查项 | 选择依据 | 操作提示 |
|---|---|---|
| 应用架构 | 优先 arm64；不确定时考虑通用版 | 以设备支持的应用架构为准，不只看处理器名称。 |
| 系统版本 | 需要满足所选 apk 的安装要求 | 系统提示不兼容时，先区分系统版本与架构原因。 |
| 安装与连接权限 | 需要安装授权及 VPN 授权 | 安装权限按来源单独设置；首次连接按提示确认 VPN 请求。 |
| 后台运行 | 持续连接受系统电池策略影响 | 按实际需要调整后台限制，并留意耗电变化。 |
若覆盖安装提示签名冲突，先备份现有配置并查明来源差异，不要直接卸载后才寻找备份。更换客户端也不能修复已过期或不可访问的订阅地址。
先确认发行版包格式，再区分 x64 与 arm64。这里提供图形桌面客户端。
适用于采用 deb 包管理、且满足依赖要求的桌面系统，例如 Debian、Ubuntu 系发行版。amd64 与这里的 x64 是同类架构标识。
arm64 设备：下载 deb · arm64 →适用于采用 rpm 包管理、且与该发行包依赖兼容的系统。包格式相同不代表所有发行版都可直接安装，应先查看包管理器提示。
arm64 设备：下载 rpm · arm64 →在文件管理器中打开对应安装包，用发行版提供的软件安装器完成安装。遇到依赖缺失时，先查看具体缺少的组件和发行版兼容情况，不要强制跳过依赖。arm64 设备选择对应的小字入口；x86_64 与 aarch64 分别对应 x64 与 arm64，不能互换使用。
启动图形界面后，先导入订阅并检查路由，再选择代理模式。不同桌面环境对系统代理设置的响应可能不同，某个应用没有走代理时，先检查它是否读取桌面系统代理。Tun 涉及网络设备与权限配置，应在普通连接可用后单独测试，不要把整个桌面客户端长期以高权限运行作为通用解决办法。
| 检查项 | 选择依据 | 操作提示 |
|---|---|---|
| 处理器架构 | x64 或 arm64 | 查看系统信息中的架构字段，按设备选择对应包。 |
| 包管理格式 | deb 或 rpm | 遵循当前发行版的软件包格式，并确认依赖版本可满足。 |
| 图形环境 | 需要可用的桌面会话及相关组件 | 这不是面向纯命令行服务器的安装入口。 |
| 代理接管 | 受桌面环境、应用与权限影响 | 分别验证系统代理与 Tun，不把两种模式视为同一设置。 |
升级前退出客户端并保存配置。若包管理器拒绝安装，记录发行版版本、架构与依赖提示，再到系统教程对照排查，不要反复覆盖配置目录。
安装后的配置顺序
下载完成只是起点。把配置、接管方式与访问结果分开检查，遇到问题更容易找到对应环节。
添加订阅地址不会自动代表已取得配置。保存后执行更新，查看分组中是否出现条目，再选择要使用的配置。若订阅返回空内容，先确认地址有效期、当前网络与订阅格式，不要通过重装客户端处理地址失效。
分享链接与订阅地址用途不同：单条分享通常导入一个配置，订阅用于批量获取并更新配置。更新可能覆盖分组内由订阅生成的条目，自定义修改前先了解保存位置与覆盖范围。
按使用指南完成订阅导入 →桌面先测试系统代理，安卓先确认 VPN 服务已启动。检查一个常用应用是否按预期访问，再调整路由与 DNS。系统代理只影响遵循该设置的程序；需要更广的流量接管范围时，再阅读 Tun 说明。
测试时一次只改一项。记录连接前后的现象，区分域名解析失败、连接超时与配置字段错误。关闭连接后也检查系统代理是否恢复，避免把残留代理设置误认为设备网络故障。
查看路由、DNS 与 Tun 的配置顺序 →首次安装可先选 v2rayN 桌面版，它使用新一代跨平台界面。已经习惯 Windows 原有菜单与操作路径的用户，可选经典稳定的 WPF 版。两个入口都是 x64 包，切换前先备份配置，分别完成安装与连接测试，不要让两个实例同时接管系统代理。
2015 年后的主流手机通常先选 arm64，但仍应以设备实际支持的应用架构为准。无法确认架构，或 arm64 包提示不兼容时，可尝试通用版。若仍不能安装，再检查系统版本、剩余空间和已有应用签名，不要仅靠反复更换包解决问题。
安装包提供客户端，不附带可直接使用的服务器配置。先导入有效订阅或分享链接，更新订阅并选中配置，再设置系统代理或确认 Android VPN 授权。检查订阅有效期、设备时间和连接日志，按日志提示逐项处理。
先使用客户端提供的备份或导出功能保存配置，记录订阅分组、路由规则、DNS 与代理模式。退出正在运行的客户端，再安装对应系统与架构的包。更新后先测试一个配置，再逐项恢复自定义设置；不要直接删除原有配置目录。
先在浏览器下载记录中查看是否被暂停、拦截或保存到其他位置。确认网络和磁盘空间后重新下载，并检查所选文件是否匹配当前系统与架构。Windows 的 zip 包需先解压，macOS 使用 dmg，Android 使用 apk，Linux 则按发行版选 deb 或 rpm。不要通过关闭系统防护来绕过未知风险提示。