使用官方安装程序安装 RabbitMQ（Windows）

使用官方安装程序安装 RabbitMQ（Windows）

以下是使用官方安装程序的详细步骤。确保您的系统是 Windows 64 位，并以管理员权限运行所有命令。安装路径必须纯英文、无空格、无非 ASCII 字符（如中文），否则可能导致管理界面 500 错误。当前最新版本为 RabbitMQ 4.2.1（截至 2025 年 11 月），兼容 Erlang 26.2 - 28.x（推荐 Erlang 27.x）。

步骤 1: 安装 Erlang（前提依赖）

RabbitMQ 依赖 Erlang/OTP 运行环境。

1. 从 Erlang 官网下载页面 下载最新兼容的 Erlang 安装程序（例如 OTP 27.x，64 位）。
   • 检查兼容性：RabbitMQ 4.2.x 支持 Erlang 26.2 及以上版本，Erlang 28 部分支持
     6
     </grok:render>。避免安装多个 Erlang 版本。
2. 以管理员权限运行安装程序。
   • 默认安装路径：C:\Program Files\erl-27.x（可自定义为纯英文路径，如 C:\Erlang）。
3. 添加 Erlang 到系统 PATH（安装程序通常自动添加）。验证：

   erl -version
   

   • 输出应显示 Erlang 版本。

步骤 2: 下载并安装 RabbitMQ

1. 从 RabbitMQ GitHub Releases 下载 Windows 安装程序 rabbitmq-server-4.2.1.exe
   2
   </grok:render>。
   • 可选：验证下载文件的签名（使用 rabbitmq-server-4.2.1.exe.asc 文件）。
2. 以管理员权限运行 rabbitmq-server-4.2.1.exe。
   • 选择纯英文安装路径（如 C:\RabbitMQ 或 E:\rabbitmq\rabbitmq_server-4.2.1）。
   • 安装程序会自动注册 RabbitMQ 为 Windows 服务，并启动它。
3. 验证服务：

   sc query RabbitMQ
   

   • 输出应显示 STATE: 4 RUNNING。

步骤 3: 启用管理插件（Web UI）

管理插件提供浏览器界面（端口 15672）。

1. 打开管理员 CMD，切换到 RabbitMQ 的 sbin 目录（例如 E:\rabbitmq\rabbitmq_server-4.2.1\sbin）。
2. 运行：

   rabbitmq-plugins enable rabbitmq_management
   

3. 验证：
   • 浏览器访问 http://localhost:15672。
   • 默认登录：用户名 guest，密码 guest（仅本地有效）。
   • 如果无法访问，放行防火墙端口：

     netsh advfirewall firewall add rule name="RabbitMQ Management" dir=in action=allow protocol=TCP localport=15672
     

步骤 4: 配置和验证

• 配置文件：编辑 %APPDATA%\RabbitMQ\rabbitmq.conf 或 advanced.config（Erlang 格式）。修改后重新安装服务：

  rabbitmq-service remove
  rabbitmq-service install
  net start RabbitMQ
  

• 检查节点状态：

  rabbitmqctl status
  

  • 输出应显示节点信息和运行插件。
• 常见问题：
  • 服务不启动：检查 Erlang 路径和日志 %APPDATA%\RabbitMQ\log\rabbit@YOUR-PC-NAME.log。
  • Erlang Cookie 不一致：复制 %HOMEDRIVE%%HOMEPATH%\.erlang.cookie 到 %SystemRoot%\.erlang.cookie。
  • 端口冲突：检查 netstat -ano | findstr 15672。

安装完成后，RabbitMQ 即可用于开发或生产。如果需升级或自定义，参考官方文档
0
</grok:render>。