导入与分享格式

选择格式

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

VMess 和 VLESS 使用 VMessAEAD / VLESS 分享链接标准，不支持旧版 VMessQrCode 链接（vmess://Base64(JSON)）。支持 Hysteria2（hysteria2:// / hy2://）、SS、SOCKS、Trojan 以及 Base64 / age 订阅封装。

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

OneXray 链接

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&panel=generic|remnawave&mode=appManaged|providerManaged&userAgent=<percent-encoded-user-agent>#Name
onexray://onexray.com/dat/add?type=domain|ip&url=<percent-encoded-https-url>#Name

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

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

可选的百分号编码 userAgent 保留该来源显式设置的下载 UA；省略或清空时，各面板都使用接收设备的兼容默认值。它不会开启 HWID，也不包含秘密密钥。

路由依赖

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

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

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

省略默认 geoip.dat、geosite.dat。常规自定义导出空接入槽、可选 Fragment 和显式直连／空答案 DNS 策略的受控 dnsOut，高级模板另保留其余用户辅助出站；支持的 DNS、嗅探和代理选路参数随格式保存。不导出生成的代理节点、运行 balancer 选择范围／fallback 或 App direct／block 定义。导入校验依赖、拒绝重名，并在存储前删除交换专用的 geodata 元数据。

常规自定义路由使用标准 dns.servers 中固定标记为 app-dns-direct 的条目保存并导出本地 DNS 地址；运行时的直连域名匹配由 App 生成。见自定义路由 JSON 示例。

从 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 字段猜测类型，也不把高级模板交给常规表单。

HTTPS 订阅响应使用独立的格式探测：完整 Xray 对象／数组可保存为提供方配置，不丢弃路由和 DNS；普通粘贴节点／文件导入仍提取普通节点。

订阅链接可省略 panel／mode：panel 默认为 generic，新来源可由首次响应确定 mode；生成链接携带已保存值。重复 URL 导入只刷新原来源，不覆盖面板／方式。提供方完整分享使用适配后的 Raw 副本，不生成新的订阅 URL。常规导出保留支持的 DNS、嗅探与选路参数，不包含运行节点 tag 或探测结果。

冷启动与重定向

初始化和 Setup 期间，订阅链接先暂存在内存，主界面就绪后再打开。广播与首页主动读取共用一次领取，同一个排队链接只处理一次；已有弹窗关闭后继续导入。完成或取消后，再次打开相同链接属于新操作。

网页重定向包装 onexray:// 时，先将整个内部 URI 编码为一个外层参数。重定向服务端需读取并解码该参数一次，把原始自定义 scheme URI 放入 Location，保留已有 panel、mode、userAgent 及名称 fragment。App 无法恢复被重定向服务丢弃的字段。