Bridges are a non-standard way, although kind of a de-facto standard among MQTT broker implementations, to connect a single broker to a different broker. This allows for example that a topic tree of a remote broker gets part of the topic tree on the local broker. VerneMQ supports plain TCP connections as well as SSL connections.
in VerneMQ the bridge is distributed with VerneMQ as a plugin and is not enabled by default. After configuring the bridge as described below, make sure to enable the plugin by setting:
plugins.vmq_bridge = on
See Managing plugins for more information on working with plugins.
Setup a bridge to a remote broker:
vmq_bridge.tcp.br0 = 192.168.1.12:1883
Different connection parameters can be set:
# use a clean session (defaults to 'off') vmq_bridge.tcp.br0.cleansession = off | on # set the client id (defaults to 'auto', which generates one) vmq_bridge.tcp.br0.client_id = auto | my_bridge_client_id # set keepalive interval (defaults to 60 seconds) vmq_bridge.tcp.br0.keepalive_interval = 60 # set the username and password for the bridge connection vmq_bridge.tcp.br0.username = my_bridge_user vmq_bridge.tcp.br0.password = my_bridge_pwd # set the restart timeout (defaults to 10 seconds) vmq_bridge.tcp.br0.restart_timeout = 10 # VerneMQ indicates other brokers that the connection # is established by a bridge instead of a normal client. # This can be turned off if needed: vmq_bridge.tcp.br0.try_private = off
Define the topics the bridge should incorporate in its local topic tree, or the topics it should export to the remote broker. We share a similar configuration syntax as the Mosquitto broker:
topic [[[ out | in | both ] qos-level] local-prefix remote-prefix]
topic defines a topic pattern that is shared between the two brokers. Any topics matching the pattern (which may include wildcards) are shared. The second parameter defines the direction that the messages will be shared in, so it is possible to import messages from a remote broker using
in, export messages to a remote broker using
out or share messages in
both directions. If this parameter is not defined, VerneMQ defaults to
out. The QoS level defines the publish/subscribe QoS level used for this topic and defaults to
0. (Source: mosquitto.conf)
remote-prefix can be used to prefix incoming or outgoing publish messages.
Warning: Currently the
# wildcard is treated as a comment from the configuration parser, please use
A simple example:
# share messages in both directions and use QoS 1 vmq_bridge.tcp.br0.topic.1 = /demo/+ both 1 # import the $SYS tree of the remote broker and # prefix it with the string 'remote' vmq_bridge.tcp.br0.topic.2 = $SYS/* in remote
SSL bridges support the same configuration parameters as TCP bridges, but need further instructions for handling the SSL specifics:
# define the CA certificate file or the path to the # installed CA certificates vmq_bridge.ssl.br0.cafile = cafile.crt #or vmq_bridge.ssl.br0.capath = /path/to/cacerts # if the remote broker requires client certificate authentication vmq_bridge.ssl.br0.certfile = /path/to/certfile.pem # and the keyfile vmq_bridge.ssl.br0.keyfile = /path/to/keyfile # disable the verification of the remote certificate (defaults to 'off') vmq_bridge.ssl.br0.insecure = off # set the used tls version (defaults to 'tlsv1.2') vmq_bridge.ssl.br0.tls_version = tlsv1.2