v2rayN
首推桌面版采用新一代跨平台 UI；WPF 是经典稳定版，适合延续既有操作习惯。两种入口均为压缩包，下载后先解压，再运行包内安装程序。
订阅分组系统代理路由设置
安装后的订阅导入步骤 →
V2Ray 下载
v2rayN 桌面版、v2rayNG 安卓版与 v2flyNG 备选。
先选系统，再选处理器架构。
安装包负责运行客户端；连接所需的订阅或服务配置需另行准备。首次安装先使用默认设置，完成导入与连接后，再调整路由和 DNS。
4 平台3 客户端Xray · v2fly 内核VMess / VLESS / Trojan / Shadowsocks
Windows 安装准备
| 项目 | 检查内容 |
|---|---|
| 系统架构 | 上述入口均为 x64，先在系统“关于”中确认系统类型。 |
| 系统兼容 | 需要客户端及其运行组件支持的 Windows 环境，以安装提示为准。 |
| 写入权限 | 安装位置及配置目录需可写，解压完整后再启动。 |
| 网络权限 | 系统代理通常无需提升权限；TUN 可能需要管理员授权。 |
下载压缩包后，不要在压缩软件预览窗口中直接启动程序。先把全部内容解压到可写目录，再打开安装程序。若系统提示缺少运行组件，应依据提示补齐相应组件，而不是从其他安装目录随意复制文件。
已有 v2rayN 配置时，先记录本地监听端口与系统代理状态。更新或切换界面前退出旧实例，避免两个客户端争用端口。安装完成后先确认订阅分组与选中的配置，再启用系统代理；浏览器若设置了独立代理，也要核对对应端口。
v2rayN
桌面推荐打开苹果菜单 → 关于本机。芯片显示 Apple M 系列时选 Apple Silicon；处理器显示 Intel 时选 x64。不要只按机身外观或购买年份判断。
DMG订阅管理系统代理
macOS 安装与权限说明 →
macOS 安装准备
| 项目 | 检查内容 |
|---|---|
| 芯片架构 | Apple Silicon 对应 arm64，Intel 对应 x64。 |
| 系统兼容 | 系统需满足当前应用的最低要求，以打开应用时的提示为准。 |
| 安装位置 | 打开 DMG，将应用复制至“应用程序”后运行。 |
| 权限确认 | 核对应用来源后，在系统设置中处理启动与网络相关授权。 |
首次打开如果出现开发者验证提示，先确认下载来源和所选架构，再到系统设置的“隐私与安全性”查看本次拦截记录。只针对当前应用执行允许操作，不需要为了安装一个客户端而全局关闭系统安全机制。
启动后，系统代理与 TUN 是不同的接管方式。先按教程导入订阅，使用系统代理完成基础连接。若应用提出网络相关授权，结合启用的功能判断用途。更改权限后可退出并重新启动客户端，再检查系统代理是否已正确写入，避免把权限问题误判为服务配置失效。
v2rayNG
首推2015 年后的主流手机通常优先选 arm64，最终以系统支持的应用架构为准。架构不明确时可选通用版；通用版不代表能绕过系统最低版本要求。
需要 Xray 配置能力时优先使用 v2rayNG。安装后可从主界面添加配置，订阅地址则放入“订阅分组设置”，保存后再执行更新订阅。导入与连接是两个操作，列表出现配置后仍需选择并启动。
v2rayNG 初次配置步骤 →v2flyNG
备选适合已有 v2fly 配置环境的用户。架构选择方法与 v2rayNG 相同，但内核能力与配置字段不能仅凭界面相似就视为完全一致。
从其他客户端迁移时，先确认服务端要求的协议与传输选项是否受支持。保留原始订阅地址或分享链接，使用新客户端的导入功能重新建立配置，不要直接覆盖两个应用的私有数据目录。
对照内核与客户端差异 →Android 安装准备
| 项目 | 检查内容 |
|---|---|
| 应用架构 | arm64 包适合支持 64 位应用的系统；不确定时选择通用版。 |
| 系统兼容 | 需符合所选客户端当前安装包的 Android 要求，以系统安装结果为准。 |
| 安装授权 | 按系统提示，为本次使用的浏览器或文件管理器开启安装应用权限。 |
| 连接授权 | VPN 模式首次启动时确认系统 VPN 请求；同一时刻避免运行其他 VPN 连接。 |
如果提示无法安装，先看完整错误信息。常见原因包括系统版本不符、架构不匹配、存储空间不足，或已有应用与新包的签名不同。不要一遇到错误就删除旧应用；卸载可能清除本地配置，应先导出可保留的数据，再判断是否确实需要重新安装。
安装来源权限与 VPN 授权互不替代。前者允许系统安装应用，后者允许客户端创建本地 VPN 接口。连接建立后若后台容易断开，再检查电池优化和后台运行限制。首次测试先保持默认路由，暂不启用 FakeDNS、Mux 或复杂分应用规则，以便缩小排查范围。
v2rayN
桌面推荐先按发行版选择 deb 或 rpm，再按处理器选择 x64 或 arm64。包格式、架构与系统库兼容性是三个独立条件，扩展名一致并不代表一定适合当前系统。
安装后的桌面代理设置 →Linux 安装准备
| 项目 | 检查内容 |
|---|---|
| 包格式 | Debian、Ubuntu 系通常使用 deb；Fedora、RHEL 系通常使用 rpm。 |
| 处理器架构 | amd64、x86_64 对应 x64；aarch64 通常对应 arm64。 |
| 桌面环境 | 需要可运行图形应用的桌面会话及安装包要求的依赖库。 |
| 操作权限 | 软件包安装需要相应授权；TUN 的网络权限另行确认。 |
优先使用发行版的软件包安装器打开文件，让系统显示依赖与兼容性结果。若安装器提示依赖版本无法满足，不要强行忽略依赖。先核对系统发行版、架构和软件源状态，再判断当前安装包是否适用；仅更改文件后缀无法转换包格式。
客户端启动后，桌面环境的系统代理不一定覆盖所有应用。浏览器、终端工具和独立网络应用可能各自使用不同的代理设置。先选定一种应用验证连接，再逐项扩大使用范围；如需 TUN，应单独理解权限与路由变化，退出后也要检查原有网络是否恢复。
安装后检查顺序
客户端、服务配置和网络接管分别检查。先验证基础连接，再添加个性化规则，可以避免一次改动过多设置后难以定位问题。
导入服务配置
单条分享链接可通过剪贴板导入；订阅地址应添加到订阅分组，再执行更新。不要把订阅网页的介绍页地址当成订阅接口，也不要把完整订阅地址粘贴到公开求助内容中。
更新后列表为空，先核对地址是否完整、网络能否访问，再临时清空关键词过滤。客户端下载成功并不意味着订阅接口一定可访问，这两条链路应分别判断。
订阅格式与导入入口 →选择接管方式
桌面端先用系统代理，Android 先用 VPN 模式完成初次验证。v2rayNG 的“仅代理模式”只开放本地代理入口，不会自动让所有应用使用该入口，适合明确知道应用代理如何配置的场景。
分应用代理会改变哪些应用经过连接。初次使用先保留简单范围，确认浏览器能正常访问，再逐个加入应用。不要同时启用多个负责网络接管的客户端。
模式选择与连接验证 →保留可回退设置
修改路由、DNS 或 TUN 前先备份。遇到异常时撤回最近一次改动，重新启动连接后复测。证书报错先检查系统时间和服务配置，不要直接关闭证书验证。
记录错误提示、客户端名称、系统架构和操作步骤即可帮助定位。日志中可能含有服务器地址或认证字段，分享前应删除敏感内容，备份文件也应单独妥善保存。
路由、DNS 与配置进阶 →安装包选择与故障边界
“无法安装”“无法启动”和“无法连接”应分开排查。无法安装先检查包格式、架构及系统要求；无法启动再看运行组件、应用权限和错误提示；能够打开但无法连接，则转向订阅有效性、所选配置、系统时间与代理模式。反复更换安装包通常不能解决服务端认证或路由规则问题。
下载中断时，先检查浏览器下载记录与本地剩余空间，再重新点击对应入口。文件保存完成后再交给安装器处理，不要把尚未完成的临时文件当作安装包。浏览器修改保存文件名不影响选择逻辑，但排查问题时应记录实际选择的客户端、平台和架构，避免混淆不同入口。
版本文字与实际文件名可能由清单分别维护，页面不据此推断升级路线。安装后查看客户端“关于”页面确认实际版本，并保留一份能够正常工作的配置。若出现新问题，先对照最近变更，而不是同时重置订阅、端口、DNS 和全部路由规则。
下载与安装常见问题
Android 应该选 arm64 还是通用版？
2015 年后的主流手机通常优先选择 arm64，但最终应以系统支持的应用架构为准。处理器支持 64 位不代表系统一定支持 64 位应用；架构不明确时可选择通用版，安装仍失败时检查系统兼容性与安装提示。
Windows 桌面版与经典 WPF 版有什么区别？
桌面版 Desktop 使用新一代跨平台 UI，经典 WPF 版采用 Windows 桌面界面。首次使用可先选桌面版；已有 WPF 使用习惯可继续选择经典稳定版。两者切换前先备份配置，不要让两个实例同时接管系统代理。
macOS 应该下载 Apple Silicon 还是 Intel 安装包？
打开苹果菜单中的“关于本机”，查看芯片或处理器一栏。显示 Apple M 系列芯片时选 Apple Silicon；显示 Intel 处理器时选 Intel。安装包架构应与本机硬件对应。
安装完成后为什么还不能连接？
安装包只提供客户端，不包含可用服务配置。需要导入有效订阅或分享链接，选择配置并启动连接。Android 需要确认 VPN 授权；桌面端需要按应用需求启用系统代理或设置应用代理。
更新客户端前需要保留哪些设置？
先使用客户端提供的备份或导出功能保存配置，并记录订阅分组、路由、DNS、分应用代理与本地监听端口。备份应保存在个人可控的位置，避免分享含有订阅地址和认证信息的配置文件。
页面版本文字与安装包文件名不同，以什么为准？
版本文字与安装包入口来自清单的不同字段，更新时可能暂时不同步。不要根据文件名手动改写下载地址。安装后在客户端“关于”页面确认实际版本；需要更新时重新打开本页选择对应平台入口。