全部产品
Search

搜索本产品

    负载均衡：HTTP头字段

    文档中心

    负载均衡：HTTP头字段

    更新时间：Dec 26, 2023

    如果您需要自定义HTTP头字段，并希望通过ALB监听的附加HTTP头字段实现部分特定功能，您可以通过本文查看ALB支持的附加头字段及如何添加附加HTTP头字段。

    ALB支持的附加头字段

    HTTP头字段是指在超文本传输协议（HTTP）的请求和响应消息中的消息头部分。HTTP头字段可以根据需求自定义，因此在Web服务器和浏览器上可能存在非标准的HTTP头字段。下表列出了ALB支持的附加头字段及相关说明。

    字段名

    说明

    适用监听协议

    X-Forwarded-For

    在您创建监听时，X-Forwarded-For头字段可以获取来访者客户端IP地址。

    字段格式：

    X-Forwarded-For: <client-ip-address>, <proxy1>, <proxy2>, …

    ALB默认开启X-Forwarded-For头字段。

    ALB如何获取客户端真实IP教程，请参见通过ALB获取客户端真实IP。

    • HTTP

    • HTTPS

    SLB-ID

    在您创建监听时，可以通过开启SLB-ID头字段来获取负载均衡实例ID。

    • HTTP

    • HTTPS

    • QUIC

    X-Forwarded-Proto

    在您创建监听时，可以通过开启X-Forwarded-Proto头字段来获取客户端与负载均衡监听连接时所用的协议。您的应用可以使用存储在X-Forwarded-Proto头字段中的协议来重定向至目标URL。

    字段格式：

    X-Forwarded-Proto: <originatingProtocol>

    • HTTP

    • HTTPS

    • QUIC

    X-Forwarded-Port

    在您创建监听时，可以通过开启X-Forwarded-Port头字段来获取客户端与负载均衡监听连接时所用的端口。

    字段格式：

    X-Forwarded-Port: <port>

    • HTTP

    • HTTPS

    • QUIC

    X-Forwarded-Clientcert-subjectdn

    在您创建监听时，可以通过开启X-Forwarded-Clientcert-subjectdn头字段获取访问负载均衡实例客户端证书的所有者信息。

    开启该头字段后，您需输入自定义的HTTP头名称。

    HTTPS

    X-Forwarded-Clientcert-issuerdn

    在您创建监听时，可以通过开启X-Forwarded-Clientcert-issuerdn头字段获取访问负载均衡实例客户端证书的发行者信息。

    开启该头字段后，您需输入自定义的HTTP头名称。

    HTTPS

    X-Forwarded-Clientcert-fingerprint

    在您创建监听时，可以通过开启X-Forwarded-Clientcert-fingerprint头字段获取访问负载均衡实例客户端证书的指纹取值。

    开启该头字段后，您需输入自定义的HTTP头名称。

    HTTPS

    X-Forwarded-Clientcert-clientverify

    在您创建监听时，可以通过开启X-Forwarded-Clientcert-clientverify头字段获取对访问负载均衡实例客户端证书的校验结果。

    开启该头字段后，您需输入自定义的HTTP头名称。

    HTTPS

    X-Forwarded-Client-srcport

    在您创建监听时，可以通过开启X-Forwarded-Client-srcport头字段获取访问负载均衡实例客户端的端口。

    字段格式：

    X-Forwarded-Client-srcport: <port>

    • HTTP

    • HTTPS

    在控制台附加HTTP头字段

    在创建监听时附加HTTP头字段

    1. 登录应用型负载均衡ALB控制台。

    2. 在顶部菜单栏，选择ALB实例所属的地域。

    3. 选择以下一种方法，打开监听配置向导。

      • 在实例页面，在目标实例操作列单击创建监听。

      • 在实例页面，单击目标实例ID。单击监听页签，然后单击创建监听。

    4. 在配置监听配置向导，完成以下配置，然后单击下一步。

      监听配置

      说明

      选择监听协议

      选择监听的协议类型。

      高级配置

      单击修改展开高级配置。

      附加HTTP头字段

      根据您的业务需求，选择您需要开启的自定义HTTP头字段。

      说明

      此处只罗列头字段相关的配置信息，更多配置参数，请参见：

    5. 根据界面提示，完成创建监听后续的配置步骤。

    为已创建的监听附加HTTP头字段

    1. 登录应用型负载均衡ALB控制台。

    2. 在顶部菜单栏，选择ALB实例所属的地域。

    3. 在实例页面，单击目标实例ID。

    4. 单击监听页签，在目标监听操作列选择更多>编辑监听。

    5. 在编辑监听对话框，单击高级配置右侧单击修改。

    6. 在附加HTTP头字段区域添加、保留或移除头字段，然后单击保存。

    使用API附加HTTP头字段

    您可以在创建监听时附加头字段，也可以为已创建的监听添加、保留或移除头字段。

    相关文档

    控制台操作文档

    API文档

    • CreateListener：在创建HTTP、HTTPS或QUIC监听时通过设置XForwardedForConfig来添加HTTP头字段。

    • UpdateListenerAttribute：在更新监听的配置时通过更新XForwardedForConfig参数来添加、保留或移除头字段。