Merge pull request #12935 from zmstone/0426-improve-websocket-listener-config-mqtt_path-doc
docs: improve mqtt_path doc
This commit is contained in:
commit
70d2c6c6cd
|
@ -268,9 +268,15 @@ common_ssl_opts_schema_cacerts.desc:
|
||||||
common_ssl_opts_schema_cacerts.label:
|
common_ssl_opts_schema_cacerts.label:
|
||||||
"""Use System CA Certificates"""
|
"""Use System CA Certificates"""
|
||||||
|
|
||||||
fields_ws_opts_mqtt_path.desc:
|
fields_ws_opts_mqtt_path.desc: """~
|
||||||
"""WebSocket's MQTT protocol path. So the address of EMQX Broker's WebSocket is:
|
WebSocket's MQTT protocol path. By default, the full URL for the WebSocket client to connect is:
|
||||||
<code>ws://{ip}:{port}/mqtt</code>"""
|
`ws://{ip}:{port}/mqtt`.
|
||||||
|
Append `/[...]` to the end of the path to make EMQX accept any subpath.
|
||||||
|
For example, specifying `mqtt/[...]` would allow clients to connect at paths like
|
||||||
|
`mqtt/org1` or `mqtt/group2`, etc.
|
||||||
|
|
||||||
|
NOTE: An unmatched path will cause the client to be rejected immediately at the HTTP layer,
|
||||||
|
meaning it will not be traceable at the MQTT layer."""
|
||||||
|
|
||||||
fields_ws_opts_mqtt_path.label:
|
fields_ws_opts_mqtt_path.label:
|
||||||
"""WS MQTT Path"""
|
"""WS MQTT Path"""
|
||||||
|
|
|
@ -234,6 +234,7 @@ src
|
||||||
ssl
|
ssl
|
||||||
statsd
|
statsd
|
||||||
structs
|
structs
|
||||||
|
subpath
|
||||||
subprotocol
|
subprotocol
|
||||||
subprotocols
|
subprotocols
|
||||||
superset
|
superset
|
||||||
|
|
Loading…
Reference in New Issue