Listener configurations

The listener configurations of MOSN.

This topic describes the listener configurations of MOSN.

  • You can specify the ports on which MOSN listens upon startup and the specific logic corresponding to the ports in listener configurations.
  • You can supplement or modify listener configurations through dynamic listener APIs.


The name of a listener that is used to uniquely distinguish it from other listeners. If this parameter is left empty, a UUID will be generated by the system as a name by default. When you dynamically upgrade a listener by using its name as the index, a new listener is added if the name does not exist. If the name exists, the listener is updated.


The type of the listener. Valid values ingress and egress. Different types of listeners generate different trace logs.


The string in the IP:Port format. This is the unique address to which the listener listens.


Boolean. Specifies whether the listener will occupy the address specified for the address parameter. Set this parameter to True in most cases.


Boolean. Used for transparent proxying.


Settings for a group of access logs.


Settings for a group of filter chains. However, MOSN only supports one filter_chain currently.


Settings for a group of stream_filters. Currently, this parameter is valid only when the filter configured in filter_chain contains proxy.


Boolean. Specifies whether to allow the listener to handle non-TLS requests even when TLS listener is enabled in filter_chain. Valid values: True and False.


The duration string, which specifies the timeout value of an idle string. MOSN closes a connection of a listener when its idle duration exceeds the configured idle connection timeout value.


The FilterChain configurations of MOSN.

Network Filter

The network filter configurations.

Last modified March 29, 2024: publish other HTNN modules (#254) (a044220)