RabbitMQ 开机启动配置教程

SmileNicky

发布于 2025-06-11 19:50:16

25900

代码可运行

文章被收录于专栏：Nicky's blogNicky's blog

运行总次数：0

代码可运行

RabbitMQ 开机启动配置教程

在本教程中，我们将详细介绍如何配置 RabbitMQ 以实现开机自动启动。此配置适用于手动安装的 RabbitMQ 版本。

环境准备

操作系统：CentOS 7
RabbitMQ 版本：3.8.4
Erlang 版本：21.3

步骤

1. 安装 Erlang

安装依赖：

sudo yum -y install gcc glibc-devel make ncurses-devel openssl-devel xmlto perl wget socat

下载 Erlang：

wget http://erlang.org/download/otp_src_21.3.tar.gz

解压并编译安装：

tar -xvf otp_src_21.3.tar.gz
cd otp_src_21.3
./configure --prefix=/usr/local/erlang
make && make install

配置环境变量：编辑 /etc/profile 文件，添加以下内容：

export PATH=$PATH:/usr/local/erlang/bin

使配置生效：

source /etc/profile

验证安装：

erl -version

2. 安装 RabbitMQ

下载 RabbitMQ：

wget https://github.com/rabbitmq/rabbitmq-server/releases/download/v3.8.4/rabbitmq-server-generic-unix-3.8.4.tar.xz

解压：

xz -d rabbitmq-server-generic-unix-3.8.4.tar.xz
tar -xvf rabbitmq-server-generic-unix-3.8.4.tar

配置环境变量：编辑 /etc/profile 文件，添加以下内容：

export PATH=$PATH:/usr/local/rabbitmq_server-3.8.4/sbin

使配置生效：

source /etc/profile

3. 配置 RabbitMQ 环境文件

编辑 rabbitmq-env 文件：

sudo vi /usr/local/rabbitmq/rabbitmq_server-3.8.4/sbin/rabbitmq-env

添加 Erlang 路径：在文件中添加 Erlang 的路径：

export PATH=$PATH:/usr/local/erlang/bin

4. 创建 RabbitMQ 服务文件

创建服务文件：

sudo vi /etc/systemd/system/rabbitmq.service

添加以下内容：

[Unit]
Description=RabbitMQ Server
Documentation=https://www.rabbitmq.com/docs.html
After=network.target

[Service]
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/usr/local/erlang/bin"
User=rabbitmq
Group=rabbitmq
Type=notify
ExecStart=/usr/local/rabbitmq/rabbitmq_server-3.8.4/sbin/rabbitmq-server
ExecStop=/usr/local/rabbitmq/rabbitmq_server-3.8.4/sbin/rabbitmqctl stop
Restart=on-failure
LimitNOFILE=65536

[Install]
WantedBy=multi-user.target

5. 配置开机启动

加载服务文件：

sudo systemctl daemon-reload

启用开机启动：

sudo systemctl enable rabbitmq.service

立即启动服务：

sudo systemctl start rabbitmq.service

查看服务状态：

sudo systemctl status rabbitmq.service

6. 验证配置

验证 RabbitMQ 状态：

sudo /usr/local/rabbitmq/rabbitmq_server-3.8.4/sbin/rabbitmqctl status

验证管理插件：

sudo /usr/local/rabbitmq/rabbitmq_server-3.8.4/sbin/rabbitmq-plugins enable rabbitmq_management

访问管理界面：通过浏览器访问 http://<服务器IP>:15672，使用管理员账户登录。

7. 查看服务日志

如果服务启动失败，可以使用以下命令查看详细日志：

journalctl -u rabbitmq.service -l

此命令将显示 RabbitMQ 服务的详细日志，帮助你排查问题。

8. 检查端口冲突和防火墙设置

检查端口占用：确保 RabbitMQ 使用的端口（默认是 5672 和 15672）未被其他服务占用：

sudo netstat -tuln | grep 5672
sudo netstat -tuln | grep 15672

查看占用端口的进程：如果发现端口被占用，可以使用以下命令找出占用端口的进程：

sudo lsof -i :5672
sudo lsof -i :15672

停止占用端口的进程：如果确认该进程不是必需的，可以停止它：

sudo kill -9 <PID>

替换 <PID> 为实际的进程 ID。

配置防火墙：确保防火墙允许访问 RabbitMQ 的端口：

sudo firewall-cmd --zone=public --add-port=5672/tcp --permanent
sudo firewall-cmd --zone=public --add-port=15672/tcp --permanent
sudo firewall-cmd --reload