x-ui项目Xray配置页面加载异常的排查与修复

问题现象分析

在使用x-ui项目时，用户遇到了Xray配置页面持续加载的问题。该问题发生在用户手动修改Xray配置文件后，导致无法通过Web界面进一步修改配置。更严重的是，即使用户尝试将配置文件替换为之前正常工作的版本，重启后系统仍会自动回滚到异常的配置文件。

配置文件对比

通过对比异常配置与正常配置，发现主要差异集中在以下几个方面：

1. 入站规则(inbounds)：异常配置中新增了一个自定义协议的入站配置，监听6034端口，使用WebSocket传输协议。

2. 出站规则(outbounds)：异常配置新增了一个标记为"tag_90"的自定义协议出站规则，并指定了特定的IPv6地址作为发送接口。

3. 路由规则(routing.rules)：异常配置新增了一条路由规则，将标记为"tag_90"的入站流量导向同名的出站。

根本原因定位

经过深入分析，发现问题出在路由规则的语法上。在Xray的配置规范中，inboundTag字段应该是一个字符串数组（array），而异常配置中直接使用了字符串。这种语法不规范导致Xray配置页面无法正确解析和显示配置内容。

正确的路由规则语法应该是：

{
  "type": "field",
  "inboundTag": ["tag_90"],
  "outboundTag": "tag_90"
}

解决方案

要解决这个问题，可以采取以下步骤：

1. 直接修改数据库文件：由于x-ui会将配置信息保存在x-ui.db数据库中，并在每次启动时将其同步到config.json文件，因此最彻底的解决方案是修改数据库文件。

2. 修正路由规则语法：确保所有路由规则中的inboundTag字段都是数组形式，即使只有一个标签也应放入数组中。

3. 重启服务：完成修改后，重启x-ui服务使更改生效。

技术要点总结

1. 配置语法严谨性：Xray的配置文件对语法要求非常严格，即使是看似微小的格式差异也可能导致功能异常。

2. 配置存储机制：x-ui采用了数据库持久化存储配置的方式，重启时会从数据库恢复配置，这解释了为什么直接修改config.json文件会被覆盖。

3. 调试技巧：当Web界面出现异常时，检查Xray核心日志和配置文件是首要的排查步骤。

最佳实践建议

1. 备份配置：在进行任何配置修改前，建议先备份x-ui.db和config.json文件。

2. 逐步修改：当需要添加复杂规则时，建议逐个添加并测试，便于定位问题。

3. 语法验证：可以使用在线JSON验证工具检查配置文件的语法正确性。

4. 版本兼容性：注意不同版本的Xray可能对配置语法有细微差异，升级时需特别注意。

通过理解这些技术细节，用户可以更好地管理和维护x-ui项目的Xray配置，避免类似问题的发生。