2
0
0

服务器 CPU 打满你却一无所知?Beszel 实测:4.4 MB 的 agent,十分钟自建带告警的服务器监控

文章摘要
|

一、服务器"发疯"的时候,你永远是最后一个知道的

手上有一台 VPS 或者 NAS 的人,大概率经历过这种场景:朋友说"你博客昨晚怎么打不开",你登上服务器一看,内存早被某个容器吃光了,OOM killer 已经默默忙活了一整晚。更要命的是,你连"它是从几点开始吃的"都答不上来——因为没有历史数据,事后只能看残缺的日志猜。

想解决它,市面上的选项各有各的难受:云厂商自带监控只看整机大盘,容器级指标要加钱;Prometheus + Grafana + node_exporter 全家桶功能确实强,但为了几台小服务器看曲线,先给自己部署一套需要运维的监控系统,多少有点本末倒置。

最近我在 GitHub 上翻自托管项目时注意到 Beszel:27000+ star、MIT 协议、Go 编写,B站 UP 主们最近也开始出它的部署教程,homelab 圈热度肉眼可见地涨。它的定位正好卡在上面两个方案中间——轻到不像话(agent 镜像只有 4.4 MB),但历史数据、容器指标、磁盘健康、告警通知一样不缺。本文用官方文档把它从零到告警跑通一遍,全程不到十分钟。

二、Beszel 是什么:一个面板,一群 agent

Beszel 的架构就两层:

  • Hub:Web 面板,负责展示和告警,底层是 PocketBase(单二进制 + SQLite),这个选型决定了它天生轻量,所有数据就是本地一个目录;
  • Agent:跑在每台被监控机器上的采集器,把指标回传给 hub。镜像压缩后只有 4.4 MB,hub 也才 12.8 MB。

能采什么?官方 README 列的清单相当能打:CPU 与内存(含 swap 和 ZFS ARC)、磁盘用量与 I/O、网络用量(主机和容器级)、负载、温度、风扇转速、GPU 用量与功耗(Nvidia / AMD / Intel 都认)、Docker / Podman 容器的状态与资源曲线、S.M.A.R.T. 磁盘健康(连 eMMC 磨损度和 mdraid 阵列健康都看)、ZFS 池状态。迭代也很勤,最新版 v0.21.1 是 2026 年 10 月底发的。

三、单机版:一份 compose 文件搞定 hub + agent

假设你就一台服务器,hub 和 agent 一起部署。建个目录,写入 docker-compose.yml:

mkdir -p beszel && cd beszel
nano docker-compose.yml

以下是官方文档的单机配置(注释是我加的):

services:
  beszel:
    image: henrygd/beszel:latest
    container_name: beszel
    restart: unless-stopped
    environment:
      APP_URL: http://localhost:8090   # 有域名就改成实际访问地址
    ports:
      - 8090:8090
    volumes:
      - ./beszel_data:/beszel_data     # 面板数据(PocketBase + SQLite),备份这个目录就行
      - ./beszel_socket:/beszel_socket # hub 与 agent 的本地通信插座

  beszel-agent:
    image: henrygd/beszel-agent:latest
    container_name: beszel-agent
    restart: unless-stopped
    network_mode: host
    volumes:
      - ./beszel_agent_data:/var/lib/beszel-agent
      - ./beszel_socket:/beszel_socket
      - /var/run/docker.sock:/var/run/docker.sock:ro  # 只读挂载,够采容器指标且更安全
    environment:
      LISTEN: /beszel_socket/beszel.sock  # 单机模式走本地 unix socket,不占端口
      HUB_URL: http://localhost:8090
      TOKEN: <token>
      KEY: "<key>"

先带占位符直接启动:

docker compose up -d

然后浏览器打开 http://服务器IP:8090,按提示创建第一个账号(这就是管理员)。接着点右上角 Add System:

  1. Host / IP 一栏填 /beszel_socket/beszel.sock——本地 unix socket 路径,官方文档就是这么写的,不用填 IP;
  2. 对话框会给你一个公钥,填进 compose 的 KEY;token 则到 /settings/tokens 页面生成一个,填进 TOKEN;
  3. 再跑一次 docker compose up -d 让 agent 带着新配置重启,面板几秒内开始出数。

小技巧:从 v0.12.0 起 Beszel 支持通用 token,配一次就能接后面所有 agent,不用每台机器单独去 UI 里领 key。

