图一:先选你的设备,不要照抄另一平台的按钮

Roxi 官网下载区域:Android、iOS、Windows、macOS 与 Linux 的实际入口
2026-10-13 官网下载区域截图。页面按访问设备推荐版本;截图不是客户端界面,也不表示各平台已完成真机实测。 查看原始资料

Android、Windows、macOS 的当前官网入口提供 Roxi 安装包;iPhone / iPad 的入口指向 Shadowrocket;Linux 的入口指向 v2rayN。本文的“一键连接”“节点列表”等描述主要按本项目当前 Roxi 界面文案与实现核对,已安装旧版本可能不同。不要把这些入口都理解成一个通用安装包。

你用的客户端配置怎么来应该看哪条路线
Roxi 原生客户端按账户状态获取应用内线路;先确认加载完成继续阅读本文的账户、连接与节点检查
Shadowrocket 等第三方客户端从自己个人中心获取它支持的订阅先完成对应客户端导入,再看本文的访问验收
已有其他服务配置的客户端保留原配置,单独添加自己的 Roxi 配置不要直接覆盖唯一能用的配置,也不要同时开两套 VPN

第一步:确认账户身份,再判断有没有线路

  1. 第一次打开 Roxi 后,先等待初始化。当前实现包含设备初始身份和配置获取流程,不能仅凭没有出现邮箱登录页就判断安装失败。
  2. 已有账户时,从应用提供的账户/个人中心入口登录原账户,确认身份和权益信息。不要在不同设备临时注册多个账号后,误以为权益会自动合并。
  3. 如果提示登录失效、账户受限、获取线路失败,分别保留报错。先修复登录或配置获取,再处理连接。重装会增加找回配置的难度,不能作为第一步。

个人中心显示的可用时长、到期状态和设备限制可能影响连接。以当前账户页面和客户端提示为准,本文不固定写入免费时长、速率或线路数量,也不承诺每个账户拥有同样节点。

图二:原生客户端与订阅客户端,在这里分岔

路线按顺序做什么完成标志
Roxi 原生客户端启动 → 核对账户 → 等待线路加载 → 连接界面出现可用线路且连接状态有明确结果
iPhone / 第三方客户端官网个人中心 → 自己的订阅 → 导入对应 App → 选择配置和节点 → 连接客户端里能看到刚导入的配置及真实节点
导入失败保持旧配置 → 记录错误 → 检查订阅响应与格式能区分登录页、失效订阅和格式不兼容

使用第三方客户端时,网址中的订阅 token 和二维码都相当于访问凭据。从你自己的个人中心复制,不用群里别人的链接。网页上“订阅链接”“复制订阅地址”和 Shadowrocket 导入入口各有用途:复制是拿到 URL,一键导入是请求系统打开指定 App,都不等于已经连接成功。

第二步:发起连接,只确认与你刚才操作对应的授权

  1. 先正常断开另一款 VPN/代理软件,记录原设置。Android 的 VPN 接管不能简单地靠两个 App 同时打开叠加实现。
  2. 在 Roxi 主界面点击连接按钮,观察是“正在获取线路”“连接中”还是已经连上。首次系统询问是否允许建立 VPN 时,确认应用名称是自己刚打开的 Roxi,再决定允许。
  3. 如果立即出现权限、服务安装或配置错误,先按原文处理。不要连续快速点击连接和断开,也不要把“窗口打开了”当作 VPN 已启动。

第三步:看节点列表,再看真实访问

  1. 打开节点列表,确认你实际能够选择的节点。列表中仅展示地区或升级入口的项目,不等于当前账户已经可以使用。
  2. 首次先保持一个可用节点。需要对照时固定网络、换一个节点;或者固定节点、换网络。节点延迟只是探测结果,不能证明你要访问的网站一定正常。
  3. 打开一个平时可直连的网站,再打开自己确实需要访问的目标页面。若国内网站正常、目标失败,继续核对节点、规则和目标服务;若两者都失败,先查接管和基础联网。
客户端现象你应验证的动作
显示已连接重试原本失败的页面或功能,查看实际响应
显示所有节点超时记录原网络,做一次其他网络对照;区分探测失败和真实请求失败
国内网站正常,某个账号服务拒绝记录 HTTP 状态或页面提示,核对该服务的账号与支持条件
锁屏或换网络后掉线分别检查后台权限和 Wi-Fi/蜂窝切换,不连续重装

第四步:验证退出,才算完成首次上手

  1. 从应用的连接控制中明确断开,确认状态变化。桌面端关闭窗口可能只是最小化,不能据此判断代理已经关闭。
  2. 如自己开启过系统代理或 TUN,确认对应接管已停止;重试同一个直连网站。异常时按 Windows 或 Mac 的退出断网教程恢复。
  3. 再打开应用重连一次,并复测原来的目标功能。保存已确认的安装入口和版本;以后升级前保留配置副本。

若需要求助,记录“设备与系统、客户端版本、当前网络、失败发生在下载/登录/拉配置/连接/访问哪一步、已尝试什么”。这样的反馈比单独截一张绿色按钮更容易定位。