API 文档

七层个性化配置

最近更新时间:2021-10-12 15:56:06

CLB 支持个性化配置功能,允许用户设置单 CLB 实例的配置参数,如 client_max_body_size,ssl_protocols 等,满足您的个性化配置需求。

说明:

  • 个性化配置的个数限制为每个地域200条。
  • 个性化配置的长度限制为64k。
  • 当前一个实例仅允许绑定一个个性化配置。
  • 个性化配置仅针对负载均衡(原“应用型负载均衡”)的七层 HTTP/HTTPS 监听器生效。

CLB 个性化配置参数说明

当前 CLB 的个性化配置支持如下字段:

配置字段 默认值/建议值 参数范围 说明
ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3 TLSv1 TLSv1.1 TLSv1.2 TLSv1.3 使用的 TLS 协议版本。
ssl_ciphers 见下文 见下文 加密套件。
client_header_timeout 60s [30-120]s 获取到 Client 请求头部的超时时间, 超时返回408。
client_header_buffer_size 4k [1-256]k 存放 Client 请求头部的默认 Buffer 大小。
client_body_timeout 60s [30-120]s 获取 Client 请求 Body 的超时时间,不是获取整个 Body 的持续时间,而是指空闲一段时间没有传输数据的超时时间,超时返回408。
client_max_body_size 60M [1-10240]M
  • 默认配置范围为1M-256M,直接配置即可。
  • 最大支持10240M,即10G。当 client_max_body_size 的配置范围大于256M时, 必须设置 proxy_request_buffering 的值为 off。
keepalive_timeout 75s [0-900]s Client-Server 长连接保持时间,设置为0则禁用长连接。如需设置超过900s,请提交 工单申请,最大可设置到3600s。
add_header 用户自定义添加 - 向客户端返回特定的头部字段,格式为 add_header xxx yyy。
more_set_headers 用户自定义添加 - 向客户端返回特定的头部字段,格式为 more_set_headers "A:B"。
proxy_connect_timeout 4s [4-120]s upstream 后端连接超时时间。
proxy_read_timeout 60s [30-3600]s 读取 upstream 后端响应超时时间。
proxy_send_timeout 60s [30-3600]s 向 upstream 后端发送请求的超时时间。
server_tokens on on,off
  • on 表示显示版本信息。
  • off 表示隐藏版本信息。
keepalive_requests 100 [1-10000] Client-Server 长连接上最多能发送的请求数量。
proxy_buffer_size 4k [1-32]k Server 响应头的大小,默认为 proxy_buffer 中设置的单个缓冲区大小,使用 proxy_buffer_size 时,必须同时设置 proxy_buffers。
proxy_buffers 8 4k [3-8] [4-16]k 缓冲区数量和缓冲区大小。
proxy_request_buffering on on,off
  • on 表示缓存客户端请求体:CLB 会缓存请求,全部接收完成后再分块转发给后端 CVM。
  • off 表示不缓存客户端请求体:CLB 收到请求后,立即转发给后端 CVM,此时会导致后端 CVM 有一定性能压力。
proxy_set_header X-Real-Port $remote_port
  • X-Real-Port $remote_port
  • X-clb-stgw-vip $server_addr
  • Stgw-request-id $stgw_request_id
  • X-Forwarded-Port $vport
  • X-Method $request_method
  • X-Uri $uri
  • X-Forwarded-Proto
  • X-Real-Port $remote_port 表示客户端端口。
  • X-clb-stgw-vip $server_addr 表示 CLB 的 VIP。
  • Stgw-request-id $stgw_request_id 表示请求 ID(CLB 内部使用)。
  • X-Forwarded-Port 表示 CLB 监听器的端口。
  • X-Method 表示客户端请求方法。
  • X-Uri 表示客户端请求路径URI。
  • X-Forwarded-Proto 表示 CLB 监听器的协议(默认已支持,无需单独配置)。
send_timeout 60s [1-3600]s 服务端向客户端传输数据的超时时间,是连续两次发送数据的间隔时间,非整个请求传输时间。
ssl_verify_depth 1 [1,10] 设置客户端证书链中的验证深度。
proxy_redirect http:// https:// http:// https:// 当上游服务器返回的响应是重定向或刷新请求(如 HTTP 响应码是301或者302)时,proxy_redirect 重设 HTTP 头部的 Location 或 Refresh 字段中的 http 为 https,实现安全跳转。
ssl_early_data off on,off 启用或禁止 TLS 1.3 0-RTT。仅当 ssl_protocols 字段取值包含 TLSv1.3 时,开启 ssl_early_data 才会生效。开启 ssl_early_data 后,有重放攻击的风险,请谨慎开启。
http2_max_field_size 4k [1-256]k 限制 HPACK 压缩的请求头字段的最大大小( Size )。
error_page - error_page code [ = [ response]] uri 当发生特定错误码(Code)的时候,能够显示一个预定义的 URI,默认状态码(Response)为302。URI 必须是以 / 开头的路径。
proxy_ignore_client_abort off on,off 当客户端不等待响应结果主动中断与 CLB 的连接时,配置 CLB 与后端服务器的连接是否中断。
说明:

