HAProxy 同一主机不同端口只一个 UP：检查 DNS 地址去重

一个 backend 配了多个 server，它们使用同一个主机名、不同应用端口，并启用了 HAProxy 的运行时 DNS resolver。DNS 返回地址正确，却只有一个 server 变成 UP，其余显示 MAINT、No IP for server。如果几个端口确实位于同一台主机，需要检查运行时解析的 IP 去重规则。

HAProxy 默认会在这类 backend 里避免给相同 FQDN 的多个 server 重复分配同一 IP。这里讨论的是有意共享 IP 的不同端口，不是给每个副本解析独立地址的服务发现配置。

地址查询成功，不等于地址已分配给每个 server

先对照实际 server 行：主机名是否相同，端口是否分别对应预期应用，resolvers 是否指向有效解析配置。再看运行状态中每个 server 的地址、管理状态和原因，而不只看其中一个健康检查结果。

如果运行时 DNS 只返回一个可用地址，一个 server 使用它，其余 server 因无可分配地址进入维护状态，这与去重路径一致。若日志显示 DNS 超时、NXDOMAIN，应先处理解析配置和 DNS 记录；添加允许重复 IP 的选项不能产生不存在的地址。

若多个 server 已得到预期 IP，但显示 DOWN、连接拒绝或 HTTP 检查失败，则地址分配已完成，需要检查对应端口上的应用和健康检查。不能把这些情况都归为 resolver 去重。

对有意共享地址的 server 允许重复 IP

确认这些端口本来就应该在同一主机上之后，可以使用 resolve-opts allow-dup-ip。以下是局部配置示例，假设名为 app_dns 的 resolver 已按实际环境配置，域名和端口须替换：

backend app_ports
    mode http
    server app_a apps.example.internal:8080 check resolvers app_dns resolve-opts allow-dup-ip
    server app_b apps.example.internal:8081 check resolvers app_dns resolve-opts allow-dup-ip

示例用于说明 server 选项，不包含 frontend 和 DNS 服务器定义。应将选项合入现有 server 行，保留原来的 TLS 校验、请求健康检查、超时和启动解析策略；不要用这两行覆盖整套生产配置。示例的普通 check 只做连接检查，不等于确认 HTTP 业务健康。

allow-dup-ip 允许共享地址，不保证始终选择同一地址。当前 HAProxy 3.2 文档明确：返回一个 IP 时，示例里的两个 server 可以使用它；返回两个 IP 时，仍可能分别选取不同地址。若应用要求它们严格绑定同一实例，应另外设计清晰的主机/端口映射，不能把这个选项当作绑定关系。

共享同一台主机的多个端口也不提供独立主机故障冗余。配置调整前应确认流量分配给每个端口都符合应用用途；两个完全不同的服务不能仅因能连接就混到同一个负载均衡池。

旧参数名与版本要分清

这一功能在 HAProxy 1.8 系列的相关回移中进入 1.8.14，发布使用的名称是 resolve-opts allow-dup-ip。早期补丁讨论中的 resolve-accept-dup-ip 不是该发布版可用的配置参数。

如果配置检查报 unknown keyword，先核对实际启动的 HAProxy 二进制版本及对应版本文档。旧版 1.8 不应作为新部署目标；升级到组织支持的版本时，还要审核完整配置和兼容变化，不能只凭这个参数在旧版出现就停止更新。

本条规则涉及运行时 DNS，不应扩展为“任何重复 IP 都会被 HAProxy 禁止”。静态地址、不同名称、不同 backend 和服务发现方式须按各自实际配置判断。

核对运行状态和真实应用响应

变更前保存当前配置及每个 server 的状态。通过实际运行二进制的配置检查后，按现有服务管理流程加载；确认加载失败时旧实例能继续工作，并有配置回退办法。加载方式及连接影响由现有部署决定，需要有受控变更窗口。

随后确认每个预期 server 都拿到正确地址和端口，维护状态不再由 No IP for server 引起。再分别检查应用健康状态，并通过 HAProxy 发起符合应用用途的请求，确认流量到达预期端口。

仅从 MAINT 变为 UP 还不够：连接检查通过时，应用仍可能返回错误页面或访问另一项服务。若只解决了地址分配而出现业务错误，继续检查应用与 HTTP 健康检查配置。回退时恢复原配置并按同一流程加载，再核对服务状态；回退不能自动撤销变更期间已经处理的业务请求。