ADMQ RabbitMQ 单机部署

本文档指导在 Linux 环境下完成 ADMQ RabbitMQ 的单机模式部署。

---

一、环境准备

1.1 创建部署目录

mkdir -p /apusic/admq-rabbitmq
cd /apusic/admq-rabbitmq

1.2 解压软件包

tar -xzf admq-rabbitmq-<version>.tar.gz -C /apusic/admq-rabbitmq

1.3 目录结构说明

解压完成后标准目录结构如下：

admq-rabbitmq/
├── bin/            # 命令行工具（admq、admq-daemon 等）
├── config/         # 配置文件目录
│   └── rabbitmq.conf
├── rabbitmq/       # RabbitMQ 核心程序
├── logs/           # 日志目录
└── license.xml     # 授权文件（需手动放置）

---

二、配置修改

2.1 修改主机名称

主机名称只能包含字母（a-z A-Z）、数字（0-9）和连字符（-）：

hostnamectl set-hostname admq-node1

2.2 修改监听端口等（可选）

编辑 config/rabbitmq.conf，按需修改：

# AMQP 监听端口（默认 5672）
listeners.tcp.default = 5672

# 管理控制台端口（默认 15672）
management.tcp.port = 15672

# 默认账号（生产环境请修改）
default_user = admq
default_pass = apusic_123

---

三、放置授权文件

将 license.xml 上传到部署目录根路径：

cp license.xml /apusic/admq-rabbitmq/

联系管理员或通过授权平台申请对应版本的 license.xml。

---

四、启动服务

bin/admq rabbitmq server
# 或后台模式
bin/admq-daemon rabbitmq start

---

五、验证部署

5.1 检查进程状态

ps aux | grep rabbitmq

5.2 检查端口监听

netstat -tlnp | grep 5672
# 预期看到 LISTEN 状态

5.3 查看运行日志

tail -f logs/server.log

5.4 创建用户

bin/admq rabbitmq admin add_user test test123
bin/admq rabbitmq admin set_user_tags test management
bin/admq rabbitmq admin set_permissions -p / test ".*" ".*" ".*"

5.5 创建虚拟主机

bin/admq rabbitmq admin add_vhost test
bin/admq rabbitmq admin set_permissions -p test test ".*" ".*" ".*"

---

六、停止服务

bin/admq-daemon rabbitmq stop

---

七、常见问题

端口冲突

修改 config/rabbitmq.conf 中的 listeners.tcp.default 和 management.tcp.port。

权限问题

确保启动用户对安装目录有读写权限：

chown -R $(whoami) /apusic/admq-rabbitmq/

---

如需技术支持，请联系 Apusic 技术支持团队。