文件和目录位置

概述

每个 RabbitMQ 节点都使用许多文件和目录来加载配置：存储数据、元数据、日志文件等等。它们的位置可以更改。

本指南涵盖

• 如何自定义 RabbitMQ 节点使用的各种目录和文件的位置
• 各种操作系统上关键文件和目录的默认位置
• 与文件和目录位置相关的其他主题

本指南是主要配置指南的配套文档。

覆盖位置

许多环境变量指定了 RabbitMQ 应该在何处查找某些内容。在大多数环境中，默认值应该可以正常工作。

路径和目录名称限制

一些环境变量配置了路径和位置（节点的基础目录或数据目录，插件源和扩展目录等等）。这些路径必须排除一些字符

• * 和 ? (在 Linux、macOS、BSD 和其他类 UNIX 系统上)
• ^ 和 !
• [ 和 ]
• {} 和 }

上述字符将导致节点无法启动或按预期运行（例如，加载插件代码模块和其他文件）。

所需的文件和目录权限

更改文件或目录位置时，重要的是确保它们具有足够的权限，以便 RabbitMQ 节点 OS 进程可以从中读取和写入。最好假设 RabbitMQ 使用的大多数目录和文件都需要读取、写入和文件创建权限。

Debian、RPM、Homebrew 和 Windows 安装程序包将设置适合大多数环境的文件系统权限，但是，当系统范围内使用严格的默认权限时，可能需要在安装后运行额外的配置步骤，以确保 RabbitMQ 节点文件和目录具有足够的权限

环境变量

名称	描述
RABBITMQ_BASE	注意：Windows 特有。此基础目录包含 RabbitMQ 服务器数据库和日志文件的子目录。与其单独覆盖 RABBITMQ_MNESIA_BASE 和 RABBITMQ_LOG_BASE，不如覆盖基础目录更容易。
RABBITMQ_CONFIG_FILE	配置文件路径，不带 .config 扩展名。如果配置文件存在，服务器将使用它来配置 RabbitMQ 组件。有关更多信息，请参见配置指南。
RABBITMQ_CONFIG_FILES	新式 (.conf) 格式的 RabbitMQ 配置文件目录路径。文件将按字母顺序加载。通常的做法是以数字作为每个文件的前缀。有关更多信息，请参见配置指南。
RABBITMQ_MNESIA_BASE	此基础目录包含 RabbitMQ 服务器节点数据库、消息存储和集群状态文件的子目录，每个节点一个，除非显式设置了 RABBITMQ_MNESIA_DIR。重要的是，有效的 RabbitMQ 用户具有足够的权限，可以在任何时候读取、写入和创建此目录中的文件和子目录。通常不覆盖此变量。通常会覆盖 RABBITMQ_MNESIA_DIR。
RABBITMQ_MNESIA_DIR	此 RabbitMQ 节点的数据存储目录。这包括模式数据库、消息存储、集群成员信息和其他持久节点状态。
RABBITMQ_SCHEMA_DIR	RabbitMQ 在其中保存其配置模式的目录，该模式供新式配置文件使用。
RABBITMQ_LOG_BASE	此基础目录包含 RabbitMQ 服务器的日志文件，除非设置了 RABBITMQ_LOGS。
RABBITMQ_LOGS	RabbitMQ 服务器 Erlang 日志文件的路径。此变量无法在 Windows 上被覆盖。
RABBITMQ_PLUGINS_DIR	插件存档文件所在并从中提取的目录列表。这是一个类似 PATH 的变量，其中不同的路径由操作系统特定的分隔符分隔（Unix 为 :，Windows 为 ;）。插件可以安装到此处列出的任何目录中。
RABBITMQ_PLUGINS_EXPAND_DIR	用于在启动服务器时扩展已启用插件的工作目录。重要的是，有效的 RabbitMQ 用户具有足够的权限，可以在此目录中读取和创建文件和子目录。
RABBITMQ_ENABLED_PLUGINS_FILE	此文件记录显式启用的插件。启用或禁用插件时，将重新创建此文件。重要的是，有效的 RabbitMQ 用户具有足够的权限，可以在任何时候读取、写入和创建此文件。
RABBITMQ_PID_FILE	进程 ID 存放的文件，供 rabbitmqctl wait 使用。