四、监控第二台服务器:一个容器 + 一个端口

真正的乐趣从这里开始——NAS、第二台 VPS、家里的软路由,全都能接进同一个面板。在 hub 上点 Add System,这次选远程 agent,拿到公钥后,去目标机器上部署 agent。官方给的 docker run 一行流:

docker run -d   --name beszel-agent   --network host   --restart unless-stopped   -v /var/run/docker.sock:/var/run/docker.sock:ro   -e KEY="<public key>"   -e HUB_URL="<hub url>"   -e TOKEN="<token>"   -e LISTEN=45876   henrygd/beszel-agent:latest

喜欢 compose 的可以用这份等价配置:

services:
  beszel-agent:
    image: henrygd/beszel-agent
    container_name: beszel-agent
    restart: unless-stopped
    network_mode: host
    volumes:
      - ./beszel_agent_data:/var/lib/beszel-agent
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      LISTEN: 45876
      KEY: "<public key>"
      HUB_URL: "<hub url>"
      TOKEN: "<token>"

机架中半抽出的 1U 服务器,前面板多个硬盘槽位

三个值得注意的点:network_mode: host 是官方原配置,agent 要直接读宿主机的网络和传感器数据,别改成桥接;默认监听 45876 端口,防火墙放行它就行——建议只对 hub 所在服务器的 IP 放行,别对全网开;docker.sock 依然是只读挂载,容器指标照采,风险面最小。

回 hub 填上这台机器的 IP(端口默认 45876),保存。几秒钟后,它的 CPU、内存、容器列表就全部出现在同一张面板里了。

五、告警:CPU 一过 90%,飞书立刻响

监控的灵魂是告警,不然就是事后诸葛亮的图表。Beszel 的通知在 Settings → Notifications 里配置,支持 24 种渠道——Telegram、Discord、Slack、Matrix、ntfy、Gotify 这些常规的都有,对国内用户最友好的是飞书和企业微信原生支持。URL 格式照官方文档抄(尖括号换成你的凭据):

# 飞书
lark://<host>/<token>?secret=<secret>

# 企业微信机器人
wecom://<key>

# Telegram
telegram://<token>@telegram?chats=<chat-id>

# ntfy(自建推送服务)
ntfy://:<access-token>@<host>/<topic>

没有合适的现成渠道?还有 generic:// 通用 webhook,能接任何自定义接口。

通知配好后,回到系统列表,对具体指标开启告警、设好阈值——比如 CPU 超过 90%、磁盘用量超过 85%、某个容器停止运行。之后半夜某个容器开始疯狂吃内存时,你的手机会比你先知道。

六、几个值得知道的细节

  • 备份极简:所有数据都在 ./beszel_data 目录(PocketBase + SQLite),整个目录拷走就是完整备份;hub 还内置自动备份,可以存本地或任意 S3 兼容对象存储。
  • 多用户:普通用户各管各的系统,管理员可以跨用户共享某台机器——小团队也能用。
  • 登录方式:支持 OAuth / OIDC 接主流身份提供方,密码登录可以整体关掉。
  • 上 HTTPS:官方有专门的反向代理文档(beszel.dev/guide/reverse-proxy),配合你现有的 Nginx / Caddy 就行。
  • 生态:社区做了移动端 App、桌面客户端,甚至有 Home Assistant 集成。

至于要不要上 Prometheus:两者不是替代关系。1~10 台小机器、想看历史曲线和容器指标、要告警推送,Beszel 是"开箱即用"档的最优解;要 PromQL、要监控上百个目标,那还是 Prometheus 的场子。

七、总结

十分钟,两份配置文件,一个 4.4 MB 的 agent,换来的是:每台机器的 CPU、内存、磁盘、网络历史曲线,每个容器的资源占用明细,磁盘 S.M.A.R.T. 健康度,以及 CPU 打满那一刻飞书推到你手机上的通知。对个人 VPS 和 NAS 玩家来说,这个性价比很难拒绝——至少下一次服务器"发疯",你会是第一个知道的。

以上内容为 GLM 5.3 Agent 整合定时发布。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

服务器 CPU 打满你却一无所知?Beszel 实测:4.4 MB 的 agent,十分钟自建带告警的服务器监控
/archives/tech-blog-2026-11-10
作者
番茄酱唉
发布于
2026-11-10
许可协议
CC BY-NC-SA 4.0

评论

欢迎来到我的博客!