修改網(wǎng)關參數(shù)
為了適應不同場景的變化，您可以對云原生API網(wǎng)關進行參數(shù)調整。通過合理調整參數(shù)，可以提升網(wǎng)絡的效能、可靠性和安全性，確保網(wǎng)絡的穩(wěn)定運行和用戶體驗。但是需要注意的是，修改網(wǎng)關參數(shù)可能會對網(wǎng)絡連接和應用程序的使用產(chǎn)生影響，因此在進行此類操作之前，請了解可修改參數(shù)的取值范圍及其作用。本文介紹如何修改網(wǎng)關參數(shù)以及參數(shù)詳情。
前提條件
已創(chuàng)建網(wǎng)關，具體操作，請參見創(chuàng)建云原生API網(wǎng)關。
操作步驟
為保證實例的穩(wěn)定運行，僅支持對控制臺中開放的參數(shù)進行修改，未在控制臺中呈現(xiàn)的參數(shù)不支持修改。
修改參數(shù)值時，請參見控制臺上網(wǎng)關引擎參數(shù)頁面中的取值范圍列。
在左側導航欄，選擇實例，并在頂部菜單欄選擇地域。
在實例頁面，單擊目標網(wǎng)關實例名稱。
在左側導航欄，選擇參數(shù)配置。在網(wǎng)關引擎參數(shù)區(qū)域，單擊目標參數(shù)操作列下方的編輯，根據(jù)下表設置您的參數(shù)值，并單擊確認。
網(wǎng)關引擎參數(shù)詳情
參數(shù)名 | 參數(shù)類型 | 取值范圍 | 默認值 | 參數(shù)描述 |
EnableHttp2 | bool | [true，false] | false | 作用于請求環(huán)節(jié)，服務端與客戶端協(xié)商時是否使用HTTP/2。
|
EnableGenerateRequestId | bool | [true，false] | true | 作用于請求范圍，根據(jù)配置會在請求頭中生成RequestId，即X-Request-Id，用于唯一定位請求。
|
EnableGzip | bool | [true，false] | false | 作用于請求與響應環(huán)節(jié)。
|
EnableSlashMerge | bool | [true，false] | false | 作用于請求環(huán)節(jié)，是否合并請求中多余的
|
DownstreamIdleTime | integer | [0，600] | 300 | 作用于網(wǎng)關連接，客戶端到網(wǎng)關在指定的時間內沒有請求，則會斷開連接。單位為秒。 |
PreserveHeaderFormat | bool | [true，false] | false | 作用于請求和響應環(huán)節(jié)，HTTP/1.1規(guī)范中Header頭不區(qū)分大小寫進行識別，為了保證與HTTP/2規(guī)范兼容，默認會統(tǒng)一轉化為小寫。
|
DownstreamConnectionBufferLimits | integer | [0，2147483647] | 32768 | 作用于網(wǎng)關連接，控制單條鏈接的緩沖區(qū)大小，配置后會影響吞吐量和網(wǎng)關的內存使用。單位為字節(jié)。 |
EnableHardwareAccelerate | bool | [true，false] | true | 作用于TLS加解密，是否開啟硬件加速。若您的地域不支持硬件加速或購買時未指定硬件加速，此參數(shù)會無法生效。
說明 由于底層硬件限制，目前僅華北2（北京）、華東1（杭州）、華東2（上海）、華南1（深圳）、亞太東南1（新加坡）地域支持硬件加速功能。 |
XffTrustedNum | integer | [0，10] | 0 | 作用于請求環(huán)節(jié)，網(wǎng)關前可信任的代理個數(shù)，會影響網(wǎng)關是否會使用客戶端產(chǎn)生的x-forwarded-for和x-request-id等請求頭。 若取值為0，會將對端Socket IP作為真實IP，并將其設置到x-envoy-external-address請求頭中傳遞給后端。 若取值非0，會根據(jù)取值從已經(jīng)附加了Socket IP的x-forwarded-for中，從右向左跳過對應的跳數(shù)，然后取出真實IP，并將該IP設置到x-envoy-external-address請求頭中傳遞給后端。同時，還會保留客戶端傳入的x-request-id和x-forwarded-proto請求頭，不做任何修改。 |
DownstreamHttp2MaxConcurrentStream | integer | [0，2147483647] | 100 | 作用于請求環(huán)節(jié)，客戶端使用HTTP2時一條鏈接上的最大并發(fā)數(shù)。單位為byte。 |
InitialStreamWindowSize | integer | [65535，2147483647] | 65535 | 作用于請求環(huán)節(jié)，網(wǎng)關與客戶端使用HTTP2時協(xié)商的Stream初始窗口大小。單位為byte。 |
InitialConnectionWindowSize | integer | [0，2147483647] | 1048576 | 作用于請求環(huán)節(jié)，網(wǎng)關與客戶端使用HTTP/2時連接級別初始窗口大小。單位為byte。 |
EnableHttp3 | bool | [true，false] | false | 作用于請求環(huán)節(jié)，決定下游與網(wǎng)關協(xié)商是否使用HTTP3。
|
UpstreamIdleTimeout | int | [0, 600] | 30 | 作用于網(wǎng)關連接，即在指定的時間內，網(wǎng)關到上游服務端若沒有請求，則會斷開連接。單位為秒。 |
PathWithEscapedSlashes | string |
| KEEP_UNCHANGED | 針對統(tǒng)一資源標識符（URI）路徑中包含的%2F、%2f、%5C或%5c等轉義字符的請求轉發(fā)策略。
|
ZipAlgorithm | List<string> | [brotli, gzip] | gzip | 開啟壓縮后使用的算法，可以選擇brotli或者gzip。 若同時設置了gzip和brotli，且Accept-Encoding中gzip和brotli的Q值相同的情況下，壓縮算法會選擇列表中靠前的值。 |
EnableProxyProtocol | bool | [true，false] | false | 開啟Proxy協(xié)議。如果網(wǎng)關入口流量使用NLB接入，不開啟則無法獲取客戶端的真實IP，開啟后對于非Proxy協(xié)議請求沒有影響。 |
EnableCustomAuthConfigPush | bool | [true，false] | false | 作用于使用自建的鑒權服務的場景，開啟后鑒權規(guī)則變更不會引起連接中斷，適用于WebSocket和在線業(yè)務場景。 |