跳至内容
版本与兼容性

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-core v1.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。

26.11.4 界面与桌面更新

  • 初始化显示两步进度;连接页合并运行身份与会话统计,断开时保留稳定占位。
  • 公共页面精简标签和间距,并跟随系统减少动效偏好;Linux 使用系统窗口装饰。
  • 配置导入、选择、保存的 DNS 与运行输入边界、备份 v1 保持不变;本次界面更新不改写已保存配置或缓存。
  • Xray-core 为 v26.11.9。
最后更新于