Xray 配置格式与版本兼容性
这里的配置规范对应 OneXray 26.11.4,旧版本变化见升级说明。连接配置备份是独立的恢复格式,不是第四种配置导入类型。
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-corev1.260327.1-0.20260908222543-52a412d9e2f5。 - 示例清单记录每份文件的导入类型、依赖和替换要求。
上游当前文档可能比已安装内核更新。App 导入以 OneXray 的结构和托管边界为准,协议字段由配套 libXray 判定。不要混用其他客户端或旧 VMessQrCode 的格式。
当前配置边界于 2026-11-13 对照 App 26.11.4 源码 a9c690c3db9818a6c4fc78b74794967553d73048 核对,比较基线为 v26.11.3(2c66a8bf2277d08aac408d2984e459a3576bbf12)。连接选择、导入格式、DNS 托管边界和备份 v1 保持不变,本次更新涉及初始化、会话呈现、公共界面与桌面集成。示例清单保留早期原生校验来源,本次文档核对没有重新执行这些示例。
数量和资料要求
常规与高级自定义路由共用三份上限,名称唯一且为 1–32 个字符,每份以 1–3 个空接入槽开头,高级模板后面可以追加辅助出站。编辑时不转换类型。新增 Raw 最多三份;旧库超出三份的记录保留可用,隐藏添加入口。
普通模式需要 App 中已有真实服务器资产。自动/来源选择先寻找足量活动、可读取的普通节点,已有成功延迟优先,未测或失败的候选仍可用,启动不等待测速;数量不足时可选择同范围内一份合格提供方完整配置;固定节点使用所选节点。Raw 必须包含自己的真实代理图,不借用普通模式节点。
节点和 Raw 示例使用保留的示例域名与虚构 ID。必须替换为服务端提供的真实值;它们不是免费服务器。
26.10.2 配置新增项
Fragment 默认关闭,智能分流及各常规自定义路由分别保存设置。默认参数和模板规则见 Fragment 分片。
局域网代理共享. 共享开关与端口在下一次从 App 内启动或重启时生效,保存不会让当前 VPN 重连。
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。
26.11.2 行为与编辑器更新
- 连接选择不再要求成功测速;未测、失败或超时本身不触发提供方回退。活动资产、数量、最终出口与权限检查保留。
- 个人 Raw JSON从服务器 → 添加服务器新建,与普通节点 JSON 分开。Raw 与提供方完整配置的字段归属、导入格式不变。
- 路由、VPN 隧道和 Xray 使用独立主入口;JSON 编辑器为保留最小高度的完整页面。常规/高级路由及 Raw 配额不变。
- Apple 组件与控制中心复用最近保存的运行输入,不重新编译后来修改的 App 选择;备份 v1 与现有示例 JSON 不变。
- Xray-core 为 v26.10.31。
26.11.3 DNS 与服务器列表更新
- 托管 DNS 缺省值使用 TCP;显式保存的解析器、模板与启动缓存不迁移。
- 高级模板允许同名标签 loopback 辅助出站;新建模板以 TCP 经代理向原目标转发其它 DNS 记录,已有查询策略保持不变。
- Raw/提供方缺失 DNS 补充和服务器引导 DNS 从隧道 IP 派生 TCP 解析器 URL;隧道字段仍为 IP 字面量。
- 服务器可批量测速筛选后的节点列表,自动连接范围统一在连接页选择。
- Xray-core 仍为 v26.10.31。