服务器 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:
- Host / IP 一栏填
/beszel_socket/beszel.sock——本地 unix socket 路径,官方文档就是这么写的,不用填 IP; - 对话框会给你一个公钥,填进 compose 的
KEY;token 则到/settings/tokens页面生成一个,填进TOKEN; - 再跑一次
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>"
三个值得注意的点: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 整合定时发布。

