图一:先选你的设备,不要照抄另一平台的按钮
Android、Windows、macOS 的当前官网入口提供 Roxi 安装包;iPhone / iPad 的入口指向 Shadowrocket;Linux 的入口指向 v2rayN。本文的“一键连接”“节点列表”等描述主要按本项目当前 Roxi 界面文案与实现核对,已安装旧版本可能不同。不要把这些入口都理解成一个通用安装包。
| 你用的客户端 | 配置怎么来 | 应该看哪条路线 |
|---|---|---|
| Roxi 原生客户端 | 按账户状态获取应用内线路;先确认加载完成 | 继续阅读本文的账户、连接与节点检查 |
| Shadowrocket 等第三方客户端 | 从自己个人中心获取它支持的订阅 | 先完成对应客户端导入,再看本文的访问验收 |
| 已有其他服务配置的客户端 | 保留原配置,单独添加自己的 Roxi 配置 | 不要直接覆盖唯一能用的配置,也不要同时开两套 VPN |
第一步:确认账户身份,再判断有没有线路
- 第一次打开 Roxi 后,先等待初始化。当前实现包含设备初始身份和配置获取流程,不能仅凭没有出现邮箱登录页就判断安装失败。
- 已有账户时,从应用提供的账户/个人中心入口登录原账户,确认身份和权益信息。不要在不同设备临时注册多个账号后,误以为权益会自动合并。
- 如果提示登录失效、账户受限、获取线路失败,分别保留报错。先修复登录或配置获取,再处理连接。重装会增加找回配置的难度,不能作为第一步。
个人中心显示的可用时长、到期状态和设备限制可能影响连接。以当前账户页面和客户端提示为准,本文不固定写入免费时长、速率或线路数量,也不承诺每个账户拥有同样节点。
图二:原生客户端与订阅客户端,在这里分岔
| 路线 | 按顺序做什么 | 完成标志 |
|---|---|---|
| Roxi 原生客户端 | 启动 → 核对账户 → 等待线路加载 → 连接 | 界面出现可用线路且连接状态有明确结果 |
| iPhone / 第三方客户端 | 官网个人中心 → 自己的订阅 → 导入对应 App → 选择配置和节点 → 连接 | 客户端里能看到刚导入的配置及真实节点 |
| 导入失败 | 保持旧配置 → 记录错误 → 检查订阅响应与格式 | 能区分登录页、失效订阅和格式不兼容 |
使用第三方客户端时,网址中的订阅 token 和二维码都相当于访问凭据。从你自己的个人中心复制,不用群里别人的链接。网页上“订阅链接”“复制订阅地址”和 Shadowrocket 导入入口各有用途:复制是拿到 URL,一键导入是请求系统打开指定 App,都不等于已经连接成功。
第二步:发起连接,只确认与你刚才操作对应的授权
- 先正常断开另一款 VPN/代理软件,记录原设置。Android 的 VPN 接管不能简单地靠两个 App 同时打开叠加实现。
- 在 Roxi 主界面点击连接按钮,观察是“正在获取线路”“连接中”还是已经连上。首次系统询问是否允许建立 VPN 时,确认应用名称是自己刚打开的 Roxi,再决定允许。
- 如果立即出现权限、服务安装或配置错误,先按原文处理。不要连续快速点击连接和断开,也不要把“窗口打开了”当作 VPN 已启动。
第三步:看节点列表,再看真实访问
- 打开节点列表,确认你实际能够选择的节点。列表中仅展示地区或升级入口的项目,不等于当前账户已经可以使用。
- 首次先保持一个可用节点。需要对照时固定网络、换一个节点;或者固定节点、换网络。节点延迟只是探测结果,不能证明你要访问的网站一定正常。
- 打开一个平时可直连的网站,再打开自己确实需要访问的目标页面。若国内网站正常、目标失败,继续核对节点、规则和目标服务;若两者都失败,先查接管和基础联网。
| 客户端现象 | 你应验证的动作 |
|---|---|
| 显示已连接 | 重试原本失败的页面或功能,查看实际响应 |
| 显示所有节点超时 | 记录原网络,做一次其他网络对照;区分探测失败和真实请求失败 |
| 国内网站正常,某个账号服务拒绝 | 记录 HTTP 状态或页面提示,核对该服务的账号与支持条件 |
| 锁屏或换网络后掉线 | 分别检查后台权限和 Wi-Fi/蜂窝切换,不连续重装 |
第四步:验证退出,才算完成首次上手
- 从应用的连接控制中明确断开,确认状态变化。桌面端关闭窗口可能只是最小化,不能据此判断代理已经关闭。
- 如自己开启过系统代理或 TUN,确认对应接管已停止;重试同一个直连网站。异常时按 Windows 或 Mac 的退出断网教程恢复。
- 再打开应用重连一次,并复测原来的目标功能。保存已确认的安装入口和版本;以后升级前保留配置副本。
若需要求助,记录“设备与系统、客户端版本、当前网络、失败发生在下载/登录/拉配置/连接/访问哪一步、已尝试什么”。这样的反馈比单独截一张绿色按钮更容易定位。