MacOS 安装 RabbitMQ

RabbitMQ 安装好后，默认初始用户/密码： guest 都是 guest；这个账号只能在本机访问，如果需要跨服务器访问，需要创建新用户。

1. 推荐：使用 Homebrew 安装（最简单）

• 安装（会自动安装 Erlang 依赖）：

brew update
brew install rabbitmq

• 启动 / 停止 / 重启（以 Homebrew services 管理，开机自启）：

# 启动并设为开机自启
brew services start rabbitmq

# 停止
brew services stop rabbitmq

# 重启
brew services restart rabbitmq

• 以前台方式运行（用于调试）：

# 前台输出日志（Ctrl+C 停止）
rabbitmq-server

# 后台启动（daemon）
rabbitmq-server -detached

• 查看状态 / 日志：

# 状态
rabbitmqctl status

# 日志目录（取决于 Homebrew 前缀）
# Intel macOS Homebrew 默认：/usr/local
# Apple Silicon Homebrew 默认：/opt/homebrew
# 举例：
tail -f /opt/homebrew/var/log/rabbitmq/*    # Apple Silicon
tail -f /usr/local/var/log/rabbitmq/*       # Intel

• Homebrew 安装后常见配置/数据目录（根据 Homebrew 前缀）：
  • 配置目录： /opt/homebrew/etc/rabbitmq 或 /usr/local/etc/rabbitmq
  • 数据目录： /opt/homebrew/var/lib/rabbitmq 或 /usr/local/var/lib/rabbitmq

2. 启用管理控制台（Web UI）

• 启用插件并重启 RabbitMQ：

rabbitmq-plugins enable rabbitmq_management
brew services restart rabbitmq

• 管理控制台地址（默认）：
  • http://localhost:15672
  • 默认用户：guest 密码：guest （注意：guest 仅允许从 localhost 登录）

3. 创建用户与权限（推荐不要在生产使用 guest）

# 添加用户
rabbitmqctl add_user myuser mypassword

# 赋予管理 tag （可选）
rabbitmqctl set_user_tags myuser administrator

# 给 vhost '/' 全权限
rabbitmqctl set_permissions -p / myuser ".*" ".*" ".*"

# 删除 guest（可选, 生产环境建议创建专用用户并禁用 guest）
rabbitmqctl delete_user guest

4. 常用端口（确保防火墙/反向代理放行）

• 5672：AMQP（客户端连接）
• 15672：管理控制台（HTTP）
• 4369：EPMD（节点发现）
• 25672：集群与 Erlang 分布式通信

5. 配置 TLS / 自定义配置

• 配置文件位置：/opt/homebrew/etc/rabbitmq/rabbitmq.conf 或 /usr/local/etc/rabbitmq/rabbitmq.conf
• 可在该文件中设置监听端口、TLS、认证、vhost 等配置。修改后重启服务生效。

6. 备用：使用 Docker 运行（无需在主机安装 Erlang）

# 运行一个临时带管理界面的容器
docker run --rm --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:3-management

# 后台运行并命名卷/持久化
docker run -d --name rabbitmq \
  -p 5672:5672 -p 15672:15672 \
  -v rabbitmq_data:/var/lib/rabbitmq \
  rabbitmq:3-management

7. 常见问题提示

• 如果 rabbitmqctl 报找不到命令，确认 Homebrew bin 在 PATH（/opt/homebrew/bin 或 /usr/local/bin）。
• 如果管理 UI 无法登录，确认是否使用了 guest（guest 仅允许本地登录），或确认用户/权限是否正确。
• 如果端口被占用（bind: address already in use），换端口或释放占用进程。
• 在生产环境请：
  • 禁用或删除 guest 用户
  • 使用专用账号与强密码
  • 配置 TLS（rabbitmq.conf）
  • 考虑持久化数据并定期备份