XTLS/Xray-core 中 xhttp 传输模式的常见问题排查指南

问题现象分析

在使用 XTLS/Xray-core 的 xhttp 传输模式时，用户遇到了服务端报错 "invalid x_padding length:0" 的问题。从日志中可以观察到以下关键现象：

1. 服务端日志持续输出 "invalid x_padding length:0" 错误
2. Caddy 反向代理日志显示确实收到了带有 X-Padding 头的请求
3. 客户端连接尝试失败，返回 400 Bad Request 错误

技术背景解析

xhttp 是 Xray-core 中的一种新型传输协议，它通过 HTTP 请求伪装实现流量传输。与传统的 WebSocket 传输不同，xhttp 具有以下特点：

1. 使用标准 HTTP 请求和响应进行数据传输
2. 支持自动生成和验证 padding（填充数据）以增强安全性
3. 可以兼容 CDN 加速服务

问题根源定位

经过深入分析，发现问题出在 CDN 配置上。具体原因是：

1. 某些CDN服务默认配置会丢弃查询字符串(query string)
2. xhttp 协议依赖查询字符串中的特定参数进行协议握手
3. 服务端无法获取必要的握手信息，导致报错

解决方案实施

要解决这个问题，需要进行以下配置调整：

CDN 配置调整

1. 选择 "Legacy cache settings" 缓存策略
2. Headers 配置选择 "none"
3. Query string 处理选择 "all"（允许所有查询字符串通过）
4. Cookies 配置选择 "none"

服务端验证方法

验证配置是否生效的方法：

1. 检查服务端日志是否不再出现 "invalid x_padding length:0" 错误
2. 使用网络测速工具进行速度测试，确认连接正常
3. 观察客户端连接是否成功建立

性能优化建议

成功建立连接后，还可以考虑以下优化措施：

1. 调整 xhttp 的 padding 长度设置，平衡安全性和性能
2. 根据实际网络环境选择合适的 HTTP 版本（1.1 或 2）
3. 监控连接质量，适时调整 CDN 缓存策略

总结

xhttp 作为 Xray-core 的新型传输协议，在提供更好安全性的同时，也对基础设施配置提出了更精确的要求。通过正确配置 CDN 的查询字符串处理策略，可以充分发挥 xhttp 协议的优势，实现安全、稳定的连接。