先分清:网站打不开、文件下载失败,还是安装失败

这三种情况要分别处理。能看到下载按钮却下载超时,是文件传输问题;文件下载完后提示不支持,是系统或架构问题;软件可以打开但没有线路,则已经进入账户与配置问题。不要把它们全部归结为“节点坏了”,也不要靠不断重装碰运气。

你看到的现象先确认什么下一步
官网完全打不开同一网络的常用直连网站是否正常先恢复基础网络,再用另一张自己可用的网络对照
网页能开,文件下载中断浏览器下载记录是否显示已完成暂停其他大下载,换网络重新下载,核对文件
安装包无法打开或不受支持真实系统、CPU 架构、包格式回到官方入口选择匹配文件
界面打开但没有节点登录状态、订阅是否成功加载进入首次连接教程,而不是再次重装

第一步:从你已经确认过的官方入口出发

  1. 在浏览器地址栏输入或打开自己保存的官网书签。本文核对的下载入口是 https://roxi123.xyz/#download,备用客户端页是 https://roxi123.xyz/clients.html。确认域名后再点下载,不从搜索广告或陌生群附件判断“官方”。
  2. 如果原网络能访问国内常用网站,却打不开这个入口,固定同一个网址,用手机流量或另一张有权使用的网络做一次对照。公共 Wi-Fi 需要先完成自己的认证。换网络能打开,只说明差异与接入网络有关,不证明任何入口在全国都可用。
  3. 已经有能用的旧客户端时,先保留它和原配置,再下载新安装包。完全没有可用入口时,使用此前确认过的备用地址或联系官方支持;本文不提供未经核实的镜像站,也不保证某个域名永久可达。

第二步:按操作系统选包,不按设备外形猜

设备当前官网提供的入口容易选错的地方
AndroidRoxi APKAPK 不能装到 iPhone;核对系统是否支持该安卓应用
WindowsRoxi 安装器,另有 ZIP 便携版ZIP 应完整解压到固定目录后运行,不能只在压缩包里双击
macOSRoxi DMG先确认系统版本、芯片和当前发行包支持范围
iPhone / iPadShadowrocket 的 App Store 条目这是第三方客户端,需要自己的有效配置;不是 Roxi APK
Linuxv2rayN 的 DEB 入口DEB 只适合相应发行版和架构,不代表所有 Linux 都可安装

Windows 可在“设置 → 系统 → 关于”查看系统类型;Mac 可在“关于本机”查看芯片与系统版本。官网文字中的最低版本只是第一道条件,实际包的发行说明仍要一起看。不要因按钮写着“Mac”就默认兼容所有 Intel 与 Apple 芯片设备。

第三步:先确认下载完成,再计算校验值

在浏览器下载记录里确认任务完成,避免误运行 .part、.crdownload 等临时文件。备用客户端页会显示部分镜像包的版本、上游出处和 SHA256;把你实际下载的文件与同一版本、同一架构、同一包格式的值比较,不拿旧截图里的摘要核对后来更新的文件。

Roxi 备用客户端页面展示上游出处、版本及 SHA256 的实际截图
2026-10-13 官网截图。版本号和校验值仅演示它们在页面上的位置,下载时请读取页面当前值。 查看原始资料
Windows PowerShell:替换成自己下载的完整文件路径
Get-FileHash -LiteralPath "C:\Users\你的用户名\Downloads\客户端安装包.exe" -Algorithm SHA256

将输出的 Hash 与可信发布页面公布的完整 SHA256 逐字符比较,大小写不影响比较。两个值不一致时,先核对版本,再删除本次损坏文件并重新下载;不要忽略差异继续安装。计算出一串 Hash 本身不能证明安全,必须有可信的参考值。

第四步:只处理这一个应用需要的安装授权

  1. Android 如提示允许某个浏览器或文件管理器安装未知应用,先确认文件来源,再仅对该来源按系统说明授权;安装后撤销不再需要的安装权限。系统或设备管理策略禁止安装时,先核对兼容与管理要求。
  2. Windows 按已核实的发布说明安装;遇到系统防护提示时保存准确文字,检查发布者与文件来源。不把关闭整个防火墙、杀毒或安全中心作为通用步骤。
  3. macOS 按 DMG 内说明把应用放到“应用程序”。“应用已损坏”“无法验证开发者”“不支持此 Mac”不是同一种错误,先按 Apple 官方说明核对,不直接复制网上的批量删除属性或关闭 Gatekeeper 命令。

验收:先证明安装正常,再开始连接

  1. 应用能从系统的应用列表或固定安装目录独立启动,界面不空白、不立即退出。
  2. 在关于或设置页记下版本,保留此次安装包来源;涉及账号或订阅的问题留到下一阶段处理。
  3. 安装不成功时,向支持方提供系统版本、芯片/架构、包名、来源、具体报错和校验结果。不要把账户密码、订阅二维码一起发出去。

iPhone 商店不可用时,先核对当前账户地区和应用上架情况。账户地区变更会受到余额与订阅等条件影响,不为下载一个应用仓促更改整个账户,也不要登录陌生人出售或共享的 Apple 账户。