v2rayN
首推 Windows · x64Desktop 是新一代跨平台 UI，WPF 是经典稳定版。首次安装可先选 Desktop；希望沿用经典界面与操作习惯，可选择 WPF。
客户端安装包 · 平台与架构
V2Ray 客户端下载
桌面选择 v2rayN，安卓优先选择 v2rayNG。先确认系统与处理器，再下载对应安装包。
VMess
VLESS
Trojan
Shadowsocks
客户端永久免费、代码开源。连接时使用的订阅或节点配置需另行准备，协议支持取决于所选内核与具体配置。
选择操作系统
点击平台查看对应客户端。安装说明与系统要求随平台一起切换，可保留当前页面地址方便下次访问。
Windows 系统与运行要求
| 检查项目 | 选择依据 | 安装前处理 |
|---|---|---|
| 系统与架构 | 当前入口为 Windows x64 包 | 在系统设置的“关于”页面确认系统类型；其他架构不要直接套用。 |
| 运行环境 | 依所选发行包要求准备 .NET 等依赖 | 缺少运行时会影响界面启动，与订阅是否有效是两类问题。 |
| 权限与网络 | 普通代理与 TUN 的权限要求不同 | 先完成基本连接；需要 TUN 时再按提示授予相应权限。 |
先把安装包保存到本地，再解压到可正常读写的目录。不要从压缩软件的预览窗口直接运行程序，否则相邻依赖文件可能没有一同释放。安装完成后正常启动客户端；如果出现缺少运行环境的提示，应先补齐提示指向的依赖，而不是反复导入订阅。
首次连接建议只启用一种流量接入方式。先导入配置并选中节点，再使用自动配置系统代理，检查浏览器是否遵循系统设置。此时不必同时开启 TUN。部分应用自行管理代理，不会跟随系统代理变化，需在确认基本连接正常后单独处理。
Desktop 与 WPF 的界面布局可能不同，不要只按旧截图寻找菜单位置。切换前导出需要保留的设置，并分别确认订阅分组、路由和本地监听端口。若保留两个安装目录，日常只运行其中一个，避免端口与系统代理状态互相覆盖。
v2rayN
macOS · Desktop使用桌面图形界面管理订阅、节点与路由。先在“关于本机”中查看芯片信息，Apple Silicon 选择 arm64，Intel 处理器选择 x64。
macOS 系统与安装要求
| 检查项目 | 选择依据 | 安装前处理 |
|---|---|---|
| 处理器 | Apple Silicon 对应 arm64；Intel 对应 x64 | 从系统菜单打开“关于本机”，查看芯片或处理器名称。 |
| 系统版本 | 需满足当前 Desktop 发行包要求 | 较旧系统先检查应用兼容提示，不默认所有系统版本均可运行。 |
| 应用与权限 | 从本地应用目录启动，按功能授予权限 | 首次打开如被系统阻止，先确认来源及系统提示，再决定是否允许。 |
打开 DMG 后按安装界面指引把应用放入应用目录，再从该目录启动。磁盘映像只是安装载体，不建议长期从映像内运行。应用启动后先完成订阅导入，确认列表中出现有效配置，再设置系统代理和路由预设，逐步验证连接。
系统安全提示与网络连接失败需要分开处理。前者发生在应用启动阶段，应查看系统设置中的相关提示；后者发生在客户端已运行后，应查看内核日志与配置参数。不要为了省略一次确认而全局关闭系统安全机制，也不要把权限问题直接归因于订阅失效。
如果此前使用过其他代理工具，切换前先退出旧工具并检查残留的系统代理。客户端关闭后仍无法直接访问网络时，优先检查系统网络设置中的代理项。恢复基本网络后，再逐项启用新客户端的功能，避免多个后台进程同时修改同一份设置。
v2rayNG
首推 Xray 内核安卓优先选择。通过 Android 的 VPN 接口接管流量，支持订阅导入与分应用设置。2015 年后的主流手机一般先选 arm64，仍需确认系统支持 64 位应用。
v2flyNG
备选 v2fly 内核需要 v2fly 内核生态时使用的安卓备选客户端。选择前确认现有订阅的协议与传输参数能被对应内核识别，不要把不同内核的功能范围视为完全一致。
Android 系统与授权要求
| 检查项目 | 选择依据 | 安装前处理 |
|---|---|---|
| 架构与系统 | arm64 包需要系统支持 64 位应用 | 硬件支持不等于系统一定支持；不确定时查看设备信息或选择通用版。 |
| 安装授权 | 安装 APK 需允许当前来源安装应用 | 仅对正在使用的浏览器或文件管理器按需授权。 |
| VPN 接口 | 启动代理时确认系统 VPN 请求 | 同一时刻避免与其他占用 VPN 接口的应用同时运行。 |
| 后台运行 | 持续连接可能受到省电策略影响 | 按需设置后台活动和电池优化，重启后再次确认连接状态。 |
下载完成后从通知栏或文件管理器打开 APK。如果系统提示应用未安装，先看是否为架构不匹配、系统版本不足，或已有应用与新包签名不一致。不要直接卸载唯一保留配置的应用；先导出订阅和自定义节点，再决定是否需要重新安装。
首次启动代理时，系统会显示 VPN 连接请求。这是客户端把选定应用流量送入本地代理处理流程的授权，不代表安装后自动获得远程服务。先导入配置、选中节点，再允许连接。若同时启用了其他 VPN 类应用，需要先停止其中一个。
后台容易断开时，先检查系统是否限制了客户端的后台活动，以及息屏后是否暂停网络。分应用代理的包含与排除含义也要核对：修改应用范围后通常需要重新建立连接。测试时先保持默认范围，再逐步加入自定义排除项，更容易定位问题。
v2rayN
Linux · Desktop按发行版选择 deb 或 rpm，再核对处理器架构。下方主入口为 x64；使用 ARM 桌面环境时，选择对应的 arm64 包。
deb 安装包
Debian 系Debian、Ubuntu 等通常使用此格式。通过系统软件安装器打开，检查依赖提示后再确认安装。
Linux 系统与依赖要求
| 检查项目 | 选择依据 | 安装前处理 |
|---|---|---|
| 包管理体系 | Debian 系通常用 deb；RPM 体系通常用 rpm | 结合发行版名称与软件安装器提示判断，不混用包格式。 |
| 处理器架构 | x64 对应 amd64 或 x86_64；arm64 对应 aarch64 | 在系统详情中确认架构，不以发行版名称代替架构判断。 |
| 桌面与系统库 | 需满足图形界面和当前发行包依赖要求 | 由包管理器检查依赖；过旧系统库不宜通过强制忽略依赖处理。 |
| 代理与权限 | 系统代理遵循情况取决于桌面环境与应用 | 先验证基础代理；TUN 权限与路由配置另行设置。 |
先使用桌面环境提供的软件安装器打开安装包，查看包管理器列出的依赖关系。遇到不满足的系统库要求时，先判断发行包是否适合当前系统。相同安装格式只说明使用了相近的包管理方式，并不能保证不同发行版之间直接兼容。
安装后从应用菜单启动 v2rayN，导入配置并查看启动日志。浏览器、桌面应用与终端程序读取代理设置的方式可能不同：桌面系统代理正常，并不代表每个程序都会自动跟随。应选择一个明确遵循系统代理的应用先验证，再处理其他应用的接入方式。
需要 TUN 时，再检查当前用户权限、虚拟网卡与已有路由。不要为了测试一个功能直接让所有桌面程序长期以高权限运行。若连接后局域网访问异常，先撤回刚添加的路由设置，确认默认网络恢复，再细化绕过规则。
下载后的配置顺序
安装只完成第一步。导入配置、启用代理、验证连接，按顺序处理更容易定位问题。
先准备配置，再开启代理
客户端是本地管理工具，订阅地址才是获取一组连接配置的入口。复制完整地址后，在订阅分组中添加来源并执行更新；如果拿到的是单节点分享链接，则使用从剪贴板导入等对应入口。两种内容看起来都像链接，但导入位置不同，不能只根据链接长度判断。
订阅更新完成后，先检查列表是否出现预期配置，再选择一个节点作为当前连接。暂时不要批量修改协议、传输方式或安全参数，这些内容需要与服务端一致。更新结果为空时，应先检查地址有效性、网络可达性和订阅格式，而不是盲目切换代理模式。
区分系统代理、路由与 TUN
系统代理决定遵循系统设置的应用如何把流量交给客户端；路由决定客户端接到流量后如何分配；TUN 则提供另一种接入流量的方式。这些功能分别处于不同环节。首次使用桌面客户端，建议先用系统代理完成验证，确认基本链路正常后再考虑更广的流量接管范围。
安卓客户端通过系统 VPN 接口接管选定范围的流量，需要确认授权和当前连接状态。桌面端与安卓端的入口名称不必完全相同，但检查逻辑一致：配置有效、内核正常运行、应用流量进入客户端、路由匹配符合预期。一次只改变一个环节，避免把多个问题叠在一起。
需要具体菜单操作时，继续阅读 v2rayN 配置教程；想了解内核选择、TUN 与日常维护，可进入 新手到进阶手册。配置异常时保留必要的错误信息，但分享截图前应遮挡订阅地址、节点凭据及个人网络信息。
升级与配置迁移
升级前先导出订阅分组、自定义节点、路由规则和需要保留的设置。订阅可以重新拉取服务端配置，但不会自动还原全部本地偏好；只在本地手动添加的内容更需要单独保存。
停止当前代理并退出客户端后再替换程序。跨界面或跨内核迁移时，优先使用应用提供的导入导出功能，不要直接覆盖不确定用途的配置文件。新版启动后先验证一个连接，再恢复自定义分流和其他高级设置。
保留旧配置备份，直到新环境运行正常。若遇到问题，先记录报错与最近修改项，恢复到明确可用的状态后逐项重试。备份含有订阅或连接凭据时，应保存在受控位置，不放入公开分享目录。
下载与安装常见问题
优先核对包类型与运行环境，再检查连接配置。
下载客户端后，是否已经包含可用的连接配置？
客户端负责读取配置、启动内核和管理代理，不随安装包提供连接服务。首次使用需要准备可信来源的订阅地址或节点分享链接，再在客户端内导入。订阅地址可能包含访问凭据，不要公开截图或转发。
Windows 的 Desktop 和 WPF 版应该选哪个？
Desktop 使用新一代跨平台界面，适合新安装或希望在不同桌面系统保持相近操作习惯的用户；WPF 是经典稳定版，适合熟悉传统 Windows 界面的用户。两者都需要按实际发行要求准备运行环境，切换前先备份配置。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常优先选择 arm64，但仍需确认系统支持 64 位应用。无法确认架构，或 arm64 包提示不兼容时，可尝试通用版。通用版覆盖更多架构，文件通常更大，连接质量不会因为安装包更大而提高。
升级前需要备份哪些内容？
先保存订阅分组、自定义节点、路由规则及重要设置，再停止代理并退出旧客户端。优先使用客户端提供的导出功能，备份文件应妥善保存。确认新版能够导入并连接后，再清理旧目录；不要直接删除唯一一份本地配置。
安装完成后网页仍然无法连接，应该先检查什么？
先确认配置已成功导入并选中节点，再检查内核是否启动、系统代理或 VPN 是否启用，以及本地端口是否被占用。随后核对系统时间、服务端参数与路由规则。一次只更改一项设置，通过日志定位错误，不要同时开启多个代理客户端。
Linux 应该选择 deb 还是 rpm 安装包？
按发行版使用的包管理体系选择：Debian、Ubuntu 等通常使用 deb；Fedora、RHEL 系发行版通常使用 rpm。还要核对 x64 与 arm64 架构，以及发行包要求的系统库版本。同为 rpm 或 deb 并不代表所有发行版版本都能直接安装。