# 首次连接

Source: https://onexray.com/zh/docs/getting-started/
Description: 在同一页选择直连地区和适用的出口网卡，进入首页完成授权，再添加服务器或恢复配置并连接。


## 1. 完成两步初始化

阅读隐私说明并同意继续。在“准备连接”页等待本地配置和内置路由数据准备完成：

- 国家或地区用于智能路由的直连规则，不是 VPN 节点位置。可选择一个地区、清空选择，或保持未选择以沿用原设置；新安装的原默认值为中国大陆。
- Windows 和 Linux 必须在同一页明确选择 Xray 出口网卡。“当前用于上网”仅供参考，不自动选中。Apple 和 Android 不显示此项。

点击“进入首页”保存。初始化不会自动前进，不再包含 VPN 授权或添加服务器步骤，也不会启动 VPN。地区之后可在[智能路由](https://onexray.com/zh/docs/connect/smart-routing/)修改。

## 2. 进入首页时完成授权

主界面初始化会读取当前 VPN 状态，并对缺少的必要授权主动申请一次，无论是否已有服务器。Apple 需要批准 VPN 配置，OneXraySE 还可能需要系统扩展批准；Android 17 及以上还检查局域网权限。

拒绝或取消后仍可浏览首页，但连接前必须完成必要授权。添加服务器后，可以通过连接按钮重试并批准授权；单纯返回前台不会反复弹框。进入主界面时的首次授权请求本身不会启动 VPN。

## 3. 添加服务器或恢复备份

进入[服务器 → 添加服务器](https://onexray.com/zh/docs/servers/import/)。可添加订阅、粘贴分享链接、选择文件或输入节点 JSON。iOS/Android 还支持扫码；文件导入直接打开系统选择器。

普通节点导入直接保存，没有第二次预览确认，也不等待后续测速结束。初始化不依赖服务器数量或测速结果。

已有连接配置备份时，可以点击连接或服务器空页面的“从备份恢复”，或打开“设置 → 数据 → 备份与恢复”，按[恢复预览与确认流程](https://onexray.com/zh/docs/backup/)操作。恢复后的订阅只有来源，不包含节点缓存，需要更新订阅获取节点。使用恢复的完整 Raw JSON 时，打开专家模式并选择配置。

恢复不会自动启动 VPN。缺失的自定义 GeoData 不阻塞进入首页，但使用依赖它的配置前需要下载。

## 4. 选择并连接

在“连接”页选择服务器来源和流量方式。可从“自动选择＋智能路由”开始；测试单个节点时，选择该节点和“所有流量经过 VPN”。自动选择需要符合条件的可用测速结果。

点击连接，等待“已连接”。权限、排队与启停期间按钮显示进度。页面和窗口可见时显示本次流量与实时速率；桌面窗口仅失去焦点不会暂停刷新。

## 遇到问题时

- 没有可用服务器或接入数量不足：添加服务器、完成测速，或调整选择范围／接入数量。
- 权限未就绪：按连接页提示授权；需要系统设置时，处理后返回重试。
- 网卡不存在：在“高级 → VPN 隧道”重新选择。每次启动会检查，但连接后不持续监测网卡。
- 配置或路由数据错误：查看具体原因及[日志／实际配置](https://onexray.com/zh/docs/advanced/logs/)。缺失必要数据时明确报错，连接启动不会自动下载 GeoData 来兜底。

普通启动仍重新检查前置条件。正在运行时切换配置会先停止旧 VPN；新连接失败不会自动恢复旧连接。