bm2

搞定 Node.js 与 Bun 项目的线上部署

手册与官网：https://bm2.moonbitlang.dev

亮点

异常退出自动重启

实例异常退出后自动重启，连续重启达到上限时停止自愈并等待人工处理。

多实例与连接分流

同一项目可启动多个实例，共用一个端口时由系统按连接分配，各用独立端口时由网关分流。

看管进程故障不影响业务

负责监督的进程退出后业务进程继续运行，新的看管进程识别原实例并继续监督，不需要重启应用。

升级不中断服务

执行升级后换入新版本，服务不中断，应用进程号保持不变。

日志自动轮转

日志达到设定大小后自动切分，归档代数可配置，无需额外组件。

内置通知上报

崩溃、内存超限、实例离线、磁盘空间不足、连续重启等事件，可推送至飞书、钉钉、企业微信、Slack、Discord、自定义 webhook 与邮箱，上报由 bm2 内部实现，无需额外部署服务。

定时运行报告

支持按 cron 表达式定时推送，报告包含每个实例的状态、端口、内存、峰值、CPU、运行时长与重启次数，以及项目汇总。

也可以只生成增量统计，包含区间内存峰值与自动重启次数。

关键指标阈值提醒

内存占用、离线时长、连续重启次数、启动超时、磁盘剩余空间、短时间内的重启次数均可设置阈值，同一告警按时间窗口去重，推送频率受配置限制。

运行状态可追溯

实例的运行状态、重启次数与退出原因全部写入状态目录，事后可查。

安装 bm2

bm2 只通过 MoonBit 的工具链分发，所以先装工具链，再用它安装 bm2。

安装 MoonBit 工具链

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

这个脚本把 moon 放进 ~/.moon/bin，并把这个目录写进 shell 配置的 PATH。

工具链只需要装一次，升级 bm2 时不用重装。

安装 bm2

moon install chensuiyi/bm2/...

bm2 与 bm2d 会一起装进 ~/.moon/bin，不需要再配 PATH。

安装过程会在本机编译一次，没有预编译包，所以需要 C 工具链。

快速开始

在项目目录写一份 bm2.toml。

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'),
})

reusePort: true 只在 cluster 模式下需要，忘了写会在启动后实测到没生效，bm2 会停下整个项目并说明原因，而不是让第二个实例随机发疯。

日报与巡检

通知属于项目，写在同一份 bm2.toml 里。

[notify]
enabled = true
events = ["crash", "errored", "memory_limit"]
dedupe_window_s = 3600

[[notify.report]]
name = "每日统计"
cron = "0 8 * * *"
template = "stats"

[[notify.report.target]]
platform = "feishu"
url = "https://open.feishu.cn/open-apis/bot/v2/hook/__FEISHU__"

• health 适合巡检，关注当前状态。
• stats 适合日报，关注这一段时间的增长与重启次数。
• cron 支持分、时、日、月、周五个字段，多个值用逗号列出，不支持区间写法。
• 凭据用 __NAME__ 占位符，真值放 .env 或启动环境，不要写进仓库。

命令速查

命令	用途
bm2 serve	生产模式：登记、启动、写状态
bm2 dev	开发模式：单实例，前台跟随日志，--no-follow 关闭跟随
bm2 stop <name>	停下，但保留登记，随时可以再起来
bm2 remove <name>	退役：停下、注销、交还名字，日志默认保留
bm2 remove <name> -f	退役并删除它的状态目录，连日志一起
bm2 clean	清掉状态目录里已经没有归属的旧目录，--dry-run 只看不删
bm2 list [name]	查看实例表，--json 给机器读
bm2 check	只校验当前目录的 bm2.toml，不碰守护进程
bm2 reload	换入新的守护进程，应用继续运行
bm2 notify [target]	给本项目的通知目标发一条测试消息
bm2 upgrade	用 moon install 换入新版本并让新守护进程接管
bm2 kill -y	停掉全部项目并退出守护进程

stop 是暂停，名字还在册，remove 是退役，名字交还出去，日志保留，想翻日志的时刻往往在项目消失之后。

配置速查

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_tree_processes = 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 表示归档代数不限

与 pm2 的对比

对比项	bm2	pm2
形态	两个原生静态二进制	Node.js 应用
额外依赖	无	需要 Node.js
空闲守护进程内存	约 2.6 MB	约 50 MB
日志轮转	内置	需装 pm2-logrotate
cluster 分发层	内核 SO_REUSEPORT，无中间层	cluster master 进程
守护进程崩溃	应用继续运行，新守护进程接管	cluster 应用随之中断
配置	静态 TOML，字段强校验	ecosystem.config.js，可执行代码

环境要求

• Linux，内核 5.4 及以上，pidfd 进程跟踪与退出码需要它。
• runtime = "bun" 需要 Bun 1.4.0 及以上。
• runtime = "node" 需要 Node.js 22.12.0 及以上。
• 只有安装与升级 bm2 时需要 MoonBit 工具链，运行 bm2 不需要。

版本下限在启动那一刻实测，低于下限会直接拒绝启动并说清缺什么，而不是让实例反复崩溃给你看。