这里的配置规范对应 OneXray 26.11.1，旧版本变化见升级说明。连接配置备份是独立的恢复格式，不是第四种配置导入类型。

OneXray 支持节点、常规自定义路由、高级自定义路由和 Raw JSON 导入。各类型有独立字段与使用要求，应根据需求选择对应入口。

能力	说明
节点、自定义路由、Raw 导入	支持
自定义域名、目标 IP、端口、网络条件	支持
使用 app-dns-direct 保存本地 DNS	支持
自定义 protocol、localOS	支持
智能/自定义 FakeDNS 与 app-dns-fake	支持，默认关闭
高级自定义 DNS、嗅探、辅助出站和本地入站	通过独立 JSON 模板配置
Raw 新生成入站的 FakeDNS 还原	声明 FakeDNS server 或池时启用；已有 sniffing 不改写
Microsoft 直连开启时优先代理 GitHub	支持，排在直连规则之前

旧版本可能不支持本文的全部字段。选项缺失或拒绝受支持字段时，先更新 App；不能通过悄悄删除条件“兼容”用户需求。必须使用旧版本时，应说明限制并确认替代方案；Raw 也不能自动补齐缺失的原生集成。

内容依据

• App 导入边界以配置规范为准，示例验证依据记录在下方清单中。
• App 的获取方式见安装指南。
• 本次文档示例校验使用 libXray c145d94071088cebd445d7b0f4b1bea35732011e、Xray-core v1.260327.1-0.20260908222543-52a412d9e2f5。
• 示例清单记录每份文件的导入类型、依赖和替换要求。

上游当前文档可能比已安装内核更新。App 导入以 OneXray 的结构和托管边界为准，协议字段由配套 libXray 判定。不要混用其他客户端或旧 VMessQrCode 的格式。

数量和资料要求

常规与高级自定义路由共用三份上限，名称唯一且为 1–32 个字符，每份以 1–3 个空接入槽开头，高级模板后面可以追加辅助出站。编辑时不转换类型。新增 Raw 最多三份；旧库超出三份的记录保留可用，隐藏添加入口。

普通模式需要 App 中已有真实服务器资产。自动／来源选择先寻找满足接入数量的健康普通节点，不足时可选择同范围内一份合格提供方完整配置；固定节点使用所选节点。Raw 必须包含自己的真实代理图，不借用普通模式节点。

节点和 Raw 示例使用保留的示例域名与虚构 ID。必须替换为服务端提供的真实值；它们不是免费服务器。

26.10.2 配置新增项

Fragment 默认关闭，智能分流及各常规自定义路由分别保存设置。默认参数和模板规则见 Fragment 分片。

局域网代理共享. 共享开关与端口在下一次从 App 内启动或重启时生效，保存不会让当前 VPN 重连。

当前配置边界于 2026-10-31 对照 App 26.11.1 源码 565b5f3121862a899e2ed8e596d229e91af22d4c 核对，比较基线为 v26.10.5（73c1cb33fb755d8da324064225bff17734e590f6）。示例清单保留早期原生校验来源，本次文档核对没有重新执行这些示例。

26.10.3 配置新增项

Remnawave 完整订阅支持 Xray 对象／数组及独立的 App／提供方方式。路由设置为常规配置增加代理／直连 DNS 备用、托管嗅探和 roundRobin／leastPing，并向高级模板有限开放探测参数。解析器过滤／缓存覆盖和嗅探排除仍仅用于高级／Raw。JSON 提示涵盖 Core v26.10.10 的 XDNS names／addrs、MASQUE WARP 和 TLS useSystemCA；Lua 不属于 App 编辑／资源管理流程。

26.10.4 配置新增项

• 服务器拨号提供智能、常规自定义和全部使用 VPN 的统一域名解析与可选 Happy Eyeballs；高级模板、Raw JSON 和提供方完整配置保留各自拨号边界。
• 订阅支持每来源 User-Agent 和兼容默认值；完整配置逐项跳过无效项，当前方式仍须有可用条目。Remnawave 非 JSON 响应只有确认后才转为普通订阅。
• Apple 备份可绑定所选文件或 iCloud Drive，已有内容先选择恢复／覆盖。协议 v1 保留显式订阅 UA；全局拨号与显示排序仍属于本机设置。

26.10.5 配置新增项

• Raw 与提供方配置共用可移植 VPN 补充，缺少 DNS server 时仅在运行副本中补充隧道 DNS；显式 DNS 与规则继续由用户管理。
• JSON 提示按对象区分 XDrive template／XMUX、MASQUE XMUX、XDNS TLS／QUIC 和 TLS／ECH／REALITY，保留自由文本与未知字段。
• 托管 FakeDNS 使用 IPv6 池 2001:2::/48，显式池与 TUN 接口地址不变。
• 手动分组与位置使用备份 v1 可选字段保存，不创建自动连接范围。
• Xray-core 更新至 v26.10.21。

26.11.1 配置补充

• 智能／常规自定义增加其它 DNS 查询策略，默认代理；roundRobin 回退完整代理链。
• 新建 Fragment 默认配置使用 FinalMask，已有 Fragment／噪声对象保留；高级模板 Freedom 辅助出站可配置 FinalMask。
• 原生 JSON 入口与上下文提示覆盖 XDrive S3、Freedom finalRules；提示不表示普通订阅投影支持同样内容。
• 健康普通候选不足时，自动／来源选择可使用一份活动提供方完整配置。
• 备份 v1 保存匹配平台的 VPN 设置；Core geodata 定时下载仍由 App 接管。
• Xray-core 为 v26.10.29。