監聽&監聽發現 · ENVOY 智能代理中文參考文檔

## 監聽&監聽發現 Listener[架構概述](../v2APIreference/ListenersandLDS.md) - [Listener](#listener) - [Listener.DrainType (Enum)](#listenerdraintype-enum) - [Filter](#filter) - [FilterChainMatch](#filterchainmatch) - [FilterChain](#filterchain) ### Listener [Listener proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/lds.proto#L34) ``` { "name": "...", "address": "{...}", "filter_chains": [], "use_original_dst": "{...}", "per_connection_buffer_limit_bytes": "{...}", "drain_type": "..." } ``` - **name** ([string](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 配置該監聽器的唯一名稱。如果沒有提供名稱，Envoy將為監聽器分配一個內部UUID。如果要通過LDS動態更新或刪除偵聽器，則必須提供唯一的名稱。默認情況下，監聽器名稱的最大長度限制為60個字符。可以通過`--max-obj-name-len`命令行參數設置為所需的最大長度限制。 - **address** ([Address](../v2APIreference/Networkaddresses.md), REQUIRED) 監聽器應該監聽的地址。一般來說，地址必須是唯一的，盡管這是由操作系統的根據綁定規則管理的。例如，多個監聽器可以監聽Linux上的0端口，因為實際的端口將被OS分配。 - **filter_chains** ([FilterChain](#filterchain), REQUIRED) 這個監聽器需要使用的過濾器列表。`FilterChain`在連接上使用特殊的`FilterChainMatch`。注意：在當前版本中，僅支持多個過濾器鏈，因此可以配置SNI。有關如何配置SNI以獲取更多信息，請參閱[FAQ條目](../FAQ/HowdoIsetupSNI.md)。當配置多個過濾器鏈時，每個過濾器鏈必須具有相同的一組過濾器。如果過濾器不同，配置將無法加載。將來，這種限制將被放寬，使得根據哪個過濾器鏈匹配（基于SNI或其他參數）可以使用不同的過濾器。 - **use_original_dst** ([BoolValue](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#boolvalue)) 在連接重定向如果使用`iptables`，則代理接收連接的端口可能與原始目標地址不同。當此標志設置為`true`時，監聽器將重定向的連接切換到與原始目標地址關聯的監聽程序。如果沒有與原始目標地址關聯的監聽器，則連接由該監聽器的接收處理。默認為`false`。 - **per_connection_buffer_limit_bytes** ([UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#uint32value)) 監聽器的新連接讀取和寫入緩沖區大小的軟限制。如果未指定，則使用默認值定義（1MB）。 - **drain_type** ([Listener.DrainType](#listenerdraintype-enum)) 監聽器的級別，執行的逐出類型。 ### Listener.DrainType (Enum) [Listener.DrainType proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/lds.proto#L93) - **DEFAULT** (DEFAULT) 在調用`/healthcheck/fail`管理端口（連同健康檢查過濾器），監聽器刪除/修改以及熱重啟時，進行響應處理。 - **MODIFY_ONLY** 針對監聽器刪除/修改和熱啟動而響應處理。此設置不包括健康檢查失敗。如果Envoy僅當作入口和出口監聽器，這個設置是可取的。 ### Filter [Filter proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/lds.proto#L107) ``` { "name": "...", "config": "{...}" } ``` - **name** ([string](https://developers.google.com/protocol-buffers/docs/proto#scalar), REQUIRED) 要實例化的過濾器的名稱。該名稱必須與支持的過濾器匹配。內置的過濾器有： - [envoy.echo](../Configurationreference/Networkfilters/Echo.md) - [envoy.http_connection_manager](../Configurationreference/HTTPconnectionmanager.md) - [envoy.mongo_proxy](../Configurationreference/Networkfilters/Mongoproxy.md) - [envoy.redis_proxy](../Configurationreference/Networkfilters/Redisproxy.md) - [envoy.tcp_proxy](../Configurationreference/Networkfilters/TCPproxy.md) - **config** ([Struct](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#struct)) 對應的過濾器配置，這取決于被實例化的過濾器。有關更多文檔，請參閱支持的過濾器。 ### FilterChainMatch [FilterChainMatch proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/lds.proto#L134) 指定用于為監聽器選擇特定過濾器鏈的匹配條件。 ``` { "sni_domains": [] } ``` - **sni_domains** ([string](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 如果非空，則考慮`SNI`域名。可能包含通配符前綴，例如`*.example.com`的。注意: 有關如何配置SNI以獲取更多信息，請參閱[FAQ條目](../FAQ/HowdoIsetupSNI.md)。 ### FilterChain [FilterChain proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/lds.proto#L178) 過濾器鏈包含一組匹配條件，一個TLS上下文選項，一組過濾器和各種其他參數。 ``` { "filter_chain_match": "{...}", "tls_context": "{...}", "filters": [], "use_proxy_proto": "{...}" } ``` - **filter_chain_match** ([FilterChainMatch](#filterchainmatch)) 將連接匹配到此過濾器鏈時使用的匹配規則。 - **tls_context** ([DownstreamTlsContext](../v2APIreference/CommonTLSconfiguration.md)) 此過濾器鏈的TLS上下文配置。 - **filters** ([Filter](#filter)) 構成與監聽器建立連接的過濾器鏈，包含各個網絡過濾器的列表。當連接事件發生時，按順序處理。注意：如果過濾器列表為空，則默認關閉連接。 - **use_proxy_proto** ([BoolValue](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#boolvalue)) 監聽器是否應該在新連接上使用PROXY協議V1頭。如果啟用此選項，則監聽器將假定該連接的遠程地址是在標題中指定的地址。包括AWS ELB的一些負載平衡器支持此選項。如果該選項不存在或設置為`false`，Envoy將使用物理對等地址作為遠程連接地址。 ## 返回 - [上一級](../v2APIreference.md) - [首頁目錄](../README.md)