Marzban项目中SplitHttp协议Host头配置问题解析

在Marzban项目中使用自定义配置时，用户反馈了一个关于SplitHttp网络协议的特殊问题：当启用自定义配置后，通过主机设置或直接在核心配置中指定的Host头信息无法正确传递到生成的客户端配置中。本文将深入分析这一问题的技术背景和解决方案。

问题现象

用户在使用Marzban的自定义配置功能时发现：

1. 在SplitHttp网络协议下，通过GUI界面"Host Settings"设置的Host头不会出现在最终生成的配置中
2. 尝试直接在核心配置的headers字段添加host参数也无效
3. 该问题仅出现在SplitHttp协议，WS和HTTP Upgrade协议工作正常

技术分析

通过分析用户提供的配置示例和项目维护者的回复，我们可以理解到：

1. SplitHttp协议中有特殊的Host头处理机制，不同于其他协议直接在headers中设置host的方式
2. 正确的配置方式应使用splitHttpSettings中的host字段而非headers字段
3. 项目开发版本已修复此配置传递问题

配置建议

对于需要临时解决此问题的用户，建议采用以下配置方式：

服务端配置示例：

"streamSettings": {
  "network": "splitHttp",
  "splitHttpSettings": {
    "path": "/your-path",
    "host": "your.domain.com"
  }
}

客户端配置注意事项：

1. 确保tlsSettings中的serverName与host值一致
2. 目前需要手动添加host配置，等待稳定版更新

协议特性说明

SplitHttp作为一种特殊传输协议：

• 采用HTTP/2作为底层传输
• 支持请求拆分和并行传输
• 对Host头有特殊处理要求
• 性能优化参数丰富（如scMaxConcurrentPosts等）

总结

这个问题反映了协议实现细节与配置界面之间的差异。用户在Marzban中使用高级协议配置时，应当注意查阅对应协议的技术文档。项目维护团队已意识到此问题并在开发分支中修复，预计会在后续稳定版本中发布。在此期间，用户可通过直接配置splitHttpSettings的host字段来临时解决这一问题。

对于普通用户，如果不需要使用SplitHttp的高级特性，可以考虑暂时使用更成熟的WS协议作为替代方案。