HAProxy 3.0 DNS服务模板TCP健康检查问题分析
在HAProxy 3.0开发版本中发现了一个与DNS服务模板和TCP健康检查相关的重要问题。这个问题会影响使用DNS动态发现(A记录)结合TCP健康检查的场景,当DNS记录消失后又重新出现时,健康检查会失败,导致服务不可用。
问题现象
当配置了基于DNS的服务模板,并且使用TCP健康检查时,如果某个DNS条目暂时消失后又重新出现,HAProxy的健康检查会报告"L4连接拒绝"错误。尽管服务器实际上是可达的,但HAProxy会错误地将对应服务器标记为下线状态。
通过抓包分析可以观察到,在正常情况下健康检查会向配置的端口(如8000)发送TCP SYN包。但在DNS记录重新出现后,健康检查会错误地向端口0发送连接请求,这显然会导致连接被拒绝。
技术背景
HAProxy支持通过DNS动态发现后端服务器,这是通过server-template配置实现的。当结合TCP健康检查时,HAProxy会定期向服务器的指定端口发起TCP连接来验证其可用性。
在HAProxy 3.0-dev1版本中,引入了一个重要的修改(64c9c8ef39),目的是修复DNS解析相关的竞态条件问题。这个修改改变了服务器地址和端口的重置方式,使用新的server_set_inetaddr()函数来统一处理地址更新。
问题根源
经过深入分析,发现问题出在地址重置的逻辑上。当DNS记录消失时,HAProxy会清除服务器的地址信息,但在3.0-dev1的修改中,错误地将端口信息也一并清除了。对于A/AAAA记录,端口信息应该来自配置文件而不是DNS记录,因此不应该在DNS解析失败时清除端口。
具体来说,在以下情况下会出现问题:
- 初始状态下,服务器地址和端口都正确设置
- DNS记录消失,HAProxy清除地址和端口
- DNS记录重新出现,HAProxy重新设置地址,但端口保持为0
- 健康检查尝试连接端口0,导致失败
解决方案
修复方案的核心思想是:对于A/AAAA记录,在DNS解析失败时只清除地址信息而保留端口信息。只有在处理SRV记录超时时才需要同时清除地址和端口。
具体修改包括:
- 在
resolv_srvrq_cleanup_srv()中保持同时清除地址和端口的行为(SRV记录需要) - 在其他DNS回调函数中修改为只清除地址而保留端口
- 使用
server_get_inetaddr()获取当前地址信息,仅清除地址部分
影响范围
这个问题从HAProxy 3.0-dev1版本开始存在,影响所有后续开发版本,直到修复为止。2.9及更早版本不受影响。
最佳实践建议
对于生产环境用户,建议:
- 如果使用DNS服务模板和TCP健康检查,暂时避免使用3.0-dev1到dev12版本
- 等待包含修复的正式版本发布后再升级
- 测试环境中可以验证修复后的版本是否解决了问题
- 监控HAProxy日志中是否有"Connection refused"错误,特别是端口为0的情况
这个问题提醒我们,在复杂的网络代理场景中,地址管理和健康检查机制的交互需要特别小心,任何改动都可能产生意想不到的副作用。
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0153- DDeepSeek-V4-ProDeepSeek-V4-Pro(总参数 1.6 万亿,激活 49B)面向复杂推理和高级编程任务,在代码竞赛、数学推理、Agent 工作流等场景表现优异,性能接近国际前沿闭源模型。Python00
LongCat-Video-Avatar-1.5最新开源LongCat-Video-Avatar 1.5 版本,这是一款经过升级的开源框架,专注于音频驱动人物视频生成的极致实证优化与生产级就绪能力。该版本在 LongCat-Video 基础模型之上构建,可生成高度稳定的商用级虚拟人视频,支持音频-文本转视频(AT2V)、音频-文本-图像转视频(ATI2V)以及视频续播等原生任务,并能无缝兼容单流与多流音频输入。00
auto-devAutoDev 是一个 AI 驱动的辅助编程插件。AutoDev 支持一键生成测试、代码、提交信息等,还能够与您的需求管理系统(例如Jira、Trello、Github Issue 等)直接对接。 在IDE 中,您只需简单点击,AutoDev 会根据您的需求自动为您生成代码。Kotlin03
Intern-S2-PreviewIntern-S2-Preview,这是一款高效的350亿参数科学多模态基础模型。除了常规的参数与数据规模扩展外,Intern-S2-Preview探索了任务扩展:通过提升科学任务的难度、多样性与覆盖范围,进一步释放模型能力。Python00
skillhubopenJiuwen 生态的 Skill 托管与分发开源方案,支持自建与可选 ClawHub 兼容。Python0112