# 导入与分享格式

Source: https://onexray.com/zh/docs/sharing/
Description: 区分标准分享链接、OneXray URL、完整 JSON 与 GeoData 依赖，避免误导入或分享 age 私钥。


## 选择格式

| 对象 | 格式 |
| --- | --- |
| 节点 | 支持的协议分享链接、节点 JSON、OneXray 链接 |
| 订阅 | HTTPS URL 或 OneXray 链接 |
| 自定义路由 | 完整路由 JSON 或 OneXray 链接 |
| Raw JSON | 完整配置 JSON 或 OneXray 链接 |
| 自定义 GeoData | 文件名、类型与 HTTPS 来源链接 |
| 连接配置备份 | 通过“备份与恢复”读取 OneXray-backup.json |

协议分享链接无法表达全部 Xray 出站字段。需要保留这些字段时，使用完整节点 JSON 或 OneXray 格式。

VMess 和 VLESS 使用 [VMessAEAD / VLESS 分享链接标准](https://github.com/XTLS/Xray-core/discussions/716)，不支持旧版 VMessQrCode 链接（`vmess://Base64(JSON)`）。SS、SOCKS、Trojan 以及 Base64 / age 订阅封装继续保留。

普通服务器导入只提取节点；完整配置使用自定义路由或 Raw JSON 流程。连接配置备份使用独立的[备份与恢复](https://onexray.com/zh/docs/backup/)入口，不属于普通配置导入；旧 ZIP 备份不支持。与订阅分享不同，备份保留原有 Age 密钥和 HWID，不要公开作为分享链接。

## OneXray 链接

```text
onexray://onexray.com/config/add?type=outbound|raw|custom|custom-advanced&data=<percent-encoded-base64-json>#Name
onexray://onexray.com/sub/add?url=<percent-encoded-https-url>&age=x25519|hybrid#Name
onexray://onexray.com/dat/add?type=domain|ip&url=<percent-encoded-https-url>#Name
```

有多个备选值时只选其中一个；明文订阅省略 age。fragment 用作显示名称。不支持退休的 profile/full/setting 配置类型。

age 链接只描述算法，接收设备生成新密钥，不共享现有公钥或私钥。订阅导出也不包含 HWID 及其开关。导入链接不能开启 HWID，接收方必须主动为该订阅开启。

## 路由依赖

完整分享配置可以声明自定义数据：

```json
{
  "geodata": {
    "assets": [
      {"file": "other.dat", "url": "https://example.com/other.dat"}
    ]
  }
}
```

这里只是依赖片段，不是可直接运行的完整配置；使用时替换为真实来源。

省略默认 geoip.dat、geosite.dat。常规自定义仅导出空接入槽，高级自定义还保留用户的辅助出站。两者均不导出生成的代理节点、balancer 或 App 的 direct/block 定义。导入会校验依赖、拒绝重名，并在存储前删除只供导入的 geodata 字段。

常规自定义路由使用标准 `dns.servers` 中固定标记为 `app-dns-direct` 的条目保存并导出本地 DNS 地址；运行时的直连域名匹配由 App 生成。见[自定义路由 JSON 示例](https://onexray.com/zh/docs/connect/custom-routing/)。

## 从 App 分享

iOS、Android、macOS 和 Windows 打开系统分享界面；Linux 提供明确的复制操作。关闭或取消分享面板后保留当前页面，不把关闭面板视为成功送达。分享失败时展示可用的具体原因。

## 打开链接

已安装的移动端和 macOS App、Windows EXE/MSIX、Linux DEB 注册 onexray://。Windows/Linux ZIP 不自动注册，可改用剪贴板或文件导入。Mac 同时安装多个版本时由系统选择处理程序。

分享可能暴露凭据和 URL 令牌，请先检查。完整配置与依赖保留确认流程，普通节点导入则没有第二次预览。

常规自定义链接使用 `custom`，高级 JSON 使用 `custom-advanced`，完整 Raw 使用 `raw`。裸 JSON 的类型由当前编辑器确定，不根据 DNS 字段猜测类型，也不把高级模板交给常规表单。