平台与架构选择

V2Ray 客户端下载

先选要安装客户端的系统,再按处理器架构和包格式下载。桌面用 v2rayN;Android 首选 v2rayNG,需要 v2fly 内核时再选 v2flyNG。

Windows 客户端

安装、升级与迁移

第一次安装,先确认系统和架构;已有配置要保留,则先备份,再安装。若在这台电脑上替另一台设备下载,请按接收设备的信息选包,不要按浏览器当前显示的系统来选。虚拟机里安装也是同理:看虚拟机内部的系统和处理器架构,而不是宿主机品牌。

先确认是更新客户端,还是更新订阅

客户端更新会替换应用程序;订阅更新只会重新读取分组地址提供的配置。发现某个分组的内容不对,先试「更新订阅」,不必先下载新的客户端。如果是菜单位置和教程截图不同,先记下客户端名称、已装版本和界面类型,再找对应该版本的操作说明。尤其在 Windows 上,桌面版与经典 WPF 版的入口布局不同,不代表其中一个安装失败。

换版本前保留可恢复的配置

如果现有版本提供配置导出或备份功能,先用客户端自带的入口保存文件,再确认备份能找到。订阅分组、手写路由、手动录入的单个配置和本地端口不一定都存在同一份订阅里,不能只存一个链接就当作完整备份。备份可能含私人订阅地址或连接凭据,保存在自己控制的位置,不要随报错截图一起发出。

更换安装形式、发行渠道或设备时,不要默认能覆盖安装,也不要默认可以直接复用旧程序的整个数据目录。先在目标设备安装匹配的包,然后用导入功能恢复可识别的配置。旧设备里若有单独修改过的路由和端口,可在新设备上逐项对照,确认能用后再清理旧配置。

第一次启动后,按顺序确认三件事

  1. 先确认窗口能打开。如果程序没有启动,保留系统提示,回查包格式、处理器架构和运行环境。此时不用先改订阅链接或路由规则,因为还没有到读取这些设置的阶段。
  2. 再确认配置已进列表。添加订阅地址与更新订阅是两个动作。添加后返回主界面更新,再切到对应分组查看。若手头是单条分享链接,要用剪贴板导入之类的入口,而不是把它当作订阅地址。
  3. 最后确认应用用上了所选连接方式。桌面先确认系统代理是否启用,以及目标应用是否遵循它;手机则检查客户端是否获得系统的连接许可。初次验证时先用一项设置做测试,避免同时改端口、路由和连接模式,导致难以找出哪一步出了问题。

报错时,记录出现问题的步骤、客户端名称、系统版本、所选包的架构和错误原文。仅出现浏览器下载错误时,先查下载;系统安装器拒绝包时,先查兼容性;程序已打开但更新失败时,再查订阅与网络。这样把几个阶段分开,比反复下载同一个安装包更容易定位问题。

下载与安装常见问题

从选错安装包、浏览器下载中断,到装好后列表为空,按实际遇到的提示排查。

Windows 桌面版和经典 WPF 版要一起装吗?

选一种即可。首次使用可以选桌面版;习惯经典界面,或正按 WPF 版截图寻找菜单时,可以选经典 WPF 版。切换之前先退出旧客户端,并备份旧配置。两份程序可以下载留存,但不宜同时运行:如果它们尝试监听同一个本地端口,后启动的一份可能无法正常工作,也可能让你误判当前的系统代理由谁控制。

页面版本和下载文件名里的数字不一致,该看哪个?

卡片版本来自应用清单,文件名对应你实际选择的下载入口,两处数字可能不同。已安装版本以客户端的「关于」或系统应用详情为准。需要指定版本时,先核对实际获取的文件和安装器或系统显示的信息;如果仍无法确认,就不要把页面版本号当成该文件的版本,也不要急着覆盖原来的安装。

Android 提示「应用未安装」,要改下通用版吗?

如果提示架构不兼容,可以确认系统支持的架构,再试通用包;如果提示与现有软件包冲突,换成通用包通常无效。先查看存储空间、系统版本和详细错误,再确认设备上是否已有同名客户端,以及新旧包是否来自同一发布渠道。卸载可能同时清掉订阅和设置,先备份,再决定是否需要重新安装。

下载中断或文件打不开,应该先查什么?

先看浏览器下载列表是否显示完成,再核对文件扩展名和所选系统。Windows 的 ZIP 先完整解压,macOS 的 DMG 用访达打开,Android 的 APK 交给系统安装器,Linux 的 deb 或 rpm 交给相应包管理器。文件尚未下载完时,可以在浏览器里重试;如果反复得到错误页面,记下所选入口和浏览器提示,不要靠改后缀把错误页面当安装包。

安装完成后为什么还看不到订阅内容?

安装包只安装客户端,不会自动添加订阅。v2rayN 在「订阅分组」添加地址后,再执行更新;v2rayNG 打开「订阅分组设置」,保存地址后返回主界面更新订阅。如果更新后列表仍为空,先核对所选分组、链接是否完整以及订阅是否有效,再排查连接设置。不要把完整的私人订阅地址贴到公开讨论区。