#bm2

• 官网与手册：https://bm2.moonbitlang.dev
• 仓库：https://github.com/chenbimo/bm2
• 许可：MIT

#它解决什么问题

• 守护进程自己崩了，cluster 模式下的应用跟着断，恢复时还要重建整棵进程树。
• pm2 本身是一个 Node.js 应用，得先有 Node.js 才能装它，再用它管别的 Node.js 应用。
• 日志轮转要额外装 pm2-logrotate 模块。
• 配置写在 ecosystem.config.js 里，那是一段可执行代码，等于把部署配置交给了运行时。

#你能得到什么

• 崩溃自动重启，带连续重启预算。预算耗尽就停下来等你看，而不是无限重试。
• 两种多实例方式。fork 用连续端口交给网关分发，cluster 共用一个端口由内核分发。
• 守护进程崩溃不打断应用。新守护进程用 pidfd 认出原进程，校验环境后接管。
• 内置日志轮转，按项目配置大小与代数。
• 内置通知上报，支持飞书、钉钉、企业微信、Slack、Discord、通用 webhook 与邮件。
• 不停机自升级，bm2 upgrade 一条命令换入新版本。
• 状态与事件全部落盘，内容包括谁在跑、跑过几次、为什么退出。
• 空闲守护进程常驻内存约 2.6 MB，命令响应约 1 ms。

#它不做什么

• 反向代理、TLS、域名：交给 Nginx、Caddy。
• 开机自启：交给 systemd。
• 远程运维、集群编排、容器调度：不在范围内。
• 应用热重载：每次启动都是一次完整重启。

#环境要求

• Linux，内核 5.3 及以上。pidfd 进程跟踪需要它。
• runtime = "bun" 的项目需要 Bun 1.4.0 及以上。
• runtime = "node" 的项目需要 Node.js 24.0.0 及以上。
• 只要在安装与升级 bm2 时需要 MoonBit 工具链，运行 bm2 不需要。

#安装 bm2

curl -fsSL https://cli.moonbitlang.com/install/unix.sh | bash
moon install chensuiyi/bm2/...

#快速开始

name = "api"
script = "src/index.ts"
instances = 2
port = 3000

bm2 serve        # 生产模式启动并登记
bm2 list         # 看实例表
bm2 dev          # 开发模式，单实例，前台跟随日志

Bun.serve({
  port: Number(Bun.env.BM2_APP_PORT),
  reusePort: true,
  fetch: () => new Response('ok'),
})

#命令速查

#配置速查

name = "api"                  # 项目名，也是状态目录下的目录名
cwd = "/srv/api"              # 默认是 bm2.toml 所在目录
script = "src/index.ts"       # 相对 cwd
runtime = "bun"               # bun 或 node
exec_mode = "cluster"         # cluster 或 fork
instances = 2
port = 3000
max_memory_mb = 512
max_restarts = 10             # 连续异常重启预算，0 表示首次异常即停止自愈
restart_delay_ms = 1000
min_uptime_ms = 10000
stop_timeout_ms = 10000

[logs]
max_size_mb = 10
keep = 0                      # 0 表示归档代数不限

[notify]
enabled = false

#运维要点

#上线前值得确认

• 端口不冲突。所有在册项目的端口范围互不重叠，冲突时 bm2 会点名占用的项目。
• cluster 模式开了 reusePort。
• max_memory_mb 与机器内存匹配。超限按异常重启处理，不是静默杀掉。
• 通知里的凭据用 __NAME__ 占位符，真值放在 .env 或启动时的环境变量里，别写进仓库。
• 反向代理只指一个端口：cluster 只要一条 upstream，fork 要给每个实例一条。

#与 pm2 的对比

#文档

cd docs && bun install && bun run dev