目录

​编辑RabbitMQ Ubuntu 环境安装教程 (轻量应用服务器专享版)

一、前置准备（轻量服务器关键）

二、完整安装流程

1. 更新系统软件包

2. 安装 Erlang 环境

3. 安装 RabbitMQ 服务

4. 安装管理界面插件（Web UI）

5. 解决远程登录限制（关键步骤）

三、访问与管理

1. 登录管理界面

2. Java 项目连接配置

四、常用运维命令 (Ubuntu)

五、卸载（如需要）

六、轻量服务器特别注意事项

---

RabbitMQ Ubuntu 环境安装教程 (轻量应用服务器专享版)

针对轻量服务器 Ubuntu 环境（如腾讯云轻量应用服务器、阿里云轻量服务器等），以下是结合最佳实践的详细安装教程。

一、前置准备（轻量服务器关键）

安装前必须在轻量服务器控制台完成以下操作，否则无法通过浏览器访问管理界面：

端口	用途	必须开放
15672	RabbitMQ 管理界面（Web）	✅
5672	AMQP 协议端口（Java 项目连接用）	✅
25672	集群通信（单机可不开）	❌

操作路径：轻量服务器控制台 → 防火墙/安全组 → 添加规则 → 放行上述 TCP 端口。

二、完整安装流程

1. 更新系统软件包

# 更新软件源列表，确保获取最新版本信息
sudo apt-get update

2. 安装 Erlang 环境

RabbitMQ 基于 Erlang 开发，必须先安装 Erlang 运行时环境。

# 安装 erlang（Ubuntu 仓库版本，适合学习阶段）
sudo apt-get install erlang -y

验证安装：

# 进入 Erlang 交互式 shell，查看版本信息
erl

看到类似 Erlang/OTP 22 或更高版本即成功。

退出 Erlang shell（重要，否则命令行会卡住）：

halt().

3. 安装 RabbitMQ 服务

# 再次更新（确保 RabbitMQ 源最新）
sudo apt-get update

# 安装 RabbitMQ 服务器
sudo apt-get install rabbitmq-server -y

验证服务状态：

# 查看服务是否正常运行（Active: active (running) 为成功）
sudo systemctl status rabbitmq-server

输出示例：

● rabbitmq-server.service - RabbitMQ Messaging Server
   Active: active (running) since ...

4. 安装管理界面插件（Web UI）

默认不安装，需手动启用：

# 启用 rabbitmq_management 插件（提供 Web 管理界面）
sudo rabbitmq-plugins enable rabbitmq_management

成功后会显示：started 3 plugins（包含 rabbitmq_management、rabbitmq_management_agent、rabbitmq_web_dispatch）。

5. 解决远程登录限制（关键步骤）

问题背景：从 RabbitMQ 3.3.0 开始，默认用户 guest/guest 仅允许 localhost 访问。轻量服务器属于远程 IP 访问，直接登录会报错：

User can only log in via localhost

解决方案：创建新的管理员用户。

# 步骤 A：添加用户（格式：rabbitmqctl add_user 用户名 密码）
# 示例：创建用户 admin，密码 admin（生产环境请设置强密码）
sudo rabbitmqctl add_user admin admin

# 步骤 B：赋予管理员权限（administrator 角色拥有最高权限）
sudo rabbitmqctl set_user_tags admin administrator

# 步骤 C：（可选）授予虚拟主机权限，允许访问所有资源
sudo rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"

角色权限说明：

• administrator：超级管理员，可登录控制台、管理用户和策略（推荐用于开发）。

• monitoring：可查看节点信息（内存、进程等），适合运维监控。

• management：仅可登录控制台，无法查看节点信息。

三、访问与管理

1. 登录管理界面

浏览器访问：http://你的轻量服务器公网IP:15672

• 用户名：admin（或你创建的用户名）

• 密码：admin（或你设置的密码）

登录成功后，可看到 Overview（概览）、Connections（连接）、Channels（信道）、Exchanges（交换机）、Queues（队列）等标签。

2. Java 项目连接配置

在 Spring Boot 或 Java 项目的 application.yml 中配置：

spring:
  rabbitmq:
    host: 你的轻量服务器公网IP  # 必须是公网IP
    port: 5672                 # AMQP 端口（非 15672）
    username: admin            # 使用创建的管理员账号（非 guest）
    password: admin
    virtual-host: /            # 默认虚拟主机

注意：若连接失败，请检查：

1. 轻量服务器防火墙是否开放 5672 端口。

2. 用户名密码是否正确（不要使用 guest）。

3. RabbitMQ 服务是否运行（sudo systemctl status rabbitmq-server）。

四、常用运维命令 (Ubuntu)

# 启动服务
sudo systemctl start rabbitmq-server

# 停止服务
sudo systemctl stop rabbitmq-server

# 重启服务（修改配置后常用）
sudo systemctl restart rabbitmq-server

# 设置开机自启（轻量服务器重启后自动启动）
sudo systemctl enable rabbitmq-server

# 查看服务状态
sudo systemctl status rabbitmq-server

五、卸载（如需要）

# 1. 停止服务
sudo systemctl stop rabbitmq-server

# 2. 卸载 RabbitMQ（--auto-remove 同时删除依赖）
sudo apt-get purge --auto-remove rabbitmq-server

# 3. 卸载 Erlang
sudo apt-get purge --auto-remove erlang

# 4. 清理残留数据（谨慎操作）
sudo rm -rf /var/lib/rabbitmq/
sudo rm -rf /etc/rabbitmq/

六、轻量服务器特别注意事项

1. 内存限制：轻量服务器通常配置较低（1核1G/2G），RabbitMQ 默认内存占用较高。若部署多个服务，建议：

   • 监控内存使用：free -h

   • 必要时调整 RabbitMQ 内存限制（进阶配置）。

2. 安全性：生产环境务必：

   • 修改默认密码（避免使用 admin/admin）。

   • 限制 15672 端口访问 IP（通过轻量服务器防火墙规则）。

   • 使用 HTTPS 反向代理管理界面（Nginx + SSL）。

3. Docker 方案：若后续需要迁移或集群部署，建议参考 Docker 安装方式，更便于环境隔离和备份。

建议后续操作：

1. 您可以根据实际情况修改文档中的 admin 默认密码以提高安全性。

2. 如果服务器内存较小，建议关注 free -h 结果，避免因内存溢出导致 RabbitMQ 进程被系统杀掉。