client shelf
桌面使用 v2rayN，安卓优先选择 v2rayNG。先确认系统与处理器架构，再安装和导入订阅。
download
每个平台保留对应客户端与包格式。版本文字位于卡片明细；具体功能与兼容性以安装后的客户端及系统提示为准。
Windows 桌面客户端 · x64
两版差异主要在界面与运行环境，不是两套代理协议。Desktop 采用面向多个桌面系统的新一代界面；WPF 保留经典 Windows 操作布局。已有配置的用户可以沿用熟悉的版本，准备迁移时先导出订阅分组和自定义路由，避免把界面变化误认为配置丢失。
这里的两个入口均为 x64 安装包。下载前打开“设置 → 系统 → 系统信息”，确认系统类型。文件下载完成后先完整解压，再运行其中的安装程序，不要直接在压缩软件的临时目录内启动。安装向导若提示缺少运行组件，应按提示处理，而不是反复切换节点。
第一次启动先检查本地监听端口，再导入订阅并选择节点。系统代理只会影响遵循系统代理设置的应用，不会自动覆盖全部程序。旧版仍在后台运行时，两个实例可能占用同一端口；退出旧进程后再测试新版，有助于区分安装问题与连接问题。
| 检查项 | 选择依据 | 安装前准备 |
|---|---|---|
| 系统与架构 | 64 位 Windows，使用 x64 包 | 在系统信息中确认系统类型；具体系统版本兼容性以安装提示为准 |
| 运行环境 | Desktop 与 WPF 的依赖可能不同 | 按所选版本提示安装运行组件，保留完整程序目录 |
| 权限与端口 | 普通代理与 TUN 权限要求不同 | 先测试普通代理；需要 TUN 时再检查提权与网络驱动提示 |
macOS 桌面客户端 · DMG
芯片类型比设备外观或购买年份更可靠。打开系统菜单中的“关于本机”：显示 Apple 芯片的设备选择 arm64，显示 Intel 处理器的设备选择 x64。两种安装包的用途相同，区别是运行架构；优先使用与设备匹配的原生包，不必为了界面一致而选择另一种架构。
下载后打开 DMG，将应用放入“应用程序”目录，再从该目录启动。不要长期直接运行镜像中的应用，更新和权限记录可能因此不易管理。首次打开若出现系统安全提示，应核实下载来源并按系统提供的单个应用授权流程处理，不建议整体关闭系统安全机制。
v2rayN 内的系统代理设置需要与当前网络服务配合。切换 Wi-Fi、有线网络或使用其他网络工具后，可在系统网络设置中复查代理地址与端口。TUN 属于另一种流量接入方式，启用时可能需要额外权限；首次配置先完成订阅导入和普通代理验证，再引入更复杂的模式。
| 检查项 | 选择依据 | 安装前准备 |
|---|---|---|
| 处理器 | Apple Silicon 用 arm64；Intel 用 x64 | 通过“关于本机”确认，不仅凭设备年份判断 |
| 系统环境 | 系统库须满足当前桌面版运行要求 | 保留系统更新；遇到版本不兼容提示时先检查系统版本 |
| 应用与权限 | 安装到应用程序目录 | 首次启动按系统提示授权；TUN 权限单独处理 |
Android 客户端 · Xray 内核
v2rayNG 是安卓端的优先选择，适合使用 Xray 能力的配置。arm64 的选择依据是设备支持的应用架构，而不是安卓版本号。部分旧设备或特殊系统即使采用较新的处理器，也可能只提供不同的应用运行环境；安装时若提示架构不兼容，可改用通用版排除这一因素。
打开下载的 APK，按系统提示允许当前浏览器或文件管理器安装应用。这个授权针对发起安装的应用，不等于允许所有来源。完成安装后可关闭不再需要的安装权限。首次启动连接时，安卓会显示本地 VPN 授权对话框，确认后客户端才能接管流量。
Android 客户端 · V2Fly 内核
v2flyNG 作为 V2Fly 内核备选，适合已有配置与该内核功能匹配的场景。客户端界面相似并不代表所有协议扩展都可以互换。导入前应确认订阅中的协议、传输方式和安全层要求；遇到内核不支持的字段，换架构包通常不能解决，需要重新确认客户端与配置的对应关系。
两款客户端可以分别保存配置，但安卓通常只允许一个本地 VPN 会话处于活动状态。切换测试时先停止另一款客户端，再启动当前应用。若连接在熄屏后中断，检查系统电池优化和后台运行限制；不要把后台被系统停止误判为节点失效。
| 检查项 | 选择依据 | 安装前准备 |
|---|---|---|
| 应用架构 | 支持 arm64-v8a 时优先单架构包 | 不确定时使用通用版，仍需满足客户端系统版本要求 |
| 系统与安装 | 最低系统要求取决于所选发行包 | 查看安装提示，为当前安装来源授予所需权限 |
| 网络与后台 | 本地 VPN 授权与后台运行条件 | 停止其他 VPN 会话，检查省电与后台限制 |
Linux 图形客户端 · deb / rpm
Linux 需要同时匹配发行版包管理体系和处理器架构。deb 与 rpm 不是两种代理模式，也不能仅靠改扩展名互换。使用 Debian、Ubuntu 等发行版时优先选择 deb；使用 Fedora、RHEL 等体系时查看 rpm 的依赖要求。文件名中的发行版标记和系统库版本也会影响兼容性，不能把“支持 rpm”理解成任意 rpm 系统都能直接安装。
普通桌面电脑多为 x64，对应包内的 amd64 或 x86_64；arm64 设备对应 arm64 或 aarch64。可在系统信息中查看处理器，也可用下方命令读取架构。v2rayN 是图形客户端，需要可用的桌面会话；仅有终端的环境不应照搬桌面安装步骤。
uname -m下载后通过发行版的软件安装器或包管理工具打开安装包，由包管理器处理依赖。若安装器报告缺少库、架构不匹配或依赖版本不足，应先解决这些问题；不要强制忽略依赖后再把启动失败归因于代理设置。系统包管理器中的错误信息通常比重复下载安装包更有助于定位原因。
安装完成后先在普通用户会话中启动图形界面，导入订阅并检查本地监听端口。Linux 桌面环境对系统代理的处理存在差异，部分终端工具还需要单独指定代理。需要让更多应用进入客户端时，再阅读 TUN 相关权限与路由说明；不要为了第一次连接就把整个桌面程序长期以高权限运行。
| 检查项 | 选择依据 | 安装前准备 |
|---|---|---|
| 发行版 | deb 或 rpm 与包管理体系一致 | 检查当前发行版的软件源、依赖与系统库兼容性 |
| 处理器 | x86_64 选 x64；aarch64 选 arm64 | 使用系统信息或 uname -m 确认架构 |
| 桌面与网络 | 可用的图形桌面会话 | 先验证本地代理，再配置桌面系统代理或 TUN 权限 |
after install
安装只是准备工作。客户端负责配置与流量接入，远程节点需要单独提供。按下列顺序操作，可以减少多个设置同时变化带来的排查成本。
01 / import
使用有权访问的订阅链接或节点分享链接。先建立订阅分组，粘贴地址后执行更新，再查看是否出现可选节点。复制时避免带入空格和换行。订阅链接可能包含访问权限信息，不要随意转发或放进公开截图。
查看订阅导入步骤 →02 / mode
桌面端先检查客户端端口，再启用系统代理；安卓端先确认本地 VPN 授权。系统代理、路由模式与 TUN 是不同层面的设置：前者决定应用如何进入客户端，路由决定进入后的出口，TUN 则改变流量接入范围。
查看路由分流说明 →03 / verify
选定节点后启动，分别检查客户端日志、应用代理设置和目标网页。界面显示运行不等于所有应用都已使用代理。若网页打不开，先确认时间、端口与代理设置，再检查 DNS 和规则；每次只调整一个变量。
查看连接疑难解答 →Project V 是代理工具的开源生态背景，V2Fly 与 Xray 是相关内核家族。图形客户端负责把订阅、节点、端口和路由设置组织成可运行的配置。v2rayN 面向桌面系统，v2rayNG 和 v2flyNG 面向安卓；选择客户端时，除了设备平台，还应确认实际配置需要哪种内核功能。协议名称相同，也可能因为传输或安全层扩展不同而存在兼容性差异。
更新客户端不等于更新订阅，也不等于切换远程节点。更新后若出现问题，先比较本地设置与旧配置，再查看日志中的具体报错。协议和 DNS 的详细说明可继续阅读概念速查与DNS 设置章节；首次使用则按快速上手的顺序操作，不必一开始就调整全部高级参数。
download questions
先处理包格式、架构与安装环境，再进入订阅和连接设置。
新安装优先选择 Desktop 桌面版，它采用新一代跨平台界面。经典 WPF 版保留熟悉的 Windows 界面，适合延续现有操作习惯。迁移前先导出配置，不要让两个实例同时监听相同的本地端口。
2015 年后主流手机通常优先选择 arm64，但应以设备支持的应用架构为准。设备架构不确定或 arm64 安装包提示不兼容时，可尝试通用版。通用版包含多种架构，不代表旧系统一定满足客户端要求。
deb 用于 Debian、Ubuntu 等使用相应包管理体系的发行版，rpm 用于 Fedora、RHEL 等相应体系。先确认发行版，再确认 x64 或 arm64 架构。包格式一致仍可能存在依赖与系统库版本差异。
配置能否沿用取决于客户端版本、安装方式与配置目录。更新前导出配置，记录订阅分组、端口和自定义路由，并完全退出旧进程。更新后逐项检查，不要假定所有设置都会自动迁移。
客户端安装包不包含可直接使用的远程节点。需要导入有权使用的订阅或节点配置，选择节点并启动，再检查系统代理或本地 VPN 授权。仅安装程序不等于已经建立代理连接。
卡片版本文字与各架构文件路径来自清单中的不同字段，更新节奏可能不同。下载后查看客户端“关于”页面中的实际版本；迁移设置和确认功能支持时，以已安装客户端为准，不要只凭文件名判断功能。