Bat

轻量级 VPS 基础设施监控系统
实时指标采集 · 智能告警 · 可视化仪表盘

Bat 是一套专为小型 VPS 集群设计的基础设施监控方案，用于替代 Netdata（120–243MB RSS）等重量级方案。三个组件：Rust Probe（~2MB RSS）、Cloudflare Worker（Hono + D1，同时托管 API 与 SPA）、Vite 仪表盘。架构以 docs/02-architecture.md 为准。

VPS hosts                         Cloudflare
┌──────────┐          ┌──────────────────────────────────┐
│ bat-probe │──POST──>│  bat-ingest.worker.hexly.ai      │
│  (Rust)   │         │  (no Access, write/read keys)    │
└──────────┘          │                                  │
                      │  bat.hexly.ai  (Access)          │
Browser ─────────────>│  Worker = API + Vite SPA assets  │
                      └──────────────────────────────────┘

• 系统指标采集 — CPU usage/iowait/steal、内存、磁盘、网络流量，30 秒间隔
• 极低资源占用 — Rust 编写，~2MB RSS；当前发布的 x86_64 静态二进制约 3.4MB
• 手动安装 — R2 二进制 + 仓库内 probe/dist/bat-probe.service。CD 不上传 install.sh；Setup 页的 latest/install.sh 目前 404

• 数据接收与存储 — Hono 框架，D1 数据库，支持高频写入
• 智能告警 — ALL_ALERT_RULES（当前 28 条）在 Worker 侧评估
• 定时聚合 — Cron 触发的小时级数据聚合，自动清理过期数据

• 实时可视化 — Recharts 图表，CPU/内存/磁盘/网络趋势
• Cloudflare Access — 浏览器走 bat.hexly.ai；机器流量走 ingest 域名
• Probe 分发 — R2 latest/bat-probe-linux-{x86_64,aarch64}（及 .sha256）。没有已发布的一键脚本

CD 只把 probe 二进制和 checksum 传到 R2，不上传 install.sh。未注入 DASHBOARD_URL 的 probe/install.sh 会退出。Setup 页的 latest/install.sh 目前 404。新机器（root，x86_64）：

curl -fsSL -o /usr/local/bin/bat-probe https://s.zhe.to/apps/bat/latest/bat-probe-linux-x86_64
chmod 755 /usr/local/bin/bat-probe
id -u bat >/dev/null 2>&1 || useradd --system --no-create-home --shell /usr/sbin/nologin bat
mkdir -p /etc/bat
cat > /etc/bat/config.toml <<'EOF'
worker_url = "https://bat-ingest.worker.hexly.ai"
write_key = "<write_key>"
EOF
chown -R bat:bat /etc/bat
chmod 600 /etc/bat/config.toml
cat > /etc/systemd/system/bat-probe.service <<'EOF'
[Unit]
Description=bat VPS monitoring probe
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/usr/local/bin/bat-probe
Restart=always
RestartSec=5
MemoryMax=15M
User=bat
Group=bat
AmbientCapabilities=CAP_DAC_READ_SEARCH
NoNewPrivileges=true
ProtectSystem=strict
ReadOnlyPaths=/proc /sys /etc

[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable --now bat-probe

aarch64 把二进制文件名换成 bat-probe-linux-aarch64。unit 内容必须与仓库 probe/dist/bat-probe.service 一致，不要用缺 AmbientCapabilities 的 docs/04 片段。

不要在本机 wrangler deploy，也不要使用不存在的 bat-db-prod 或只 apply 0001。生产 D1 迁移必须先于引用新列的 Worker 代码。版本入口 bun run release；CD 见 .github/workflows/release.yml 与 docs/19-edge-deployment.md。

SPA 由 Worker [assets] 托管，不再走 Railway / Next.js。浏览器认证是 Cloudflare Access。详见 docs/19-edge-deployment.md。

bat/
├── packages/
│   ├── ui/                 # Vite SPA :7025
│   ├── worker/             # Hono Worker + D1（wrangler :37025）
│   ├── shared/             # 共享类型
│   └── cli/
├── probe/                  # Rust 采集端
├── docs/                   # 编号设计文档
└── scripts/

• Bun 1.3+、Rust 1.85+（edition 2024）
• Wrangler CLI（Worker 开发）

bun install
bun run dev                         # Vite :7025 + wrangler :37025
cd probe && cargo build --release   # Probe

覆盖率以 scripts/check-coverage.sh 为准，不要沿用旧的 225 / @bat/dashboard 计数。

bun turbo test          # TypeScript 测试
cd probe && cargo test  # Rust 测试

规则条数以 packages/shared/src/alerts.ts 的 ALL_ALERT_RULES 为准（当前 28 条）。Probe 上报原始数据，Worker 服务端评估。

MIT © 2026