修改网关参数配置

为了适应不同场景的变化,您可以对AI网关进行参数调整。通过合理调整参数,可以提升网络的效能、可靠性和安全性,确保网络的稳定运行和用户体验。但是需要注意的是,修改网关参数可能会对网络连接和应用程序的使用产生影响,因此在进行此类操作之前,请了解可修改参数的取值范围及其作用。本文介绍如何修改网关参数以及参数详情。

操作步骤

说明
  • 为保证实例的稳定运行,仅支持对控制台中开放的参数进行修改,未在控制台中呈现的参数不支持修改。

  • 修改网关引擎参数值时,请参考网关引擎参数页面中的取值范围。

  1. 登录AI网关控制台

  2. 在左侧导航栏,选择实例,并在顶部菜单栏选择地域。

  3. 实例页面,单击目标网关实例ID。

  4. 在左侧导航栏,选择参数配置。在网关引擎参数区域,单击目标参数操作列下的编辑,根据下表设置您的参数值,并单击确认

    参数名称

    参数类型

    取值范围

    默认值

    参数描述

    DownstreamConnectionBufferLimits

    int64

    [0, 2147483647]

    32768

    作用于网关连接,单条链接的buffer大小,配置后会影响吞吐和网关的内存使用, 单位byte。

    PathWithEscapedSlashes

    string

    • KEEP_UNCHANGED

    • REJECT_REQUEST

    • UNESCAPE_AND_REDIRECT

    • UNESCAPE_AND_FORWARD

    KEEP_UNCHANGED

    确定 URI 路径中包含 %2F、%2f、%5C 或 %5c 这些转义的请求的操作, 默认为KEEP_UNCHANGED(保持不变)。

    DownstreamIdleTime

    int32

    [0, 600]

    180

    客户端到网关处于指定的时间内[0-600]没有请求,则会断开链接。重启才会生效。

    EnableHardwareAccelerate

    bool

    [true, false]

    true

    将 TLS 证书的验证和卸载转移到硬件中执行,可大幅提高 HTTPS 请求的性能。

    InitialStreamWindowSize

    int64

    [65535, 2147483647]

    65535

    作用于请求环节,网关同客户端使用http2时协商的stream初始窗口大小。

    UpstreamIdleTimeout

    int32

    [0, 600]

    30

    默认到上游的idle时间。

    ZipAlgorithm

    array

    [gzip, brotli]

    gzip

    开启压缩后使用的算法,可以选择brotli,gzip,如果此时EnableGzip未开启,将自动开启EnableGzip选项。

    EnableCustomAuthConfigPush

    bool

    [true, false]

    false

    作用于使用自建的鉴权服务的场景,开启后鉴权规则变更不会引起连接中断,适用于WebSocket和在线业务场景。

    EnableProxyProtocol

    bool

    [true, false]

    true

    是否开启Proxy协议,如果网关入口流量使用NLB接入,如果不开启则无法获取客户端的真实IP,开启后对于非Proxy协议请求没有影响。

    PreserveHeaderFormat

    bool

    [true, false]

    false

    是否保持header头大小写, http1.1规范中 header头不区分大小写进行识别,为了保证与http2规范兼容,默认会统一转化为小写。

    KeepAliveHeaderTimeout

    int32

    [0, 600]

    0

    用于生成Keep-Alive响应头返回给客户端,告知连接的保活时间。例如配置为10时,会返回响应头:'keep-alive: timeout=10'。配置为0时,不会返回该响应头。

    EnableHttp3

    bool

    [true, false]

    false

    是否开启http3。

    AlwaysSetRequestIdInResponse

    bool

    [true, false]

    true

    用于控制在响应中是否始终包含请求ID。

    EnableGzip

    bool

    [true, false]

    false

    作用于请求与响应环节,启用gzip会对请求响应进行压缩,会减少网关流量,增加网关cpu消耗。

    InitialConnectionWindowSize

    int64

    [65535, 2147483647]

    1048576

    作用于请求环节,网关同客户端使用http2时连接级别初始窗口大小。

    DownstreamHttp2MaxConcurrentStream

    int64

    [0, 2147483647]

    100

    作用于请求环节,客户端使用http2时一条链接上最大并发数。

    EnableSlashMerge

    bool

    [true, false]

    false

    作用于请求环节,是否合并请求中多余的‘/’, 开启后www.a.com//b多余的'/'会被合并,将会同www.a.com/b一致。

    EnableGenerateRequestId

    bool

    [true, false]

    true

    作用于请求范围,根据配置会在请求头中生成requestId,以便追踪请求。

    WebsocketTermGracePeriod

    int32

    [20, 900]

    20

    当网关实例升级、重启等需要关闭连接的场景下,为Websocket连接维持的保活时间。

    XffTrustedNum

    int32

    [0, 10]

    0

    作用于请求环节,网关前可信任的代理个数,会影响网关是否会使用客户端产生的x-forwarded-forx-request-id等请求头。