RabbitMQ：核心运行参数

下面整理了一份 RabbitMQ “核心运行参数” 一览表，包含了 UI 里常见的参数以及一些同样重要但不一定在 UI 上直接列出的参数，重点说明它们的含义、默认值、推荐范围与计算方式。表格后附简要说明和文档链接，方便对号入座、调整和监控。

参数	含义	默认值	推荐范围／值	计算／说明
channel_max	单个 Connection 上允许打开的最大 Channel 数量	2047（或在 UI 中显示的 negotiated 值） (GitHub)	根据业务并发定：若平均每连接只用少量 channel，可适当调低；典型值 50–500	客户端连接时与 Server 协商上限；超出时会断开该 Connection (RabbitMQ)
frame_max	AMQP 帧的最大大小（字节数）	131072	保持 ≥ 4096；如网络抖动或 TLS 场景可适当增至 262144	控制单个 AMQP 帧的最大字节数，过小会导致大消息拆分，过大占用内存
heartbeat	AMQP 客户端与 Broker 之间的心跳间隔（秒）	60	30–300	建议 ≥ 30；太低会增加网络包，太高可能导致假死检测不及时
net_ticktime	Erlang VM 网络超时心跳检测间隔（秒）	60	与 heartbeat 保持一致	Erlang distribution 网络探测，影响节点间心跳、TLS 握手等
vm_memory_high_watermark.relative	内存流控阈值（相对），当 RabbitMQ 进程占用 RAM 达阈值时触发流控	0.6	0.4–0.7（生产环境不宜超过 0.7） (RabbitMQ)	百分比方式：使用内存／可用内存 ≥ relative 即触发；推荐用绝对值模式容器环境
vm_memory_high_watermark.absolute	内存流控阈值（绝对值），可替代相对模式	—	根据主机 RAM，至少留出 30% 给 OS	如 vm_memory_high_watermark.absolute = 4GB，优先于 relative 模式 (RabbitMQ)
vm_memory_high_watermark.paging_ratio	当达到内存阈值时，触发 Paging（消息置换）前的中间阈值	0.5	0.5–1.0	内存使用／可用内存 ≥ paging_ratio 开始将消息写入磁盘而非积压内存
disk_free_limit.relative	磁盘流控阈值（相对），当所在分区可用磁盘小于此比例时触发流控	0.5	≥ 0.1；保留至少 1–2GB 给 OS	可用磁盘／总磁盘 ≥ relative；也可设 disk_free_limit.absolute = 1GB
num_acceptors.tcp	TCP 监听端口的 acceptor 进程数	10	5–50	Erlang 进程，用于并发 accept()；连接大量短连接场景可适当增大
num_acceptors.ssl	SSL/TLS 监听端口的 acceptor 进程数	10	5–50	同上，SSL 握手成本更高，可专人配置
handshake_timeout	AMQP/TLS 握手超时时间（毫秒）	10000	5000–30000	客户端连接时等待 Start、TlsHandshake 完成的超时
socket_writer_gc_threshold	每写入 N 字节后触发一次 Erlang GC	1000000000	10⁷–10⁹	控制网络写入后的垃圾回收触发频度，数值越小 GC 越频繁，过大会导致内存高涨
memory_monitor_interval	内存监控任务执行间隔（毫秒）	2500	1000–10000	检查 VM 内存使用以触发流控的间隔
mirroring_sync_batch_size	Classic 镜像队列同步批量大小（条数）	4096	1024–16384	影响镜像队列上的数据复制效率与内存占用
connections_max	节点允许的最大 Connection 数量	unlimited(或 OS 限制)	根据业务峰值+20%	可通过 rabbitmqctl set_vm_memory_high_watermark 等接口动态设置，上限多配置可防 DoS

---

参数说明与调整建议

1. 流控与高可用

   • 内存与磁盘流控（vm_memory_*、disk_free_limit.*）直接影响 Broker 是否开始阻塞或置换消息，务必结合业务峰值和耗电规律做容量规划。
   • 对容器化环境，建议使用 绝对阈值 而非相对模式，以规避 cgroup/宿主机内存探测偏差【(RabbitMQ)】。

2. 连接与并发

   • num_acceptors.* 与 channel_max、connections_max 一同决定节点的并发承受能力，请与 OS 的 ulimit -n（文件描述符数）相配合。
   • Frame 大小 (frame_max) 与 heartbeat 应结合网络抖动与客户端特性优化。

3. GC 与性能

   • socket_writer_gc_threshold 决定网络写入后的垃圾回收频度，数值过大会导致内存飙升，过小则 GC 频繁影响吞吐。
   • memory_monitor_interval 太短会增加监控开销，太长可能延迟流控反应。

4. 镜像与复制

   • 对于强一致性和灾备，Quorum 或 Stream 队列更推荐，Classic 镜像队列（mirroring_sync_batch_size）在新项目中已不鼓励使用。
   • 若仍需 Classic 镜像队列，请调优批量大小与 ha-promote-on-shutdown、ha-params 等策略。

---

更多配置参数、计算算法 及 命令行动态调整，请参考：

• 配置手册：RabbitMQ Configuration (RabbitMQ)
• 内存流控：Memory Threshold and Limit (RabbitMQ)
• Channels 限制：Maximum Number of Channels (RabbitMQ)
• 生产部署建议：Production Checklist (RabbitMQ)

以上参数是 RabbitMQ 运行时最常用、最关键的那些，通过合理监控与调优，能有效提升集群稳定性与性能。