# Xray 配置格式与版本兼容性

Source: https://onexray.com/zh/docs/configuration/compatibility/
Description: 导入前核对 OneXray 支持的 JSON 与分享链接格式、路由限制和内置 Xray-core 的配置要求。


这里的配置规范对应 **OneXray 26.9.3**，旧版本变化见[升级说明](https://onexray.com/zh/docs/upgrading/)。[连接配置备份](https://onexray.com/zh/docs/backup/)是独立的恢复格式，不是第四种配置导入类型。

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 导入边界以[配置规范](https://onexray.com/zh/docs/configuration/)为准，示例验证依据记录在下方清单中。
- App 的获取方式见[安装指南](https://onexray.com/zh/docs/install/)。
- 本次文档示例校验使用 libXray `c145d94071088cebd445d7b0f4b1bea35732011e`、Xray-core `v1.260327.1-0.20260908222543-52a412d9e2f5`。
- [示例清单](https://onexray.com/examples/manifest.json)记录每份文件的导入类型、依赖和替换要求。

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

## 数量和资料要求

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

普通模式需要已有真实节点。自动/分组选择必须有足够的合格、不同节点；固定单个节点时使用该节点。Raw 必须包含自己的真实出站，不借用普通模式当前节点。

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