一、下载文件
Erlang安装
https://www.erlang.org/patches/OTP-26.2
下载安装包后一直下一步安装(可选择安装路径)
rabbitmq安装
https://github.com/rabbitmq/rabbitmq-server/releases/download/v3.12.13/rabbitmq-server-3.12.13.exe
下载安装包后一直下一步安装(可选择安装路径)
二、安装及调试
1. 配置文件位置
Windows 默认路径(没有就新建):
plaintext
%APPDATA%\RabbitMQ\rabbitmq.conf
# 即:C:\Users\[你的用户名]\AppData\Roaming\RabbitMQ\rabbitmq.conf
或安装目录下:
plaintext
C:\Program Files\RabbitMQ Server\rabbitmq_server-3.13.x\etc\rabbitmq\rabbitmq.conf
2. 常用完整配置(直接复制使用)
ini
# --------------------------
# 1. 网络与端口
# --------------------------
# AMQP 端口(默认5672),允许所有IP访问
listeners.tcp.default = 0.0.0.0:5672
# 管理后台端口(默认15672)
management.tcp.port = 15672
# 允许 guest 远程登录(生产不建议,仅测试)
loopback_users = none
# --------------------------
# 2. 默认用户(生产必改)
# --------------------------
default_user = admin
default_pass = Admin@123456
default_vhost = /
default_user_tags.administrator = true
# --------------------------
# 3. 日志与数据目录
# --------------------------
log.console = true
log.file = true
log.dir = ${APPDATA}/RabbitMQ/log
mnesia.dir = ${APPDATA}/RabbitMQ/db
# --------------------------
# 4. 内存与磁盘限制
# --------------------------
vm_memory_high_watermark.relative = 0.4
disk_free_limit.absolute = 5GB
3. 高级配置(advanced.config,可选)
同目录新建 advanced.config:
erlang
[
{rabbit, [
{cluster_partition_handling, autoheal},
{queue_index_embed_msgs_below, 4096}
]}
].
启用 Web 管理插件(必做)
以管理员身份打开 CMD / PowerShell:
bash
运行
# 启用管理插件
rabbitmq-plugins enable rabbitmq_management
# 重启服务生效
rabbitmq-service.bat stop
rabbitmq-service.bat start
访问管理后台:
plaintext
http://localhost:15672
# 账号:admin / Admin@123456(你配置的)
Windows 服务管理(常用命令)
bash
运行
# 安装服务(一般安装包已自动装)
rabbitmq-service.bat install
# 启动
rabbitmq-service.bat start
# 或
net start RabbitMQ
# 停止
rabbitmq-service.bat stop
# 或
net stop RabbitMQ
# 重启
rabbitmq-service.bat restart
# 查看状态
rabbitmqctl.bat status
# 卸载服务
rabbitmq-service.bat remove
用户与权限(生产安全)
bash
运行
# 查看用户
rabbitmqctl list_users
# 新建管理员用户
rabbitmqctl add_user admin Admin@123456
rabbitmqctl set_user_tags admin administrator
rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"
# 删除默认 guest(安全)
rabbitmqctl delete_user guest
# 查看权限
rabbitmqctl list_permissions -p /
防火墙开放端口(远程访问)
以管理员 PowerShell 执行:
powershell
# AMQP 5672
New-NetFirewallRule -DisplayName "RabbitMQ 5672" -Direction Inbound -Protocol TCP -LocalPort 5672 -Action Allow
# 管理后台 15672
New-NetFirewallRule -DisplayName "RabbitMQ 15672" -Direction Inbound -Protocol TCP -LocalPort 15672 -Action Allow
常见问题
- 服务启动失败
- 检查
ERLANG_HOME与 Path 是否正确 - 路径不要中文、空格
- 以管理员身份运行命令
- 检查
- 远程无法访问 15672
rabbitmq.conf设loopback_users = none- 防火墙开放 15672
- 监听
0.0.0.0:15672
- 配置不生效
- 修改后必须 重启服务
- 确认配置文件路径正确
快速验证
-
服务状态:
rabbitmqctl status -
管理后台:
http://localhost:15672 -
端口监听: bash
运行
netstat -ano | findstr :5672 netstat -ano | findstr :15672