Linux、macOS、BSD 上的默认位置

在下表中，指示了某些路径的 ${install_prefix}。Debian 和 RPM 包安装使用空的 ${install_prefix}。

Homebrew 安装在安装时使用 安装前缀 (Homebrew Cellar)。默认情况下，在基于 Apple Silicon 的 Mac 上，这是 /opt/homebrew。

名称	位置
RABBITMQ_BASE	（未使用 - 仅限 Windows）
RABBITMQ_CONFIG_FILE	${install_prefix}/etc/rabbitmq/rabbitmq
RABBITMQ_MNESIA_BASE	${install_prefix}/var/lib/rabbitmq/mnesia
RABBITMQ_MNESIA_DIR	$RABBITMQ_MNESIA_BASE/$RABBITMQ_NODENAME
RABBITMQ_LOG_BASE	${install_prefix}/var/log/rabbitmq
RABBITMQ_LOGS	$RABBITMQ_LOG_BASE/$RABBITMQ_NODENAME.log
RABBITMQ_PLUGINS_DIR	/usr/lib/rabbitmq/plugins:$RABBITMQ_HOME/plugins 请注意，只有当 RabbitMQ 安装到标准（默认）位置时，才使用 /usr/lib/rabbitmq/plugins。
RABBITMQ_PLUGINS_EXPAND_DIR	$RABBITMQ_MNESIA_BASE/$RABBITMQ_NODENAME-plugins-expand
RABBITMQ_ENABLED_PLUGINS_FILE	${install_prefix}/etc/rabbitmq/enabled_plugins
RABBITMQ_PID_FILE	$RABBITMQ_MNESIA_DIR.pid

Windows 上的默认位置

名称	位置
RABBITMQ_BASE	%APPDATA%\RabbitMQ
RABBITMQ_CONFIG_FILE	%RABBITMQ_BASE%\rabbitmq
RABBITMQ_MNESIA_BASE	%RABBITMQ_BASE%\db
RABBITMQ_MNESIA_DIR	%RABBITMQ_MNESIA_BASE%\%RABBITMQ_NODENAME%-mnesia
RABBITMQ_LOG_BASE	%RABBITMQ_BASE%\log
RABBITMQ_LOGS	%RABBITMQ_LOG_BASE%\%RABBITMQ_NODENAME%.log
RABBITMQ_PLUGINS_DIR	安装目录/plugins
RABBITMQ_PLUGINS_EXPAND_DIR	%RABBITMQ_MNESIA_BASE%\%RABBITMQ_NODENAME%-plugins-expand
RABBITMQ_ENABLED_PLUGINS_FILE	%RABBITMQ_BASE%\enabled_plugins
RABBITMQ_PID_FILE	（当前不支持）

通用二进制构建默认值

这些是解压缩通用二进制构建存档而未进行任何修改时获得的默认值。在此表中，$RABBITMQ_HOME 指的是解压缩存档后生成的目录。

这些路径与使用相同软件包类型但对其进行大量自定义的安装选项无关，例如Homebrew 公式。

名称	位置
RABBITMQ_BASE	（未使用）
RABBITMQ_CONFIG_FILE	$RABBITMQ_HOME/etc/rabbitmq/rabbitmq
RABBITMQ_MNESIA_BASE	$RABBITMQ_HOME/var/lib/rabbitmq/mnesia
RABBITMQ_MNESIA_DIR	$RABBITMQ_MNESIA_BASE/$RABBITMQ_NODENAME
RABBITMQ_LOG_BASE	$RABBITMQ_HOME/var/log/rabbitmq
RABBITMQ_LOGS	$RABBITMQ_LOG_BASE/$RABBITMQ_NODENAME.log
RABBITMQ_PLUGINS_DIR	$RABBITMQ_HOME/plugins
RABBITMQ_PLUGINS_EXPAND_DIR	$RABBITMQ_MNESIA_BASE/$RABBITMQ_NODENAME-plugins-expand
RABBITMQ_PID_FILE	$RABBITMQ_MNESIA_DIR.pid