| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087 |
- ##====================================================================
- ## EMQ X Configuration R3.0
- ##====================================================================
- ##--------------------------------------------------------------------
- ## Cluster
- ##--------------------------------------------------------------------
- ## Cluster name.
- ##
- ## Value: String
- cluster.name = emqxcl
- ## Specify the erlang distributed protocol.
- ##
- ## Value: Enum
- ## - inet_tcp: the default; handles TCP streams with IPv4 addressing.
- ## - inet6_tcp: handles TCP with IPv6 addressing.
- ## - inet_tls: using TLS for Erlang Distribution.
- ##
- ## vm.args: -proto_dist inet_tcp
- cluster.proto_dist = inet_tcp
- ## Cluster auto-discovery strategy.
- ##
- ## Value: Enum
- ## - manual: Manual join command
- ## - static: Static node list
- ## - mcast: IP Multicast
- ## - dns: DNS A Record
- ## - etcd: etcd
- ## - k8s: Kubernates
- ##
- ## Default: manual
- cluster.discovery = manual
- ## Enable cluster autoheal from network partition.
- ##
- ## Value: on | off
- ##
- ## Default: on
- cluster.autoheal = on
- ## Autoclean down node. A down node will be removed from the cluster
- ## if this value > 0.
- ##
- ## Value: Duration
- ## -h: hour, e.g. '2h' for 2 hours
- ## -m: minute, e.g. '5m' for 5 minutes
- ## -s: second, e.g. '30s' for 30 seconds
- ##
- ## Default: 5m
- cluster.autoclean = 5m
- ##--------------------------------------------------------------------
- ## Cluster using static node list
- ## Node list of the cluster.
- ##
- ## Value: String
- ## cluster.static.seeds = emqx1@127.0.0.1,emqx2@127.0.0.1
- ##--------------------------------------------------------------------
- ## Cluster using IP Multicast.
- ## IP Multicast Address.
- ##
- ## Value: IP Address
- ## cluster.mcast.addr = 239.192.0.1
- ## Multicast Ports.
- ##
- ## Value: Port List
- ## cluster.mcast.ports = 4369,4370
- ## Multicast Iface.
- ##
- ## Value: Iface Address
- ##
- ## Default: 0.0.0.0
- ## cluster.mcast.iface = 0.0.0.0
- ## Multicast Ttl.
- ##
- ## Value: 0-255
- ## cluster.mcast.ttl = 255
- ## Multicast loop.
- ##
- ## Value: on | off
- ## cluster.mcast.loop = on
- ##--------------------------------------------------------------------
- ## Cluster using DNS A records.
- ## DNS name.
- ##
- ## Value: String
- ## cluster.dns.name = localhost
- ## The App name is used to build 'node.name' with IP address.
- ##
- ## Value: String
- ## cluster.dns.app = emqx
- ##--------------------------------------------------------------------
- ## Cluster using etcd
- ## Etcd server list, seperated by ','.
- ##
- ## Value: String
- ## cluster.etcd.server = http://127.0.0.1:2379
- ## The prefix helps build nodes path in etcd. Each node in the cluster
- ## will create a path in etcd: v2/keys/<prefix>/<cluster.name>/<node.name>
- ##
- ## Value: String
- ## cluster.etcd.prefix = emqxcl
- ## The TTL for node's path in etcd.
- ##
- ## Value: Duration
- ##
- ## Default: 1m, 1 minute
- ## cluster.etcd.node_ttl = 1m
- ## Path to a file containing the client's private PEM-encoded key.
- ##
- ## Value: File
- ## cluster.etcd.ssl.keyfile = {{ platform_etc_dir }}/certs/client-key.pem
- ## The path to a file containing the client's certificate.
- ##
- ## Value: File
- ## cluster.etcd.ssl.certfile = {{ platform_etc_dir }}/certs/client.pem
- ## Path to the file containing PEM-encoded CA certificates. The CA certificates
- ## are used during server authentication and when building the client certificate chain.
- ##
- ## Value: File
- ## cluster.etcd.ssl.cacertfile = {{ platform_etc_dir }}/certs/ca.pem
- ##--------------------------------------------------------------------
- ## Cluster using Kubernates
- ## Kubernates API server list, seperated by ','.
- ##
- ## Value: String
- ## cluster.k8s.apiserver = http://10.110.111.204:8080
- ## The service name helps lookup EMQ nodes in the cluster.
- ##
- ## Value: String
- ## cluster.k8s.service_name = emqx
- ## The address type is used to extract host from k8s service.
- ##
- ## Value: ip | dns | hostname
- ## cluster.k8s.address_type = ip
- ## The app name helps build 'node.name'.
- ##
- ## Value: String
- ## cluster.k8s.app_name = emqx
- ## The suffix added to dns and hostname get from k8s service
- ##
- ## Value: String
- ## cluster.k8s.suffix = pod.cluster.local
- ## Kubernates Namespace
- ##
- ## Value: String
- ## cluster.k8s.namespace = default
- ##--------------------------------------------------------------------
- ## Node
- ##--------------------------------------------------------------------
- ## Node name.
- ##
- ## See: http://erlang.org/doc/reference_manual/distributed.html
- ##
- ## Value: <name>@<host>
- ##
- ## Default: emqx@127.0.0.1
- node.name = emqx@127.0.0.1
- ## Cookie for distributed node communication.
- ##
- ## Value: String
- node.cookie = emqxsecretcookie
- ## Data dir for the node
- ##
- ## Value: Folder
- node.data_dir = {{ platform_data_dir }}
- ## Heartbeat monitoring of an Erlang runtime system. Comment the line to disable
- ## heartbeat, or set the value as 'on'
- ##
- ## Value: on
- ##
- ## vm.args: -heart
- ## node.heartbeat = on
- ## Sets the number of threads in async thread pool. Valid range is 0-1024.
- ##
- ## See: http://erlang.org/doc/man/erl.html
- ##
- ## Value: 0-1024
- ##
- ## vm.args: +A Number
- node.async_threads = 32
- ## Sets the maximum number of simultaneously existing processes for this
- ## system if a Number is passed as value.
- ##
- ## See: http://erlang.org/doc/man/erl.html
- ##
- ## Value: Number [1024-134217727]
- ##
- ## vm.args: +P Number
- node.process_limit = 2048000
- ## Sets the maximum number of simultaneously existing ports for this system.
- ##
- ## See: http://erlang.org/doc/man/erl.html
- ##
- ## Value: Number [1024-134217727]
- ##
- ## vm.args: +Q Number
- node.max_ports = 1024000
- ## Set the distribution buffer busy limit (dist_buf_busy_limit).
- ##
- ## See: http://erlang.org/doc/man/erl.html
- ##
- ## Value: Number [1KB-2GB]
- ##
- ## vm.args: +zdbbl size
- node.dist_buffer_size = 8MB
- ## Sets the maximum number of ETS tables. Note that mnesia and SSL will
- ## create temporary ETS tables.
- ##
- ## Value: Number
- ##
- ## vm.args: +e Number
- node.max_ets_tables = 256000
- ## Tweak GC to run more often.
- ##
- ## Value: Number [0-65535]
- ##
- ## vm.args: -env ERL_FULLSWEEP_AFTER Number
- node.fullsweep_after = 1000
- ## Crash dump log file.
- ##
- ## Value: Log file
- node.crash_dump = {{ platform_log_dir }}/crash.dump
- ## Specify SSL Options in the file if using SSL for Erlang Distribution.
- ##
- ## Value: File
- ##
- ## vm.args: -ssl_dist_optfile <File>
- ## node.ssl_dist_optfile = {{ platform_etc_dir }}/ssl_dist.conf
- ## Sets the net_kernel tick time. TickTime is specified in seconds.
- ## Notice that all communicating nodes are to have the same TickTime
- ## value specified.
- ##
- ## See: http://www.erlang.org/doc/man/kernel_app.html#net_ticktime
- ##
- ## Value: Number
- ##
- ## vm.args: -kernel net_ticktime Number
- node.dist_net_ticktime = 60
- ## Sets the port range for the listener socket of a distributed Erlang node.
- ## Note that if there are firewalls between clustered nodes, this port segment
- ## for nodes’ communication should be allowed.
- ##
- ## See: http://www.erlang.org/doc/man/kernel_app.html
- ##
- ## Value: Port [1024-65535]
- node.dist_listen_min = 6369
- node.dist_listen_max = 6369
- ##--------------------------------------------------------------------
- ## RPC
- ##--------------------------------------------------------------------
- ## RPC Mode.
- ##
- ## Value: sync | async
- rpc.mode = async
- ## Max batch size of async RPC requests.
- ##
- ## Value: Integer
- ## Zero or negative value disables rpc batching.
- ##
- ## NOTE: RPC batch won't work when rpc.mode = sync
- rpc.async_batch_size = 256
- ## TCP server port for RPC.
- ##
- ## Value: Port [1024-65535]
- rpc.tcp_server_port = 5369
- ## TCP port for outgoing RPC connections.
- ##
- ## Value: Port [1024-65535]
- rpc.tcp_client_port = 5369
- ## Number of utgoing RPC connections.
- ##
- ## Value: Interger [1-256]
- rpc.tcp_client_num = 32
- ## RCP Client connect timeout.
- ##
- ## Value: Seconds
- rpc.connect_timeout = 5s
- ## TCP send timeout of RPC client and server.
- ##
- ## Value: Seconds
- rpc.send_timeout = 5s
- ## Authentication timeout
- ##
- ## Value: Seconds
- rpc.authentication_timeout = 5s
- ## Default receive timeout for call() functions
- ##
- ## Value: Seconds
- rpc.call_receive_timeout = 15s
- ## Socket idle keepalive.
- ##
- ## Value: Seconds
- rpc.socket_keepalive_idle = 900s
- ## TCP Keepalive probes interval.
- ##
- ## Value: Seconds
- rpc.socket_keepalive_interval = 75s
- ## Probes lost to close the connection
- ##
- ## Value: Integer
- rpc.socket_keepalive_count = 9
- ## Size of TCP send buffer.
- ##
- ## Value: Bytes
- rpc.socket_sndbuf = 1MB
- ## Size of TCP receive buffer.
- ##
- ## Value: Seconds
- rpc.socket_recbuf = 1MB
- ## Size of user-level software socket buffer.
- ##
- ## Value: Seconds
- rpc.socket_buffer = 1MB
- ##--------------------------------------------------------------------
- ## Log
- ##--------------------------------------------------------------------
- ## Where to emit the logs.
- ## Enable the console (standard output) logs.
- ##
- ## Value: off | file | console | both
- ## - off: disable logs entirely
- ## - file: write logs only to file
- ## - console: write logs only to standard I/O
- ## - both: write logs both to file and standard I/O
- log.to = both
- ## The log severity level.
- ##
- ## Value: debug | info | notice | warning | error | critical | alert | emergency
- ##
- ## Note: Only the messages with severity level higher than or equal to
- ## this level will be logged.
- ##
- ## Default: warning
- log.level = warning
- ## The dir for log files.
- ##
- ## Value: Folder
- log.dir = {{ platform_log_dir }}
- ## The log filename for logs of level specified in "log.level".
- ##
- ## Value: String
- ## Default: emqx.log
- log.file = emqx.log
- ## Limits the total number of characters printed for each log event.
- ##
- ## Value: Integer
- ## Default: No Limit
- #log.chars_limit = 8192
- ## Maximum size of each log file.
- ##
- ## Value: Number
- ## Default: 10M
- ## Supported Unit: KB | MB | G
- log.rotation.size = 10MB
- ## Maximum rotation count of log files.
- ##
- ## Value: Number
- ## Default: 5
- log.rotation.count = 5
- ## To create additional log files for specific log levels.
- ##
- ## Value: File Name
- ## Format: log.$level.file = $filename,
- ## where "$level" can be one of: debug, info, notice, warning,
- ## error, critical, alert, emergency
- ## Note: Log files for a specific log level will only contain all the logs
- ## that higher than or equal to that level
- ##
- #log.info.file = info.log
- #log.error.file = error.log
- ##--------------------------------------------------------------------
- ## Authentication/Access Control
- ##--------------------------------------------------------------------
- ## Allow anonymous authentication by default if no auth plugins loaded.
- ## Notice: Disable the option in production deployment!
- ##
- ## Value: true | false
- allow_anonymous = true
- ## Allow or deny if no ACL rules matched.
- ##
- ## Value: allow | deny
- acl_nomatch = allow
- ## Default ACL File.
- ##
- ## Value: File Name
- acl_file = {{ platform_etc_dir }}/acl.conf
- ## Whether to enable ACL cache.
- ##
- ## If enabled, ACLs roles for each client will be cached in the memory
- ##
- ## Value: on | off
- enable_acl_cache = on
- ## The maximum count of ACL entries can be cached for a client.
- ##
- ## Value: Integer greater than 0
- ## Default: 32
- acl_cache_max_size = 32
- ## The time after which an ACL cache entry will be deleted
- ##
- ## Value: Duration
- ## Default: 1 minute
- acl_cache_ttl = 1m
- ## The action when acl check reject current operation
- ##
- ## Value: ignore | disconnect
- ## Default: ignore
- acl_deny_action = ignore
- ## The cleanning interval for flapping
- ##
- ## Value: Duration
- ## -d: day
- ## -h: hour
- ## -m: minute
- ## -s: second
- ##
- ## Default: 1h, 1 hour
- ## flapping_clean_interval = 1h
- ##--------------------------------------------------------------------
- ## MQTT Protocol
- ##--------------------------------------------------------------------
- ## Maximum MQTT packet size allowed.
- ##
- ## Value: Bytes
- ## Default: 1MB
- mqtt.max_packet_size = 1MB
- ## Maximum length of MQTT clientId allowed.
- ##
- ## Value: Number [23-65535]
- mqtt.max_clientid_len = 65535
- ## Maximum topic levels allowed. 0 means no limit.
- ##
- ## Value: Number
- mqtt.max_topic_levels = 0
- ## Maximum QoS allowed.
- ##
- ## Value: 0 | 1 | 2
- mqtt.max_qos_allowed = 2
- ## Maximum Topic Alias, 0 means no topic alias supported.
- ##
- ## Value: 0-65535
- mqtt.max_topic_alias = 0
- ## Whether the Server supports MQTT retained messages.
- ##
- ## Value: boolean
- mqtt.retain_available = true
- ## Whether the Server supports MQTT Wildcard Subscriptions
- ##
- ## Value: boolean
- mqtt.wildcard_subscription = true
- ## Whether the Server supports MQTT Shared Subscriptions.
- ##
- ## Value: boolean
- mqtt.shared_subscription = true
- ## Whether to ignore loop delivery of messages.(for mqtt v3.1.1)
- ##
- ## Value: true | false
- mqtt.ignore_loop_deliver = false
- ##--------------------------------------------------------------------
- ## Zones
- ##--------------------------------------------------------------------
- ##--------------------------------------------------------------------
- ## External Zone
- ## Idle timeout of the external MQTT connections.
- ##
- ## Value: duration
- zone.external.idle_timeout = 15s
- ## Publish limit for the external MQTT connections.
- ##
- ## Value: Number,Duration
- ## Example: 10 messages per minute.
- ## zone.external.publish_limit = 10,1m
- ## Enable ACL check.
- ##
- ## Value: Flag
- zone.external.enable_acl = on
- ## Enable ban check.
- ##
- ## Value: Flag
- zone.external.enable_ban = on
- ## Enable per connection statistics.
- ##
- ## Value: on | off
- zone.external.enable_stats = on
- ## The action when acl check reject current operation
- ##
- ## Value: ignore | disconnect
- ## Default: ignore
- zone.external.acl_deny_action = ignore
- ## Force MQTT connection/session process GC after this number of
- ## messages | bytes passed through.
- ##
- ## Numbers delimited by `|'. Zero or negative is to disable.
- zone.external.force_gc_policy = 1000|1MB
- ## Max message queue length and total heap size to force shutdown
- ## connection/session process.
- ## Message queue here is the Erlang process mailbox, but not the number
- ## of queued MQTT messages of QoS 1 and 2.
- ##
- ## Numbers delimited by `|'. Zero or negative is to disable.
- ##
- ## Default:
- ## - 8000|800MB on ARCH_64 system
- ## - 1000|100MB on ARCH_32 sytem
- ## zone.external.force_shutdown_policy = 8000|800MB
- ## Maximum MQTT packet size allowed.
- ##
- ## Value: Bytes
- ## Default: 1MB
- ## zone.external.max_packet_size = 64KB
- ## Maximum length of MQTT clientId allowed.
- ##
- ## Value: Number [23-65535]
- ## zone.external.max_clientid_len = 1024
- ## Maximum topic levels allowed. 0 means no limit.
- ##
- ## Value: Number
- ## zone.external.max_topic_levels = 7
- ## Maximum QoS allowed.
- ##
- ## Value: 0 | 1 | 2
- ## zone.external.max_qos_allowed = 2
- ## Maximum Topic Alias, 0 means no limit.
- ##
- ## Value: 0-65535
- ## zone.external.max_topic_alias = 0
- ## Whether the Server supports retained messages.
- ##
- ## Value: boolean
- ## zone.external.retain_available = true
- ## Whether the Server supports Wildcard Subscriptions
- ##
- ## Value: boolean
- ## zone.external.wildcard_subscription = false
- ## Whether the Server supports Shared Subscriptions
- ##
- ## Value: boolean
- ## zone.external.shared_subscription = false
- ## Server Keep Alive
- ##
- ## Value: Number
- ## zone.external.server_keepalive = 0
- ## The backoff for MQTT keepalive timeout. The broker will kick a connection out
- ## until 'Keepalive * backoff * 2' timeout.
- ##
- ## Value: Float > 0.5
- zone.external.keepalive_backoff = 0.75
- ## Maximum number of subscriptions allowed, 0 means no limit.
- ##
- ## Value: Number
- zone.external.max_subscriptions = 0
- ## Force to upgrade QoS according to subscription.
- ##
- ## Value: on | off
- zone.external.upgrade_qos = off
- ## Maximum size of the Inflight Window storing QoS1/2 messages delivered but unacked.
- ##
- ## Value: Number
- zone.external.max_inflight = 32
- ## Retry interval for QoS1/2 message delivering.
- ##
- ## Value: Duration
- zone.external.retry_interval = 20s
- ## Maximum QoS2 packets (Client -> Broker) awaiting PUBREL, 0 means no limit.
- ##
- ## Value: Number
- zone.external.max_awaiting_rel = 100
- ## The QoS2 messages (Client -> Broker) will be dropped if awaiting PUBREL timeout.
- ##
- ## Value: Duration
- zone.external.await_rel_timeout = 300s
- ## Default session expiry interval for MQTT V3.1.1 connections.
- ##
- ## Value: Duration
- ## -d: day
- ## -h: hour
- ## -m: minute
- ## -s: second
- ##
- ## Default: 2h, 2 hours
- zone.external.session_expiry_interval = 2h
- ## Maximum queue length. Enqueued messages when persistent client disconnected,
- ## or inflight window is full. 0 means no limit.
- ##
- ## Value: Number >= 0
- zone.external.max_mqueue_len = 1000
- ## Topic priorities.
- ## 'none' to indicate no priority table (by default), hence all messages
- ## are treated equal
- ##
- ## Priority number [1-255]
- ## Example: topic/1=10,topic/2=8
- ## NOTE: comma and equal signs are not allowed for priority topic names
- ## NOTE: messages for topics not in the priority table are treated as
- ## either highest or lowest priority depending on the configured
- ## value for mqueue_default_priority
- ##
- zone.external.mqueue_priorities = none
- ## Default to highest priority for topics not matching priority table
- ##
- ## Value: highest | lowest
- zone.external.mqueue_default_priority = highest
- ## Whether to enqueue QoS0 messages.
- ##
- ## Value: false | true
- zone.external.mqueue_store_qos0 = true
- ## Whether to turn on flapping detect
- ##
- ## Value: on | off
- zone.external.enable_flapping_detect = off
- ## The times of state change per min, specifying the threshold which is used to
- ## detect if the connection starts flapping
- ##
- ## Value: number
- zone.external.flapping_threshold = 10, 1m
- ## Flapping expiry interval for connections.
- ## This config entry is used to determine when the connection
- ## will be unbanned.
- ##
- ## Value: Duration
- ## -d: day
- ## -h: hour
- ## -m: minute
- ## -s: second
- ##
- ## Default: 1h, 1 hour
- zone.external.flapping_banned_expiry_interval = 1h
- ## All the topics will be prefixed with the mountpoint path if this option is enabled.
- ##
- ## Variables in mountpoint path:
- ## - %c: clientid
- ## - %u: username
- ##
- ## Value: String
- ## zone.external.mountpoint = devicebound/
- ## Whether use username replace client id
- ##
- ## Value: boolean
- ## Default: false
- zone.external.use_username_as_clientid = false
- ## Whether to ignore loop delivery of messages.(for mqtt v3.1.1)
- ##
- ## Value: true | false
- zone.external.ignore_loop_deliver = false
- ##--------------------------------------------------------------------
- ## Internal Zone
- zone.internal.allow_anonymous = true
- ## Enable per connection stats.
- ##
- ## Value: Flag
- zone.internal.enable_stats = on
- ## Enable ACL check.
- ##
- ## Value: Flag
- zone.internal.enable_acl = off
- ## The action when acl check reject current operation
- ##
- ## Value: ignore | disconnect
- ## Default: ignore
- zone.internal.acl_deny_action = ignore
- ## See zone.$name.wildcard_subscription.
- ##
- ## Value: boolean
- ## zone.internal.wildcard_subscription = true
- ## See zone.$name.shared_subscription.
- ##
- ## Value: boolean
- ## zone.internal.shared_subscription = true
- ## See zone.$name.max_subscriptions.
- ##
- ## Value: Integer
- zone.internal.max_subscriptions = 0
- ## See zone.$name.max_inflight
- ##
- ## Value: Number
- zone.internal.max_inflight = 32
- ## See zone.$name.max_awaiting_rel
- ##
- ## Value: Number
- zone.internal.max_awaiting_rel = 100
- ## See zone.$name.max_mqueue_len
- ##
- ## Value: Number >= 0
- zone.internal.max_mqueue_len = 1000
- ## Whether to enqueue Qos0 messages.
- ##
- ## Value: false | true
- zone.internal.mqueue_store_qos0 = true
- ## Whether to turn on flapping detect
- ##
- ## Value: on | off
- zone.internal.enable_flapping_detect = off
- ## The times of state change per second, specifying the threshold which is used to
- ## detect if the connection starts flapping
- ##
- ## Value: number
- zone.internal.flapping_threshold = 10, 1m
- ## Flapping expiry interval for connections.
- ## This config entry is used to determine when the connection
- ## will be unbanned.
- ##
- ## Value: Duration
- ## -d: day
- ## -h: hour
- ## -m: minute
- ## -s: second
- ##
- ## Default: 1h, 1 hour
- zone.internal.flapping_banned_expiry_interval = 1h
- ## All the topics will be prefixed with the mountpoint path if this option is enabled.
- ##
- ## Variables in mountpoint path:
- ## - %c: clientid
- ## - %u: username
- ##
- ## Value: String
- ## zone.internal.mountpoint = cloudbound/
- ## Whether use username replace client id
- ##
- ## Value: boolean
- ## Default: false
- zone.internal.use_username_as_clientid = false
- ## Whether to ignore loop delivery of messages.(for mqtt v3.1.1)
- ##
- ## Value: true | false
- zone.internal.ignore_loop_deliver = false
- ##--------------------------------------------------------------------
- ## Listeners
- ##--------------------------------------------------------------------
- ##--------------------------------------------------------------------
- ## MQTT/TCP - External TCP Listener for MQTT Protocol
- ## listener.tcp.$name is the IP address and port that the MQTT/TCP
- ## listener will bind.
- ##
- ## Value: IP:Port | Port
- ##
- ## Examples: 1883, 127.0.0.1:1883, ::1:1883
- listener.tcp.external = 0.0.0.0:1883
- ## The acceptor pool for external MQTT/TCP listener.
- ##
- ## Value: Number
- listener.tcp.external.acceptors = 8
- ## Maximum number of concurrent MQTT/TCP connections.
- ##
- ## Value: Number
- listener.tcp.external.max_connections = 1024000
- ## Maximum external connections per second.
- ##
- ## Value: Number
- listener.tcp.external.max_conn_rate = 1000
- ## Specify the {active, N} option for the external MQTT/TCP Socket.
- ##
- ## Value: Number
- listener.tcp.external.active_n = 100
- ## Zone of the external MQTT/TCP listener belonged to.
- ##
- ## See: zone.$name.*
- ##
- ## Value: String
- listener.tcp.external.zone = external
- ## Rate limit for the external MQTT/TCP connections. Format is 'rate,burst'.
- ##
- ## Value: rate,burst
- ## - rate: The average limit value for per second
- ## - burst: The maximum allowed for each check, To avoid frequent restriction
- ## this value is recommended to be set to `(max_packet_size * active_n)/2`
- ## Unit: Bps
- ## listener.tcp.external.rate_limit = 1024,52428800
- ## The access control rules for the MQTT/TCP listener.
- ##
- ## See: https://github.com/emqtt/esockd#allowdeny
- ##
- ## Value: ACL Rule
- ##
- ## Example: allow 192.168.0.0/24
- listener.tcp.external.access.1 = allow all
- ## Enable the Proxy Protocol V1/2 if the EMQ X cluster is deployed
- ## behind HAProxy or Nginx.
- ##
- ## See: https://www.haproxy.com/blog/haproxy/proxy-protocol/
- ##
- ## Value: on | off
- ## listener.tcp.external.proxy_protocol = on
- ## Sets the timeout for proxy protocol. EMQ X will close the TCP connection
- ## if no proxy protocol packet recevied within the timeout.
- ##
- ## Value: Duration
- ## listener.tcp.external.proxy_protocol_timeout = 3s
- ## Enable the option for X.509 certificate based authentication.
- ## EMQX will use the common name of certificate as MQTT username.
- ##
- ## Value: cn | dn
- ## listener.tcp.external.peer_cert_as_username = cn
- ## The TCP backlog defines the maximum length that the queue of pending
- ## connections can grow to.
- ##
- ## Value: Number >= 0
- listener.tcp.external.backlog = 1024
- ## The TCP send timeout for external MQTT connections.
- ##
- ## Value: Duration
- listener.tcp.external.send_timeout = 15s
- ## Close the TCP connection if send timeout.
- ##
- ## Value: on | off
- listener.tcp.external.send_timeout_close = on
- ## The TCP receive buffer(os kernel) for MQTT connections.
- ##
- ## See: http://erlang.org/doc/man/inet.html
- ##
- ## Value: Bytes
- ## listener.tcp.external.recbuf = 2KB
- ## The TCP send buffer(os kernel) for MQTT connections.
- ##
- ## See: http://erlang.org/doc/man/inet.html
- ##
- ## Value: Bytes
- ## listener.tcp.external.sndbuf = 2KB
- ## The size of the user-level software buffer used by the driver.
- ## Not to be confused with options sndbuf and recbuf, which correspond
- ## to the Kernel socket buffers. It is recommended to have val(buffer)
- ## >= max(val(sndbuf),val(recbuf)) to avoid performance issues because
- ## of unnecessary copying. val(buffer) is automatically set to the above
- ## maximum when values sndbuf or recbuf are set.
- ##
- ## See: http://erlang.org/doc/man/inet.html
- ##
- ## Value: Bytes
- ## listener.tcp.external.buffer = 2KB
- ## Sets the 'buffer = max(sndbuf, recbuf)' if this option is enabled.
- ##
- ## Value: on | off
- ## listener.tcp.external.tune_buffer = off
- ## The TCP_NODELAY flag for MQTT connections. Small amounts of data are
- ## sent immediately if the option is enabled.
- ##
- ## Value: true | false
- listener.tcp.external.nodelay = true
- ## The SO_REUSEADDR flag for TCP listener.
- ##
- ## Value: true | false
- listener.tcp.external.reuseaddr = true
- ##--------------------------------------------------------------------
- ## Internal TCP Listener for MQTT Protocol
- ## The IP address and port that the internal MQTT/TCP protocol listener
- ## will bind.
- ##
- ## Value: IP:Port, Port
- ##
- ## Examples: 11883, 127.0.0.1:11883, ::1:11883
- listener.tcp.internal = 127.0.0.1:11883
- ## The acceptor pool for internal MQTT/TCP listener.
- ##
- ## Value: Number
- listener.tcp.internal.acceptors = 4
- ## Maximum number of concurrent MQTT/TCP connections.
- ##
- ## Value: Number
- listener.tcp.internal.max_connections = 1024000
- ## Maximum internal connections per second.
- ##
- ## Value: Number
- listener.tcp.internal.max_conn_rate = 1000
- ## Specify the {active, N} option for the internal MQTT/TCP Socket.
- ##
- ## Value: Number
- listener.tcp.internal.active_n = 1000
- ## Zone of the internal MQTT/TCP listener belonged to.
- ##
- ## Value: String
- listener.tcp.internal.zone = internal
- ## Rate limit for the internal MQTT/TCP connections.
- ##
- ## See: listener.tcp.$name.rate_limit
- ##
- ## Value: rate,burst
- ## - rate: The average limit value for per second
- ## - burst: The maximum allowed for each check, To avoid frequent restriction
- ## this value is recommended to be set to `(max_packet_size * active_n)/2`
- ## Unit: Bps
- ## listener.tcp.internal.rate_limit = 1000000,524288000
- ## The TCP backlog of internal MQTT/TCP Listener.
- ##
- ## See: listener.tcp.$name.backlog
- ##
- ## Value: Number >= 0
- listener.tcp.internal.backlog = 512
- ## The TCP send timeout for internal MQTT connections.
- ##
- ## See: listener.tcp.$name.send_timeout
- ##
- ## Value: Duration
- listener.tcp.internal.send_timeout = 5s
- ## Close the MQTT/TCP connection if send timeout.
- ##
- ## See: listener.tcp.$name.send_timeout_close
- ##
- ## Value: on | off
- listener.tcp.internal.send_timeout_close = on
- ## The TCP receive buffer(os kernel) for internal MQTT connections.
- ##
- ## See: listener.tcp.$name.recbuf
- ##
- ## Value: Bytes
- ## listener.tcp.internal.recbuf = 16KB
- ## The TCP send buffer(os kernel) for internal MQTT connections.
- ##
- ## See: http://erlang.org/doc/man/inet.html
- ##
- ## Value: Bytes
- ## listener.tcp.internal.sndbuf = 16KB
- ## The size of the user-level software buffer used by the driver.
- ##
- ## See: listener.tcp.$name.buffer
- ##
- ## Value: Bytes
- ## listener.tcp.internal.buffer = 16KB
- ## Sets the 'buffer = max(sndbuf, recbuf)' if this option is enabled.
- ##
- ## See: listener.tcp.$name.tune_buffer
- ##
- ## Value: on | off
- ## listener.tcp.internal.tune_buffer = off
- ## The TCP_NODELAY flag for internal MQTT connections.
- ##
- ## See: listener.tcp.$name.nodelay
- ##
- ## Value: true | false
- listener.tcp.internal.nodelay = false
- ## The SO_REUSEADDR flag for MQTT/TCP Listener.
- ##
- ## Value: true | false
- listener.tcp.internal.reuseaddr = true
- ##--------------------------------------------------------------------
- ## MQTT/SSL - External SSL Listener for MQTT Protocol
- ## listener.ssl.$name is the IP address and port that the MQTT/SSL
- ## listener will bind.
- ##
- ## Value: IP:Port | Port
- ##
- ## Examples: 8883, 127.0.0.1:8883, ::1:8883
- listener.ssl.external = 8883
- ## The acceptor pool for external MQTT/SSL listener.
- ##
- ## Value: Number
- listener.ssl.external.acceptors = 16
- ## Maximum number of concurrent MQTT/SSL connections.
- ##
- ## Value: Number
- listener.ssl.external.max_connections = 102400
- ## Maximum MQTT/SSL connections per second.
- ##
- ## Value: Number
- listener.ssl.external.max_conn_rate = 500
- ## Specify the {active, N} option for the internal MQTT/SSL Socket.
- ##
- ## Value: Number
- listener.ssl.external.active_n = 100
- ## Zone of the external MQTT/SSL listener belonged to.
- ##
- ## Value: String
- listener.ssl.external.zone = external
- ## The access control rules for the MQTT/SSL listener.
- ##
- ## See: listener.tcp.$name.access
- ##
- ## Value: ACL Rule
- listener.ssl.external.access.1 = allow all
- ## Rate limit for the external MQTT/SSL connections.
- ##
- ## Value: rate,burst
- ## - rate: The average limit value for per second
- ## - burst: The maximum allowed for each check, To avoid frequent restriction
- ## this value is recommended to be set to `(max_packet_size * active_n)/2`
- ## Unit: Bps
- ## listener.ssl.external.rate_limit = 1024,52428800
- ## Enable the Proxy Protocol V1/2 if the EMQ cluster is deployed behind
- ## HAProxy or Nginx.
- ##
- ## See: listener.tcp.$name.proxy_protocol
- ##
- ## Value: on | off
- ## listener.ssl.external.proxy_protocol = on
- ## Sets the timeout for proxy protocol.
- ##
- ## See: listener.tcp.$name.proxy_protocol_timeout
- ##
- ## Value: Duration
- ## listener.ssl.external.proxy_protocol_timeout = 3s
- ## TLS versions only to protect from POODLE attack.
- ##
- ## See: http://erlang.org/doc/man/ssl.html
- ##
- ## Value: String, seperated by ','
- ## listener.ssl.external.tls_versions = tlsv1.2,tlsv1.1,tlsv1
- ## TLS Handshake timeout.
- ##
- ## Value: Duration
- listener.ssl.external.handshake_timeout = 15s
- ## Path to the file containing the user's private PEM-encoded key.
- ##
- ## See: http://erlang.org/doc/man/ssl.html
- ##
- ## Value: File
- listener.ssl.external.keyfile = {{ platform_etc_dir }}/certs/key.pem
- ## Path to a file containing the user certificate.
- ##
- ## See: http://erlang.org/doc/man/ssl.html
- ##
- ## Value: File
- listener.ssl.external.certfile = {{ platform_etc_dir }}/certs/cert.pem
- ## Path to the file containing PEM-encoded CA certificates. The CA certificates
- ## are used during server authentication and when building the client certificate chain.
- ##
- ## Value: File
- ## listener.ssl.external.cacertfile = {{ platform_etc_dir }}/certs/cacert.pem
- ## The Ephemeral Diffie-Helman key exchange is a very effective way of
- ## ensuring Forward Secrecy by exchanging a set of keys that never hit
- ## the wire. Since the DH key is effectively signed by the private key,
- ## it needs to be at least as strong as the private key. In addition,
- ## the default DH groups that most of the OpenSSL installations have
- ## are only a handful (since they are distributed with the OpenSSL
- ## package that has been built for the operating system it’s running on)
- ## and hence predictable (not to mention, 1024 bits only).
- ## In order to escape this situation, first we need to generate a fresh,
- ## strong DH group, store it in a file and then use the option above,
- ## to force our SSL application to use the new DH group. Fortunately,
- ## OpenSSL provides us with a tool to do that. Simply run:
- ## openssl dhparam -out dh-params.pem 2048
- ##
- ## Value: File
- ## listener.ssl.external.dhfile = {{ platform_etc_dir }}/certs/dh-params.pem
- ## A server only does x509-path validation in mode verify_peer,
- ## as it then sends a certificate request to the client (this
- ## message is not sent if the verify option is verify_none).
- ## You can then also want to specify option fail_if_no_peer_cert.
- ## More information at: http://erlang.org/doc/man/ssl.html
- ##
- ## Value: verify_peer | verify_none
- ## listener.ssl.external.verify = verify_peer
- ## Used together with {verify, verify_peer} by an SSL server. If set to true,
- ## the server fails if the client does not have a certificate to send, that is,
- ## sends an empty certificate.
- ##
- ## Value: true | false
- ## listener.ssl.external.fail_if_no_peer_cert = true
- ## This is the single most important configuration option of an Erlang SSL
- ## application. Ciphers (and their ordering) define the way the client and
- ## server encrypt information over the wire, from the initial Diffie-Helman
- ## key exchange, the session key encryption ## algorithm and the message
- ## digest algorithm. Selecting a good cipher suite is critical for the
- ## application’s data security, confidentiality and performance.
- ##
- ## The cipher list above offers:
- ##
- ## A good balance between compatibility with older browsers.
- ## It can get stricter for Machine-To-Machine scenarios.
- ## Perfect Forward Secrecy.
- ## No old/insecure encryption and HMAC algorithms
- ##
- ## Most of it was copied from Mozilla’s Server Side TLS article
- ##
- ## Value: Ciphers
- listener.ssl.external.ciphers = ECDHE-ECDSA-AES256-GCM-SHA384,ECDHE-RSA-AES256-GCM-SHA384,ECDHE-ECDSA-AES256-SHA384,ECDHE-RSA-AES256-SHA384,ECDHE-ECDSA-DES-CBC3-SHA,ECDH-ECDSA-AES256-GCM-SHA384,ECDH-RSA-AES256-GCM-SHA384,ECDH-ECDSA-AES256-SHA384,ECDH-RSA-AES256-SHA384,DHE-DSS-AES256-GCM-SHA384,DHE-DSS-AES256-SHA256,AES256-GCM-SHA384,AES256-SHA256,ECDHE-ECDSA-AES128-GCM-SHA256,ECDHE-RSA-AES128-GCM-SHA256,ECDHE-ECDSA-AES128-SHA256,ECDHE-RSA-AES128-SHA256,ECDH-ECDSA-AES128-GCM-SHA256,ECDH-RSA-AES128-GCM-SHA256,ECDH-ECDSA-AES128-SHA256,ECDH-RSA-AES128-SHA256,DHE-DSS-AES128-GCM-SHA256,DHE-DSS-AES128-SHA256,AES128-GCM-SHA256,AES128-SHA256,ECDHE-ECDSA-AES256-SHA,ECDHE-RSA-AES256-SHA,DHE-DSS-AES256-SHA,ECDH-ECDSA-AES256-SHA,ECDH-RSA-AES256-SHA,AES256-SHA,ECDHE-ECDSA-AES128-SHA,ECDHE-RSA-AES128-SHA,DHE-DSS-AES128-SHA,ECDH-ECDSA-AES128-SHA,ECDH-RSA-AES128-SHA,AES128-SHA
- ## Ciphers for TLS PSK.
- ## Note that 'listener.ssl.external.ciphers' and 'listener.ssl.external.psk_ciphers' cannot
- ## be configured at the same time.
- ## See 'https://tools.ietf.org/html/rfc4279#section-2'.
- #listener.ssl.external.psk_ciphers = PSK-AES128-CBC-SHA,PSK-AES256-CBC-SHA,PSK-3DES-EDE-CBC-SHA,PSK-RC4-SHA
- ## SSL parameter renegotiation is a feature that allows a client and a server
- ## to renegotiate the parameters of the SSL connection on the fly.
- ## RFC 5746 defines a more secure way of doing this. By enabling secure renegotiation,
- ## you drop support for the insecure renegotiation, prone to MitM attacks.
- ##
- ## Value: on | off
- ## listener.ssl.external.secure_renegotiate = off
- ## A performance optimization setting, it allows clients to reuse
- ## pre-existing sessions, instead of initializing new ones.
- ## Read more about it here.
- ##
- ## See: http://erlang.org/doc/man/ssl.html
- ##
- ## Value: on | off
- ## listener.ssl.external.reuse_sessions = on
- ## An important security setting, it forces the cipher to be set based
- ## on the server-specified order instead of the client-specified order,
- ## hence enforcing the (usually more properly configured) security
- ## ordering of the server administrator.
- ##
- ## Value: on | off
- ## listener.ssl.external.honor_cipher_order = on
- ## Use the CN, EN or CRT field from the client certificate as a username.
- ## Notice that 'verify' should be set as 'verify_peer'.
- ##
- ## Value: cn | en | crt
- ## listener.ssl.external.peer_cert_as_username = cn
- ## TCP backlog for the SSL connection.
- ##
- ## See listener.tcp.$name.backlog
- ##
- ## Value: Number >= 0
- ## listener.ssl.external.backlog = 1024
- ## The TCP send timeout for the SSL connection.
- ##
- ## See listener.tcp.$name.send_timeout
- ##
- ## Value: Duration
- ## listener.ssl.external.send_timeout = 15s
- ## Close the SSL connection if send timeout.
- ##
- ## See: listener.tcp.$name.send_timeout_close
- ##
- ## Value: on | off
- ## listener.ssl.external.send_timeout_close = on
- ## The TCP receive buffer(os kernel) for the SSL connections.
- ##
- ## See: listener.tcp.$name.recbuf
- ##
- ## Value: Bytes
- ## listener.ssl.external.recbuf = 4KB
- ## The TCP send buffer(os kernel) for internal MQTT connections.
- ##
- ## See: listener.tcp.$name.sndbuf
- ##
- ## Value: Bytes
- ## listener.ssl.external.sndbuf = 4KB
- ## The size of the user-level software buffer used by the driver.
- ##
- ## See: listener.tcp.$name.buffer
- ##
- ## Value: Bytes
- ## listener.ssl.external.buffer = 4KB
- ## Sets the 'buffer = max(sndbuf, recbuf)' if this option is enabled.
- ##
- ## See: listener.tcp.$name.tune_buffer
- ##
- ## Value: on | off
- ## listener.ssl.external.tune_buffer = off
- ## The TCP_NODELAY flag for SSL connections.
- ##
- ## See: listener.tcp.$name.nodelay
- ##
- ## Value: true | false
- ## listener.ssl.external.nodelay = true
- ## The SO_REUSEADDR flag for MQTT/SSL Listener.
- ##
- ## Value: true | false
- listener.ssl.external.reuseaddr = true
- ##--------------------------------------------------------------------
- ## External WebSocket listener for MQTT protocol
- ## listener.ws.$name is the IP address and port that the MQTT/WebSocket
- ## listener will bind.
- ##
- ## Value: IP:Port | Port
- ##
- ## Examples: 8083, 127.0.0.1:8083, ::1:8083
- listener.ws.external = 8083
- ## The path of WebSocket MQTT endpoint
- ##
- ## Value: URL Path
- listener.ws.external.mqtt_path = /mqtt
- ## The acceptor pool for external MQTT/WebSocket listener.
- ##
- ## Value: Number
- listener.ws.external.acceptors = 4
- ## Maximum number of concurrent MQTT/WebSocket connections.
- ##
- ## Value: Number
- listener.ws.external.max_connections = 102400
- ## Maximum MQTT/WebSocket connections per second.
- ##
- ## Value: Number
- listener.ws.external.max_conn_rate = 1000
- ## Rate limit for the MQTT/WebSocket connections.
- ##
- ## Value: rate,burst
- ## - rate: The average limit value for per second
- ## - burst: The maximum allowed for each check, To avoid frequent restriction
- ## this value is recommended to be set to `(max_packet_size * 1)/2`
- ## Unit: Bps
- ## listener.ws.external.rate_limit = 1024,524288
- ## Zone of the external MQTT/WebSocket listener belonged to.
- ##
- ## Value: String
- listener.ws.external.zone = external
- ## The access control for the MQTT/WebSocket listener.
- ##
- ## See: listener.ws.$name.access
- ##
- ## Value: ACL Rule
- listener.ws.external.access.1 = allow all
- ## Verify if the protocol header is valid. Turn off for WeChat MiniApp.
- ##
- ## Value: on | off
- listener.ws.external.verify_protocol_header = on
- ## Use X-Forwarded-For header for real source IP if the EMQ X cluster is
- ## deployed behind NGINX or HAProxy.
- ##
- ## Value: String
- ## listener.ws.external.proxy_address_header = X-Forwarded-For
- ## Use X-Forwarded-Port header for real source port if the EMQ X cluster is
- ## deployed behind NGINX or HAProxy.
- ##
- ## Value: String
- ## listener.ws.external.proxy_port_header = X-Forwarded-Port
- ## Enable the Proxy Protocol V1/2 if the EMQ cluster is deployed behind
- ## HAProxy or Nginx.
- ##
- ## See: listener.ws.$name.proxy_protocol
- ##
- ## Value: on | off
- ## listener.ws.external.proxy_protocol = on
- ## Sets the timeout for proxy protocol.
- ##
- ## See: listener.ws.$name.proxy_protocol_timeout
- ##
- ## Value: Duration
- ## listener.ws.external.proxy_protocol_timeout = 3s
- ## The TCP backlog of external MQTT/WebSocket Listener.
- ##
- ## See: listener.ws.$name.backlog
- ##
- ## Value: Number >= 0
- listener.ws.external.backlog = 1024
- ## The TCP send timeout for external MQTT/WebSocket connections.
- ##
- ## See: listener.ws.$name.send_timeout
- ##
- ## Value: Duration
- listener.ws.external.send_timeout = 15s
- ## Close the MQTT/WebSocket connection if send timeout.
- ##
- ## See: listener.ws.$name.send_timeout_close
- ##
- ## Value: on | off
- listener.ws.external.send_timeout_close = on
- ## The TCP receive buffer(os kernel) for external MQTT/WebSocket connections.
- ##
- ## See: listener.ws.$name.recbuf
- ##
- ## Value: Bytes
- ## listener.ws.external.recbuf = 2KB
- ## The TCP send buffer(os kernel) for external MQTT/WebSocket connections.
- ##
- ## See: listener.ws.$name.sndbuf
- ##
- ## Value: Bytes
- ## listener.ws.external.sndbuf = 2KB
- ## The size of the user-level software buffer used by the driver.
- ##
- ## See: listener.ws.$name.buffer
- ##
- ## Value: Bytes
- ## listener.ws.external.buffer = 2KB
- ## Sets the 'buffer = max(sndbuf, recbuf)' if this option is enabled.
- ##
- ## See: listener.ws.$name.tune_buffer
- ##
- ## Value: on | off
- ## listener.ws.external.tune_buffer = off
- ## The TCP_NODELAY flag for external MQTT/WebSocket connections.
- ##
- ## See: listener.ws.$name.nodelay
- ##
- ## Value: true | false
- listener.ws.external.nodelay = true
- ## The compress flag for external MQTT/WebSocket connections.
- ##
- ## If this Value is set true,the websocket message would be compressed
- ##
- ## Value: true | false
- ## listener.ws.external.compress = true
- ## The level of deflate options for external MQTT/WebSocket connections.
- ##
- ## See: listener.ws.$name.deflate_opts.level
- ##
- ## Value: none | default | best_compression | best_speed
- ## listener.ws.external.deflate_opts.level = default
- ## The mem_level of deflate options for external MQTT/WebSocket connections.
- ##
- ## See: listener.ws.$name.deflate_opts.mem_level
- ##
- ## Valid range is 1-9
- ## listener.ws.external.deflate_opts.mem_level = 8
- ## The strategy of deflate options for external MQTT/WebSocket connections.
- ##
- ## See: listener.ws.$name.deflate_opts.strategy
- ##
- ## Value: default | filtered | huffman_only | rle
- ## listener.ws.external.deflate_opts.strategy = default
- ## The deflate option for external MQTT/WebSocket connections.
- ##
- ## See: listener.ws.$name.deflate_opts.server_context_takeover
- ##
- ## Value: takeover | no_takeover
- ## listener.ws.external.deflate_opts.server_context_takeover = takeover
- ## The deflate option for external MQTT/WebSocket connections.
- ##
- ## See: listener.ws.$name.deflate_opts.client_context_takeover
- ##
- ## Value: takeover | no_takeover
- ## listener.ws.external.deflate_opts.client_context_takeover = takeover
- ## The deflate options for external MQTT/WebSocket connections.
- ##
- ## See: listener.ws.$name.deflate_opts.server_max_window_bits
- ##
- ## Valid range is 8-15
- ## listener.ws.external.deflate_opts.server_max_window_bits = 15
- ## The deflate options for external MQTT/WebSocket connections.
- ##
- ## See: listener.ws.$name.deflate_opts.client_max_window_bits
- ##
- ## Valid range is 8-15
- ## listener.ws.external.deflate_opts.client_max_window_bits = 15
- ## The idle timeout for external MQTT/WebSocket connections.
- ##
- ## See: listener.ws.$name.idle_timeout
- ##
- ## Value: Duration
- ## listener.ws.external.idle_timeout = 60s
- ## The max frame size for external MQTT/WebSocket connections.
- ##
- ##
- ## Value: Number
- ## listener.ws.external.max_frame_size = 0
- ##--------------------------------------------------------------------
- ## External WebSocket/SSL listener for MQTT Protocol
- ## listener.wss.$name is the IP address and port that the MQTT/WebSocket/SSL
- ## listener will bind.
- ##
- ## Value: IP:Port | Port
- ##
- ## Examples: 8084, 127.0.0.1:8084, ::1:8084
- listener.wss.external = 8084
- ## The path of WebSocket MQTT endpoint
- ##
- ## Value: URL Path
- listener.wss.external.mqtt_path = /mqtt
- ## The acceptor pool for external MQTT/WebSocket/SSL listener.
- ##
- ## Value: Number
- listener.wss.external.acceptors = 4
- ## Maximum number of concurrent MQTT/Webwocket/SSL connections.
- ##
- ## Value: Number
- listener.wss.external.max_connections = 16
- ## Maximum MQTT/WebSocket/SSL connections per second.
- ##
- ## See: listener.tcp.$name.max_conn_rate
- ##
- ## Value: Number
- listener.wss.external.max_conn_rate = 1000
- ## Rate limit for the MQTT/WebSocket/SSL connections.
- ##
- ## Value: rate,burst
- ## - rate: The average limit value for per second
- ## - burst: The maximum allowed for each check, To avoid frequent restriction
- ## this value is recommended to be set to `(max_packet_size * 1)/2`
- ## Unit: Bps
- ## listener.wss.external.rate_limit = 1024,524288
- ## Zone of the external MQTT/WebSocket/SSL listener belonged to.
- ##
- ## Value: String
- listener.wss.external.zone = external
- ## The access control rules for the MQTT/WebSocket/SSL listener.
- ##
- ## See: listener.tcp.$name.access.<no>
- ##
- ## Value: ACL Rule
- listener.wss.external.access.1 = allow all
- ## See: listener.ws.external.verify_protocol_header
- ##
- ## Value: on | off
- listener.wss.external.verify_protocol_header = on
- ## See: listener.ws.external.proxy_address_header
- ##
- ## Value: String
- ## listener.wss.external.proxy_address_header = X-Forwarded-For
- ## See: listener.ws.external.proxy_port_header
- ##
- ## Value: String
- ## listener.wss.external.proxy_port_header = X-Forwarded-Port
- ## Enable the Proxy Protocol V1/2 support.
- ##
- ## See: listener.tcp.$name.proxy_protocol
- ##
- ## Value: on | off
- ## listener.wss.external.proxy_protocol = on
- ## Sets the timeout for proxy protocol.
- ##
- ## See: listener.tcp.$name.proxy_protocol_timeout
- ##
- ## Value: Duration
- ## listener.wss.external.proxy_protocol_timeout = 3s
- ## TLS versions only to protect from POODLE attack.
- ##
- ## See: listener.ssl.$name.tls_versions
- ##
- ## Value: String, seperated by ','
- ## listener.wss.external.tls_versions = tlsv1.2,tlsv1.1,tlsv1
- ## Path to the file containing the user's private PEM-encoded key.
- ##
- ## See: listener.ssl.$name.keyfile
- ##
- ## Value: File
- listener.wss.external.keyfile = {{ platform_etc_dir }}/certs/key.pem
- ## Path to a file containing the user certificate.
- ##
- ## See: listener.ssl.$name.certfile
- ##
- ## Value: File
- listener.wss.external.certfile = {{ platform_etc_dir }}/certs/cert.pem
- ## Path to the file containing PEM-encoded CA certificates.
- ##
- ## See: listener.ssl.$name.cacert
- ##
- ## Value: File
- ## listener.wss.external.cacertfile = {{ platform_etc_dir }}/certs/cacert.pem
- ## See: listener.ssl.$name.dhfile
- ##
- ## Value: File
- ## listener.ssl.external.dhfile = {{ platform_etc_dir }}/certs/dh-params.pem
- ## See: listener.ssl.$name.vefify
- ##
- ## Value: vefify_peer | verify_none
- ## listener.wss.external.verify = verify_peer
- ## See: listener.ssl.$name.fail_if_no_peer_cert
- ##
- ## Value: false | true
- ## listener.wss.external.fail_if_no_peer_cert = true
- ## See: listener.ssl.$name.ciphers
- ##
- ## Value: Ciphers
- listener.wss.external.ciphers = ECDHE-ECDSA-AES256-GCM-SHA384,ECDHE-RSA-AES256-GCM-SHA384,ECDHE-ECDSA-AES256-SHA384,ECDHE-RSA-AES256-SHA384,ECDHE-ECDSA-DES-CBC3-SHA,ECDH-ECDSA-AES256-GCM-SHA384,ECDH-RSA-AES256-GCM-SHA384,ECDH-ECDSA-AES256-SHA384,ECDH-RSA-AES256-SHA384,DHE-DSS-AES256-GCM-SHA384,DHE-DSS-AES256-SHA256,AES256-GCM-SHA384,AES256-SHA256,ECDHE-ECDSA-AES128-GCM-SHA256,ECDHE-RSA-AES128-GCM-SHA256,ECDHE-ECDSA-AES128-SHA256,ECDHE-RSA-AES128-SHA256,ECDH-ECDSA-AES128-GCM-SHA256,ECDH-RSA-AES128-GCM-SHA256,ECDH-ECDSA-AES128-SHA256,ECDH-RSA-AES128-SHA256,DHE-DSS-AES128-GCM-SHA256,DHE-DSS-AES128-SHA256,AES128-GCM-SHA256,AES128-SHA256,ECDHE-ECDSA-AES256-SHA,ECDHE-RSA-AES256-SHA,DHE-DSS-AES256-SHA,ECDH-ECDSA-AES256-SHA,ECDH-RSA-AES256-SHA,AES256-SHA,ECDHE-ECDSA-AES128-SHA,ECDHE-RSA-AES128-SHA,DHE-DSS-AES128-SHA,ECDH-ECDSA-AES128-SHA,ECDH-RSA-AES128-SHA,AES128-SHA
- ## Ciphers for TLS PSK.
- ## Note that 'listener.wss.external.ciphers' and 'listener.wss.external.psk_ciphers' cannot
- ## be configured at the same time.
- ## See 'https://tools.ietf.org/html/rfc4279#section-2'.
- ## listener.wss.external.psk_ciphers = PSK-AES128-CBC-SHA,PSK-AES256-CBC-SHA,PSK-3DES-EDE-CBC-SHA,PSK-RC4-SHA
- ## See: listener.ssl.$name.secure_renegotiate
- ##
- ## Value: on | off
- ## listener.wss.external.secure_renegotiate = off
- ## See: listener.ssl.$name.reuse_sessions
- ##
- ## Value: on | off
- ## listener.wss.external.reuse_sessions = on
- ## See: listener.ssl.$name.honor_cipher_order
- ##
- ## Value: on | off
- ## listener.wss.external.honor_cipher_order = on
- ## See: listener.ssl.$name.peer_cert_as_username
- ##
- ## Value: cn | dn | crt
- ## listener.wss.external.peer_cert_as_username = cn
- ## TCP backlog for the WebSocket/SSL connection.
- ##
- ## See: listener.tcp.$name.backlog
- ##
- ## Value: Number >= 0
- listener.wss.external.backlog = 1024
- ## The TCP send timeout for the WebSocket/SSL connection.
- ##
- ## See: listener.tcp.$name.send_timeout
- ##
- ## Value: Duration
- listener.wss.external.send_timeout = 15s
- ## Close the WebSocket/SSL connection if send timeout.
- ##
- ## See: listener.tcp.$name.send_timeout_close
- ##
- ## Value: on | off
- listener.wss.external.send_timeout_close = on
- ## The TCP receive buffer(os kernel) for the WebSocket/SSL connections.
- ##
- ## See: listener.tcp.$name.recbuf
- ##
- ## Value: Bytes
- ## listener.wss.external.recbuf = 4KB
- ## The TCP send buffer(os kernel) for the WebSocket/SSL connections.
- ##
- ## See: listener.tcp.$name.sndbuf
- ##
- ## Value: Bytes
- ## listener.wss.external.sndbuf = 4KB
- ## The size of the user-level software buffer used by the driver.
- ##
- ## See: listener.tcp.$name.buffer
- ##
- ## Value: Bytes
- ## listener.wss.external.buffer = 4KB
- ## The TCP_NODELAY flag for WebSocket/SSL connections.
- ##
- ## See: listener.tcp.$name.nodelay
- ##
- ## Value: true | false
- ## listener.wss.external.nodelay = true
- ## The compress flag for external WebSocket/SSL connections.
- ##
- ## If this Value is set true,the websocket message would be compressed
- ##
- ## Value: true | false
- ## listener.wss.external.compress = true
- ## The level of deflate options for external WebSocket/SSL connections.
- ##
- ## See: listener.wss.$name.deflate_opts.level
- ##
- ## Value: none | default | best_compression | best_speed
- ## listener.wss.external.deflate_opts.level = default
- ## The mem_level of deflate options for external WebSocket/SSL connections.
- ##
- ## See: listener.wss.$name.deflate_opts.mem_level
- ##
- ## Valid range is 1-9
- ## listener.wss.external.deflate_opts.mem_level = 8
- ## The strategy of deflate options for external WebSocket/SSL connections.
- ##
- ## See: listener.wss.$name.deflate_opts.strategy
- ##
- ## Value: default | filtered | huffman_only | rle
- ## listener.wss.external.deflate_opts.strategy = default
- ## The deflate option for external WebSocket/SSL connections.
- ##
- ## See: listener.wss.$name.deflate_opts.server_context_takeover
- ##
- ## Value: takeover | no_takeover
- ## listener.wss.external.deflate_opts.server_context_takeover = takeover
- ## The deflate option for external WebSocket/SSL connections.
- ##
- ## See: listener.wss.$name.deflate_opts.client_context_takeover
- ##
- ## Value: takeover | no_takeover
- ## listener.wss.external.deflate_opts.client_context_takeover = takeover
- ## The deflate options for external WebSocket/SSL connections.
- ##
- ## See: listener.wss.$name.deflate_opts.server_max_window_bits
- ##
- ## Valid range is 8-15
- ## listener.wss.external.deflate_opts.server_max_window_bits = 15
- ## The deflate options for external WebSocket/SSL connections.
- ##
- ## See: listener.wss.$name.deflate_opts.client_max_window_bits
- ##
- ## Valid range is 8-15
- ## listener.wss.external.deflate_opts.client_max_window_bits = 15
- ## The idle timeout for external WebSocket/SSL connections.
- ##
- ## See: listener.wss.$name.idle_timeout
- ##
- ## Value: Duration
- ## listener.wss.external.idle_timeout = 60s
- ## The max frame size for external WebSocket/SSL connections.
- ##
- ## Value: Number
- ## listener.wss.external.max_frame_size = 0
- ##--------------------------------------------------------------------
- ## Modules
- ##--------------------------------------------------------------------
- ##--------------------------------------------------------------------
- ## Presence Module
- ## Enable Presence Module.
- ##
- ## Value: on | off
- module.presence = on
- ## Sets the QoS for presence MQTT message.
- ##
- ## Value: 0 | 1 | 2
- module.presence.qos = 1
- ##--------------------------------------------------------------------
- ## Subscription Module
- ## Enable Subscription Module.
- ##
- ## Value: on | off
- module.subscription = off
- ## Subscribe the Topics automatically when client connected.
- ## module.subscription.1.topic = $client/%c
- ## Qos of the subscription: 0 | 1 | 2
- ## module.subscription.1.qos = 1
- ## module.subscription.2.topic = $user/%u
- ## module.subscription.2.qos = 1
- ##--------------------------------------------------------------------
- ## Rewrite Module
- ## Enable Rewrite Module.
- ##
- ## Value: on | off
- module.rewrite = off
- ## {rewrite, Topic, Re, Dest}
- ## module.rewrite.rule.1 = x/# ^x/y/(.+)$ z/y/$1
- ## module.rewrite.rule.2 = y/+/z/# ^y/(.+)/z/(.+)$ y/z/$2
- ##-------------------------------------------------------------------
- ## Plugins
- ##-------------------------------------------------------------------
- ## The etc dir for plugins' config.
- ##
- ## Value: Folder
- plugins.etc_dir = {{ platform_etc_dir }}/plugins/
- ## The file to store loaded plugin names.
- ##
- ## Value: File
- plugins.loaded_file = {{ platform_data_dir }}/loaded_plugins
- ## File to store loaded plugin names.
- plugins.expand_plugins_dir = {{ platform_plugins_dir }}/
- ##--------------------------------------------------------------------
- ## Broker
- ##--------------------------------------------------------------------
- ## System interval of publishing $SYS messages.
- ##
- ## Value: Duration
- ## Default: 1m, 1 minute
- broker.sys_interval = 1m
- ## System heartbeat interval of publishing following heart beat message:
- ## - "$SYS/brokers/<node>/uptime"
- ## - "$SYS/brokers/<node>/datetime"
- ##
- ## Value: Duration
- ## Default: 30s
- broker.sys_heartbeat = 30s
- ## Enable global session registry.
- ##
- ## Value: on | off
- broker.enable_session_registry = on
- ## Session locking strategy in a cluster.
- ##
- ## Value: Enum
- ## - local
- ## - one
- ## - quorum
- ## - all
- broker.session_locking_strategy = quorum
- ## Dispatch strategy for shared subscription
- ##
- ## Value: Enum
- ## - random
- ## - round_robin
- ## - sticky
- ## - hash
- broker.shared_subscription_strategy = random
- ## Enable/disable shared dispatch acknowledgement for QoS1 and QoS2 messages
- ## This should allow messages to be dispatched to a different subscriber in
- ## the group in case the picked (based on shared_subscription_strategy) one # is offline
- ##
- ## Value: Enum
- ## - true
- ## - false
- broker.shared_dispatch_ack_enabled = false
- ## Enable batch clean for deleted routes.
- ##
- ## Value: Flag
- broker.route_batch_clean = off
- ##--------------------------------------------------------------------
- ## System Monitor
- ##--------------------------------------------------------------------
- ## Enable Long GC monitoring. Disable if the value is 0.
- ## Notice: don't enable the monitor in production for:
- ## https://github.com/erlang/otp/blob/feb45017da36be78d4c5784d758ede619fa7bfd3/erts/emulator/beam/erl_gc.c#L421
- ##
- ## Value: Duration
- ## - h: hour
- ## - m: minute
- ## - s: second
- ## - ms: milliseconds
- ##
- ## Examples:
- ## - 2h: 2 hours
- ## - 30m: 30 minutes
- ## - 0.1s: 0.1 seconds
- ## - 100ms : 100 milliseconds
- ##
- ## Default: 0ms
- sysmon.long_gc = 0
- ## Enable Long Schedule(ms) monitoring.
- ##
- ## See: http://erlang.org/doc/man/erlang.html#system_monitor-2
- ##
- ## Value: Duration
- ## - h: hour
- ## - m: minute
- ## - s: second
- ## - ms: milliseconds
- ##
- ## Examples:
- ## - 2h: 2 hours
- ## - 30m: 30 minutes
- ## - 0.1s: 0.1 seconds
- ## - 100ms: 100 milliseconds
- ##
- ## Default: 0ms
- sysmon.long_schedule = 240ms
- ## Enable Large Heap monitoring.
- ##
- ## See: http://erlang.org/doc/man/erlang.html#system_monitor-2
- ##
- ## Value: bytes
- ##
- ## Default: 8M words. 32MB on 32-bit VM, 64MB on 64-bit VM.
- sysmon.large_heap = 8MB
- ## Enable Busy Port monitoring.
- ##
- ## See: http://erlang.org/doc/man/erlang.html#system_monitor-2
- ##
- ## Value: true | false
- sysmon.busy_port = false
- ## Enable Busy Dist Port monitoring.
- ##
- ## See: http://erlang.org/doc/man/erlang.html#system_monitor-2
- ##
- ## Value: true | false
- sysmon.busy_dist_port = true
- ## The time interval for the periodic cpu check
- ##
- ## Value: Duration
- ## -h: hour, e.g. '2h' for 2 hours
- ## -m: minute, e.g. '5m' for 5 minutes
- ## -s: second, e.g. '30s' for 30 seconds
- ##
- ## Default: 60s
- os_mon.cpu_check_interval = 60s
- ## The threshold, as percentage of system cpu, for how much system cpu can be used before the corresponding alarm is set.
- ##
- ## Default: 80%
- os_mon.cpu_high_watermark = 80%
- ## The threshold, as percentage of system cpu, for how much system cpu can be used before the corresponding alarm is clear.
- ##
- ## Default: 60%
- os_mon.cpu_low_watermark = 60%
- ## The time interval for the periodic memory check
- ##
- ## Value: Duration
- ## -h: hour, e.g. '2h' for 2 hours
- ## -m: minute, e.g. '5m' for 5 minutes
- ## -s: second, e.g. '30s' for 30 seconds
- ##
- ## Default: 60s
- os_mon.mem_check_interval = 60s
- ## The threshold, as percentage of system memory, for how much system memory can be allocated before the corresponding alarm is set.
- ##
- ## Default: 70%
- os_mon.sysmem_high_watermark = 70%
- ## The threshold, as percentage of system memory, for how much system memory can be allocated by one Erlang process before the corresponding alarm is set.
- ##
- ## Default: 5%
- os_mon.procmem_high_watermark = 5%
- ## The time interval for the periodic process limit check
- ##
- ## Value: Duration
- ##
- ## Default: 30s
- vm_mon.check_interval = 30s
- ## The threshold, as percentage of processes, for how many processes can simultaneously exist at the local node before the corresponding alarm is set.
- ##
- ## Default: 80%
- vm_mon.process_high_watermark = 80%
- ## The threshold, as percentage of processes, for how many processes can simultaneously exist at the local node before the corresponding alarm is clear.
- ##
- ## Default: 60%
- vm_mon.process_low_watermark = 60%
- {{ additional_configs }}
|