HTTP头字段是指在超文本传输协议（HTTP）的请求和响应消息中的消息头部分。HTTP头字段可以根据需求自定义，因此在Web服务器和浏览器上可能存在非标准的HTTP头字段。本文介绍应用型负载均衡ALB（Application Load Balancer）支持的非标准头字段。

ALB支持的头字段

字段名 说明 适用监听协议
X-Forwarded-For 在您创建监听时，X-Forwarded-For头字段可以获取来访者客户端IP地址。
字段格式：
X-Forwarded-For: <client-ip-address>, <proxy1>, <proxy2>, …

ALB默认开启X-Forwarded-For头字段。目前ALB仅支持通过调用API来关闭X-Forwarded-For头字段，您可以通过调用UpdateListenerAttribute接口，将XForwardedForEnabled取值为false来关闭X-Forwarded-For头字段。

  • 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参数来添加、保留或移除头字段。