Layer-7 Custom Configuration

Last updated: 2021-07-07 10:08:22

    CLB supports custom configurations, allowing you to set the configuration parameters for a single CLB instance, such as client_max_body_size and ssl_protocols, so as to meet your unique needs.


    • Each region can have up to 200 entries of custom configurations.
    • Currently, each instance can be bound to only one entry of custom configuration.
    • Custom configurations are valid only for layer-7 HTTP/HTTPS CLB (former Application CLB) listeners.

    CLB Custom Configuration Parameter Descriptions

    Currently, CLB custom configuration supports the following fields:

    Configuration Field Default Value/Recommended Value Parameter Range Description
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1 TLSv1.1 TLSv1.2 Version of TLS protocol used; TLSv1.3 will be supported later.
    ssl_ciphers See further below See further below Encryption suite
    client_header_timeout 60s [30-120]s Timeout period of obtaining a client request header; in case of timeout, a 408 error will be returned.
    client_header_buffer_size 4k [1-256]k Size of default buffer where a client request header is stored.
    client_body_timeout 60s [30-120]s Timeout period of obtaining a client request body, which is not the time for obtaining the entire body but refers to the idle period without data transmission; in case of timeout, a 408 error will be returned.
    client_max_body_size 60M [1-10240]M
    • Default configuration range: 1 MB - 256 MB; it can be directly configured.
    • Maximum size: 2,048 MB; if client_max_body_size is more than 256 MB, the value of proxy_request_buffering must be "off".
    keepalive_timeout 75s [0-3600]s Client-server persistent connection hold time; if it is set to 0, persistent connection is prohibited.
    add_header Custom - Specific header field returned to the client in the format of add_header xxx yyy.
    more_set_headers Custom - Specific header field returned to the client in the format of more_set_headers "A:B".
    proxy_connect_timeout 4s [4-120]s Timeout period of upstream backend connection.
    proxy_read_timeout 60s [30-3600]s Timeout period of reading upstream backend response.
    proxy_send_timeout 60s [30-3600]s Timeout period of sending a request to the upstream backend.
    server_tokens on on, off
    • on: displays version information;
    • off: hides version information.
    keepalive_requests 100 [1-10000] Maximum number of requests that can be sent over the client-server persistent connection.
    proxy_buffer_size 4k [1-64]k Size of server response header, which is the size of a single buffer set in proxy_buffer by default; to use proxy_buffer_size, proxy_buffers must be set at the same time.
    proxy_buffers 8 4k [3-8] [4-8]k Buffer quantity and size.
    proxy_request_buffering on on, off
    • on: caches the client request body; the CLB instance caches the request and forwards it to the backend CVM instance in multiple parts after the request is completely received.
    • off: does not cache the client request body; after receiving a request, the CLB instance directly forwards it to the backend CVM instance, which increases pressure on the backend CVM performance.
    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-Real-Port $remote_port: client port.
    • X-clb-stgw-vip $server_addr: CLB VIP.
    • Stgw-request-id $stgw_request_id: request ID (used in CLB only).
    send_timeout 60s [1-3600]s Timeout period of data transfer from the server to the client, which is the time interval between two successive data transfer actions, not the entire request transfer period.
    ssl_verify_depth 1 [1,10] Verification depth of the client certificate chain.

    Requirements on the value of proxy_buffer_size and proxy_buffers: 2 * max (proxy_buffer_size, proxy_buffers.size) ≤ (proxy_buffers.num - 1)* proxy_buffers.size; For example, if proxy_buffer_size is "24k", proxy_buffers is "8 8k"; then 2 * 24k = 48k, (8 - 1)* 8k = 56k; and 48k ≤ 56k, so there will be no configuration error.

    ssl_ciphers Configuration Instructions

    The ssl_ciphers encryption suite being configured must be in the same format as that used by OpenSSL. The algorithm list is one or more <cipher strings="">; multiple algorithms should be separated with ":"; ALL represents all algorithms, "!" indicates not to enable an algorithm, and "+" indicates to move an algorithm to the last place.
    The encryption algorithm for default forced disabling is: !aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!DHE.

    Default value:


    Parameter range:


    CLB Custom Configuration Examples

    1. Log in to the CLB console and click Custom Configuration on the left sidebar.
    2. Click Create, fill in the configuration items and end them with ";".
    3. Click Completed.
    4. Click Bind to Instance.
    5. In the pop-up window, select a CLB instance of the same region, and click Submit.
    6. You can now view the corresponding custom configuration information on the instance list page.

    Default configuration sample code:

    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;