其中,proxy_buffer_size 和 proxy_buffers 配置的值需要满足约束条件:2 * max(proxy_buffer_size, proxy_buffers.size) ≤(proxy_buffers.num - 1)* proxy_buffers.size。例如,配置 proxy_buffer_size 为 24k,proxy_buffers 为 8 8k,则2 * 24k = 48k,(8 - 1)* 8k = 56k,此时 48k ≤ 56k,因此配置不会报错,否则报错。

ssl_ciphers 配置说明

配置 ssl_ciphers 加密套件时,格式需同 OpenSSL 使用的格式保持一致。算法列表是一个或多个<cipher strings>,多个算法间使用“:”隔开,ALL 表示全部算法,“!”表示不启用该算法,“+”表示将该算法排到最后一位 。
默认强制禁用的加密算法为:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!DHE

默认值:

ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-CHACHA20-POLY1305:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128:AES256:AES:HIGH:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!DHE:3DES;

参数范围:

ECDH-ECDSA-AES128-SHA256:ECDH-RSA-AES256-SHA:ECDH-ECDSA-AES256-SHA:SRP-DSS-AES-256-CBC-SHA:SRP-AES-128-CBC-SHA:ECDH-RSA-AES128-SHA256:DH-RSA-AES128-SHA256:DH-RSA-CAMELLIA128-SHA:DH-DSS-AES256-GCM-SHA384:DH-RSA-AES256-SHA256:AES256-SHA256:SEED-SHA:CAMELLIA256-SHA:ECDH-RSA-AES256-SHA384:ECDH-ECDSA-AES128-GCM-SHA256:DH-RSA-AES128-SHA:DH-RSA-AES128-GCM-SHA256:DH-DSS-AES128-SHA:ECDH-RSA-AES128-SHA:DH-DSS-CAMELLIA256-SHA:SRP-AES-256-CBC-SHA:DH-DSS-AES128-SHA256:SRP-RSA-AES-256-CBC-SHA:ECDH-ECDSA-AES256-GCM-SHA384:ECDH-RSA-AES256-GCM-SHA384:DH-DSS-AES256-SHA256:ECDH-ECDSA-AES256-SHA384:AES128-SHA:DH-DSS-AES128-GCM-SHA256:AES128-SHA256:DH-RSA-SEED-SHA:ECDH-ECDSA-AES128-SHA:IDEA-CBC-SHA:AES128-GCM-SHA256:DH-RSA-CAMELLIA256-SHA:CAMELLIA128-SHA:DH-RSA-AES256-GCM-SHA384:SRP-RSA-AES-128-CBC-SHA:SRP-DSS-AES-128-CBC-SHA:ECDH-RSA-AES128-GCM-SHA256:DH-DSS-CAMELLIA128-SHA:DH-DSS-SEED-SHA:AES256-SHA:DH-RSA-AES256-SHA:kEDH+AESGCM:AES256-GCM-SHA384:DH-DSS-AES256-SHA:HIGH:AES128:AES256:AES:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!DHE

CLB 个性化配置示例

  1. 登录 负载均衡控制台,在左侧导航栏单击个性化配置
  2. 在管理页面,单击新建,填写相应的配置项,并且以;结尾。
  3. 单击完成,完成个性化配置的创建。
  4. 在管理页面的操作栏下,单击绑定至实例
  5. 在弹框中选择绑定到同地域的 LB 实例,单击提交
  6. 绑定实例后,可以在实例的列表页中找到对应的个性化配置信息。

    默认配置代码示例:
    ssl_protocols   TLSv1 TLSv1.1 TLSv1.2;
    client_header_timeout   60s;
    client_header_buffer_size   4k;
    client_body_timeout    60s;
    client_max_body_size   60M;
    keepalive_timeout    75s;
    add_header     xxx yyy;
    more_set_headers      "A:B";
    proxy_connect_timeout    4s;
    proxy_read_timeout    60s;
    proxy_send_timeout    60s;
目录