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