一般情况下,可以使用默认的内建配置来有效地运行RabbitMQ,并且大多数情况下也并不需要修改任何 RabbitMQ的配置。当然,为了更加有效地操控 RabbitMQ,也可以利用调节系统范围内的参数来达到定制化的需求。
RabbitMQ提供了三种方式来定制化服务:
(1)环境变量(Enviroment Variables )。RabbitMQ服务端参数可以通过环境变量进行配置, 例如,节点名称、RabbitMQ配置文件的地址、节点内部通信端口等。
(2)配置文件(Configuration File )。可以定义 RabbitMQ服务和插件设置,例如,TCP监听端口,以及其他网络相关的设置、内存限制、磁盘限制等。
(3)运行时参数和策略(Runtime Parameters and Policies)。可以在运行时定义集群层面的服务设置。
对于不同的操作系统和不同的RabbitMQ安装包来说,相应的配置会有所变化,包括相应的配置文件的地址等,在使用时要尤为注意。
二、环境变量 2.1 手动设置的环境变量还记得我们在第一节,【 3分钟在Linux上安装RabbitMQ】,其中就手动设置了两个环境变量RABBITMQ_USERNAME和RABBITMQ_PASSWORD 定义了超级管理员的账号和密码,这样我们就能通过这个账号登录管理后台
docker run -d --name rabbitmq \-e RABBITMQ_USERNAME=admin \-e RABBITMQ_PASSWORD=admin \-p 15672:15672 -p 5672:5672 -p 25672:25672 -p 61613:61613 -p 1883:1883 bitnami/rabbitmq进入docker容器看一下关于RABBITMQ现在有哪些环境变量
I have no name!@0d5cb60e3a06:/$ env | grep RABBITRABBITMQ_PASSWORD=adminRABBITMQ_USERNAME=admin 三、变量配置文件rabbitmq-env.confrabbitmq-env.conf配置文件所在目录为:/etc/rabbitmq
I have no name!@0d5cb60e3a06:/etc/rabbitmq$ ls -altotal 12drwxrwxr-x. 1 root root 75 Sep 25 05:23 .drwxr-xr-x. 1 root root 22 Dec 2 2021 ..-rw-r--r--. 1 1001 root 41 Sep 25 05:23 enabled_plugins-rw-r--r--. 1 1001 root 560 Sep 20 12:33 rabbitmq.conf-rw-r--r--. 1 1001 root 78 Sep 20 12:33 rabbitmq-env.conf查看一下该配置文件配置了些啥
I have no name!@0d5cb60e3a06:/etc/rabbitmq$ cat rabbitmq-env.conf HOME=/opt/bitnami/rabbitmq/.rabbitmqNODE_PORT=5672NODENAME=rabbit@localhost默认的配置,就上面的HOME目录,端口,以及节点名称 如何配置这个文件呢?如果想改端口为5673,改成NODE_PORT=5673即可。如果想添加一个变量值,同样的,在最下面就可以直接添加。可以看到,这里的变量名,是不带RABBITMQ前缀的。
四、默认的取值规则文件rabbitmq-defaults该文件一般是在:$RABBITMQ_HOME/sbin下面 本示例所在的目录是:/opt/bitnami/rabbitmq/sbin下面
I have no name!@0d5cb60e3a06:/opt/bitnami/rabbitmq/sbin$ ls -altotal 48drwxrwxr-x. 1 root root 238 Dec 2 2021 .drwxr-xr-x. 1 root root 45 Jan 4 2022 ..-rwxrwxr-x. 1 root root 855 Dec 2 2021 rabbitmqctl-rwxrwxr-x. 1 root root 609 Dec 2 2021 rabbitmq-defaults-rwxrwxr-x. 1 root root 864 Dec 2 2021 rabbitmq-diagnostics-rwxrwxr-x. 1 root root 6887 Dec 2 2021 rabbitmq-env-rwxrwxr-x. 1 root root 860 Dec 2 2021 rabbitmq-plugins-rwxrwxr-x. 1 root root 859 Dec 2 2021 rabbitmq-queues-rwxrwxr-x. 1 root root 6002 Dec 2 2021 rabbitmq-server-rwxrwxr-x. 1 root root 857 Dec 2 2021 rabbitmq-streams-rwxrwxr-x. 1 root root 858 Dec 2 2021 rabbitmq-tanzu-rwxrwxr-x. 1 root root 860 Dec 2 2021 rabbitmq-upgrade该文件内容如下:
I have no name!@0d5cb60e3a06:/opt/bitnami/rabbitmq/sbin$ cat rabbitmq-defaults #!/bin/sh -e## This Source Code Form is subject to the terms of the Mozilla Public## License, v. 2.0. If a copy of the MPL was not distributed with this## file, You can obtain one at https://mozilla.org/MPL/2.0/.#### Copyright (c) 2012-2020 VMware, Inc. or its affiliates. All rights reserved.##### next line potentially updated in package install stepsSYS_PREFIX=${RABBITMQ_HOME}CLEAN_BOOT_FILE=start_cleanSASL_BOOT_FILE=start_saslBOOT_MODULE="rabbit"if test -z "$CONF_ENV_FILE" && test -z "$RABBITMQ_CONF_ENV_FILE"; thenCONF_ENV_FILE=${SYS_PREFIX}/etc/rabbitmq/rabbitmq-env.conffi可以看到这个文件有一些变量配置,如CONF_ENV_FILE,可以大概猜测到是指定rabbitmq的变量配置文件
五、配置文件rabbitmq.conf配置文件在哪些目录,总是让人困扰的一件事,最简单的办法就是查看rabbitmq的服务启动日志 本示例通过docker logs 容器名称,查看日志
[root@localhost ~]# docker logs rabbitmq......2023-09-25 04:33:10.216618+00:00 [info] <0.222.0> node : rabbit@localhost2023-09-25 04:33:10.216618+00:00 [info] <0.222.0> home dir : /opt/bitnami/rabbitmq/.rabbitmq2023-09-25 04:33:10.216618+00:00 [info] <0.222.0> config file(s) : /opt/bitnami/rabbitmq/etc/rabbitmq/rabbitmq.conf2023-09-25 04:33:10.216618+00:00 [info] <0.222.0> cookie hash : XvNpT2Nlg8SZCslJcYXN8g==2023-09-25 04:33:10.216618+00:00 [info] <0.222.0> log(s) : /opt/bitnami/rabbitmq/var/log/rabbitmq/rabbit@localhost_upgrade.log2023-09-25 04:33:10.216618+00:00 [info] <0.222.0> : <stdout>2023-09-25 04:33:10.216618+00:00 [info] <0.222.0> database dir : /bitnami/rabbitmq/mnesia/rabbit@localhost该文件内容如下: 可以看到日志中配置文件在下面的目录: config file(s) : /opt/bitnami/rabbitmq/etc/rabbitmq/rabbitmq.conf
I have no name!@0d5cb60e3a06:/opt/bitnami/rabbitmq/etc/rabbitmq$ cat rabbitmq.conf ## Clusteringcluster_partition_handling = ignore## Defaults# During the first start, RabbitMQ will create a vhost and a user# These config items control what gets createddefault_permissions.configure = .*default_permissions.read = .*default_permissions.write = .*default_vhost = /default_user = admindefault_pass = admin## Networkinglisteners.tcp.default = 5672## Managementmanagement.tcp.ip = 0.0.0.0management.tcp.port = 15672## Resource limits# Set a free disk space limit relative to total available RAMdisk_free_limit.relative = 1.0可以看到rabbitmq监听的端口是5672。一般情况下,如果能在rabbitmq-env.conf里面改的数据,建议直接在rabbitmq-env.conf里面改。
六、变量生效顺序环境变量>rabbitmq-env.conf>rabbitmq.conf 以RABBITMQ_NODENAME 这个变量为例,
RabbitMQ在启动服务的时候首先判断当前Shell环境中有无 RABBITMQ_NODENANE的定义,如果有则启用此值;如果没有,则查看rabbitmq-env.conf 中是否定义了 NODENAME 这个变量,如果有则启用此值,如果没有则采用默认的取值规则,即 rabbit@$HOSTNAME。 附、关于环境变量的说明(来源于官网)
RABBITMQ_VHOST: RabbitMQ application vhost. Default: /RABBITMQ_VHOSTS: List of additional virtual host (vhost), separated by space. E.g.: /shared /prioritized /tasksRABBITMQ_USERNAME: RabbitMQ application username. Default: userRABBITMQ_PASSWORD: RabbitMQ application password. Default: bitnamiRABBITMQ_SECURE_PASSWORD: Whether to set the RabbitMQ password securely. This is incompatible with loading external RabbitMQ definitions. Default: noRABBITMQ_LOAD_DEFINITIONS: Whether to load external RabbitMQ definitions. This is incompatible with setting the RabbitMQ password securely. Default: no.RABBITMQ_ERL_COOKIE: Erlang cookie to determine whether different nodes are allowed to communicate with each other.RABBITMQ_NODE_TYPE: Node Type. Valid values: stats, queue-ram or queue-disc. Default: statsRABBITMQ_NODE_NAME: Node name and host. E.g.: node@hostname or node (localhost won't work in cluster topology). Default rabbit@localhost. If using this variable, ensure that you specify a valid host name as the container wil fail to start otherwise. If using a fully qualified domain name, RABBITMQ_USE_LONGNAME needs to be set to true as well.RABBITMQ_USE_LONGNAME: When set to true this will cause RabbitMQ to use fully qualified names to identify nodes. Default: falseRABBITMQ_FORCE_BOOT: Force a node to start even if it was not the last to shut down. Default: noRABBITMQ_CLUSTER_NODE_NAME: Node name to cluster with. E.g.: clusternode@hostnameRABBITMQ_CLUSTER_PARTITION_HANDLING: Cluster partition recovery mechanism. Default: ignoreRABBITMQ_NODE_PORT_NUMBER: Node port. Default: 5672RABBITMQ_NODE_SSL_PORT_NUMBER: RabbitMQ node port number for SSL connections. Default: 5671RABBITMQ_SSL_CACERTFILE: Path to the RabbitMQ server SSL CA certificate file. No defaults.RABBITMQ_SSL_CERTFILE: Path to the RabbitMQ server SSL certificate file. No defaults.RABBITMQ_SSL_KEYFILE: Path to the RabbitMQ server SSL certificate key file. No defaults.RABBITMQ_COMBINED_CERT_PATH: Cert- and keyfile are combined automatically into one combined file at this file path. If you are using a combined certificate anyways, mount it to the container and set this path to the mounted file. Default: /tmp/rabbitmq_combined_keys.pemRABBITMQ_SSL_DEPTH: Maximum number of non-self-issued intermediate certificates that may follow the peer certificate in a valid certification path. No defaults.RABBITMQ_SSL_FAIL_IF_NO_PEER_CERT: Whether to reject TLS connections if client fails to provide a certificate. Default: verify_noneRABBITMQ_SSL_VERIFY: Whether to enable peer SSL certificate verification. Default: noRABBITMQ_PLUGINS: Comma, semi-colon or space separated list of plugins to enable during the initialization. No defaults.RABBITMQ_COMMUNITY_PLUGINS: Comma, semi-colon or space separated list of URLs where to download custom plugins during the initialization. No defaults.Management server configurationRABBITMQ_MANAGEMENT_BIND_IP: RabbitMQ management server bind IP address. Default: 0.0.0.0RABBITMQ_MANAGEMENT_PORT_NUMBER: RabbitMQ management server port number. Default: 15672RABBITMQ_MANAGEMENT_SSL_PORT_NUMBER: RabbitMQ management server port number for SSL/TLS connections. No defaults.RABBITMQ_MANAGEMENT_SSL_CACERTFILE: Path to the RabbitMQ management server SSL CA certificate file. No defaults.RABBITMQ_MANAGEMENT_SSL_CERTFILE: Path to the RabbitMQ management server SSL certificate file. No defaults.RABBITMQ_MANAGEMENT_SSL_KEYFILE: Path to the RabbitMQ management server SSL certificate key file. No defaults.RABBITMQ_MANAGEMENT_SSL_DEPTH: Maximum number of non-self-issued intermediate certificates that may follow the peer certificate in a valid certification path, for the RabbitMQ management server. No defaults.RABBITMQ_MANAGEMENT_SSL_FAIL_IF_NO_PEER_CERT: Whether to reject TLS connections if client fails to provide a certificate for the RabbitMQ management server. Default: yesRABBITMQ_MANAGEMENT_SSL_VERIFY: Whether to enable peer SSL certificate verification for the RabbitMQ management server. Default: verify_peerLDAP configurationRABBITMQ_ENABLE_LDAP: Enable the LDAP configuration. Defaults: noRABBITMQ_LDAP_TLS: Enable secure LDAP configuration. Defaults: noRABBITMQ_LDAP_SERVERS: Comma, semi-colon or space separated list of LDAP server hostnames. No defaults.RABBITMQ_LDAP_SERVERS_PORT: LDAP servers port. Defaults: 389RABBITMQ_LDAP_USER_DN_PATTERN: DN used to bind to LDAP in the form cn=$${username},dc=example,dc=org. No defaults.Memory and disk configurationRABBITMQ_VM_MEMORY_HIGH_WATERMARK: High memory watermark for RabbitMQ to block publishers and prevent new messages from being enqueued. Can be specified as an absolute or relative value (as percentage or value between 0 and 1). No defaults.RABBITMQ_DISK_FREE_RELATIVE_LIMIT: Disk relative free space limit of the partition on which RabbitMQ is storing data. Default: 1.0RABBITMQ_DISK_FREE_ABSOLUTE_LIMIT: Disk absolute free space limit of the partition on which RabbitMQ is storing data (takes precedence over the relative limit). No defaults.RABBITMQ_ULIMIT_NOFILES: Resources limits: maximum number of open file descriptors. Default: 65536