开发中 · AGPL-3.0 · Linux x86_64 / ARM64 / ARMv7 / Windows x64

快速开始

三条命令跑起 MiBeeBell：构建、配置、发出第一条告警。

源码构建

git clone + 一条 go build；web UI 已预构建内嵌，无需 node。

Docker Compose

deploy/compose.cn.yml（国内拓扑，Telegram 走代理）/ compose.overseas.yml（海外全直连）。

systemd 安装

deploy/install.sh 一键装到 /opt/mibee-bell 并注册系统服务（含加固 unit）。

目标架构:

① 构建

git clone https://github.com/Mi-Bee-Studio/MiBeeBell.git
cd MiBeeBell
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o mibee-bell ./cmd/mibee-bell

② 写配置

./mibee-bell hash-password --password 'your-admin-password'
# → {"password_hash":"$2a$10$..."} 填入下方 auth.password_hash

cat > config.yaml <<'EOF'
server:
  listen: ":9080"
auth:
  password_hash: "$2a$10$..."
storage:
  path: ./mibee-bell.db
ingest:
  webhook_tokens:
    - token: "my-ingest-token-1"
      default_source: "myapp"
  alertmanager: true
EOF

password_hash 为空时管理界面停用（摄取不受影响）；webhook token 是接入方与 Bell 各存一份的随机串。

③ 启动并发第一条告警

./mibee-bell -config config.yaml
curl http://127.0.0.1:9080/healthz

# 发第一条告警（换你的实例地址与 token）：
curl -X POST "http://127.0.0.1:9080/api/ingest/webhook/my-ingest-token-1" \
  -H "Content-Type: application/json" \
  -d '{"type":"demo_alert","severity":"error","title":"第一条测试告警","source_ref":"demo-1"}'

浏览器打开 http://<主机>:9080 登录管理界面，配置渠道后即可在通知中心看到这条告警。

现有系统零改造

Alertmanager 的 webhook_configs 指向 /api/ingest/alertmanager 即接；Bark 存量脚本把 api.day.app 换成你的 Bell 地址即迁移。

环境要求

任意 Linux（arm64/armv7/amd64）或 Windows x64；内存 512MB 起步；树莓派 3B 实测常驻 <80MB。源码构建需 Go 1.26。

阅读文档

13 篇双语文档：管道、七类入口、渠道、mesh、部署与 API 参考。

GitHub 仓库

源码、issue 与路线图（仓库随 v1.0 转公开）。