手头三四台服务器,平时谁也顾不上看 CPU 和磁盘,直到某台磁盘写满、某个容器悄悄重启,才想起来上去查一眼。Beszel 干的就是这件事:给每台机器放一个很小的采集器,网页上一张总览表把所有主机的状态排在面前,异常还能主动发通知。
项目名片
| 项目 | 信息 |
|---|---|
| 仓库 | henrygd/beszel |
| 数据 | 27,307 star(2026-11-14 抓取) |
| 技术栈 | Go / PocketBase |
| 许可证 | MIT |
| 最新版本 | v0.21.2(2026-11-12 发布) |
| 默认端口 | Hub 8090,Agent 45876 |
它解决什么问题
几台自托管服务器的观测困境:Prometheus 加 Grafana 是标准答案,但组件多、配置长,装完还要维护;每台机器各看各的 htop,又没有全局视角。Beszel 只有两个组件:Hub 是网页面板,Agent 是装在被监控机上的采集器,Go 编译的单文件,官方 README 明确写着比同类方案更轻、占用资源更少。指标覆盖 CPU、内存、磁盘、网络、温度、GPU、S.M.A.R.T. 硬盘健康和每个容器的用量,还带告警、多用户、OAuth 登录和自动备份,Docker 和 Podman 都支持(官方文档分别给出了两种运行命令)。某些场景可替代重型监控栈:装好就用、数据留在自己机器上;替不掉的是长周期明细存储、自定义查询语言和告警插件生态。
核心机制
- Hub 基于 PocketBase 构建,负责面板、用户和告警配置;Agent 在每台被监控机上采集指标上报(README 的 Architecture 一节原文如此)。(推断:复用 PocketBase 省掉了自建后端和数据库,所以备份能直接走 S3)
- Agent 与 Hub 有两条通道:Agent 主动向 Hub 的 agent-connect 接口发起 WebSocket,Hub 也可以反向连 Agent 的 TCP 端口,任意一条通就能工作(官方文档 Common Issues 页写明)。(推断:双通道让内网穿透部署更灵活)
- 容器统计来自 Docker socket,因此以容器方式跑 Agent 时必须只读挂载 docker.sock,远程 Agent 官方还要求 host 网络模式以读取网卡流量(官方 Agent 安装文档)。
- 周、月粒度的记录由短周期数据平均而来,Agent 中断超过一分钟,当期统计作废(官方文档写明)。(推断:保活和定时备份要认真对待)
- 从 0.12.0 版本起支持通用令牌:在 Hub 的设置里生成一个令牌,Agent 用它连上来即可,不用提前在网页里逐台登记公钥(官方快速开始文档注明)。
跑起来
在 hub 所在机器建目录,写两个文件。先建 .env:
AGENT_DIR=./beszel_agent_data
DOCKER_SOCK=/var/run/docker.sock
再写 docker-compose.yml(含本机 agent):
services:
beszel:
image: henrygd/beszel:latest
ports:
- 8090:8090
volumes:
- ./beszel_data:/beszel_data
- ./beszel_socket:/beszel_socket
environment:
APP_URL: http://localhost:8090
beszel-agent:
image: henrygd/beszel-agent:latest
network_mode: host
volumes:
- ${AGENT_DIR}:/var/lib/beszel-agent
- ./beszel_socket:/beszel_socket
- ${DOCKER_SOCK}:${DOCKER_SOCK}:ro
environment:
LISTEN: /beszel_socket/beszel.sock
HUB_URL: http://localhost:8090
启动:
docker compose up -d
注意把 compose 里的 APP_URL 改成你实际访问 Hub 的地址,比如带公网 IP 或域名的完整地址,官方文档把这一步列为必做项,不改会影响后续登录和通知回调。
远程机器装 Agent 最省事的方式是官方二进制脚本(需要 root),公钥和令牌从网页的 Add System 对话框里复制:
curl -sL https://get.beszel.dev \
-o /tmp/install-agent.sh
chmod +x /tmp/install-agent.sh
/tmp/install-agent.sh
从零到能用
- 浏览器打开 http://你的服务器IP:8090,首次访问创建管理员账号。
- 点右上角 Add System,本机就在 Host 里填 unix socket 路径 /beszel_socket/beszel.sock。
- 对话框会给出远程机器的 agent 配置或安装命令,照抄到目标机执行。
- 回到对话框点确认,总览表里这台机器的图标变绿就是通了。
- 点进系统详情,看 CPU、内存、磁盘和容器图表。
- 在告警设置里加规则,比如磁盘用量超过九成时发邮件通知。
适合谁用 / 别用
适合:手里有三五台自托管服务器或一台 NAS、想要一张总览表加基础告警的个人开发者和小团队,今晚装好,第二天就能截图进周报。数据全部落在 hub 那台机器的 beszel_data 目录里,迁走目录就等于搬完家。别用:需要保存秒级明细、做复杂自定义大盘的场景,内嵌存储不是时序数据库,这个规模该上 Prometheus 那套生态。
三个真实的坑
- Hub 和 Agent 在同一台机器上跑,配置里写 localhost 连不通:两个容器分属不同网络,官方文档建议改用共享 unix socket,在网页里把 Host 填成 socket 路径(官方 Common Issues 页原文)。
- 挂了反代后实时数据不动:代理层的 gzip 压缩会破坏 SSE 流,官方要求对 text/event-stream 类型关闭压缩,Agent 走反代时还要放行 WebSocket(官方 Common Issues 页原文)。
- rootless 方式跑 Agent 时容器统计缺失:官方文档说要使用正确的 socket 路径并给 cgroup 开启 CPU 委托,温度、GPU、S.M.A.R.T. 也可能拿不到,具体方案见 issue #640。
小结
回到开头:磁盘写满才想起来上去看一眼,这种事交给一个十几兆的面板盯就够了。Beszel 装起来不费劲,表格一眼扫完,告警直达邮箱,对个人和小团队来说正好够用。
参考资料
- 仓库:https://github.com/henrygd/beszel
- 快速开始:https://beszel.dev/guide/getting-started
- 常见问题:https://beszel.dev/guide/common-issues
- 版本发布:https://github.com/henrygd/beszel/releases/tag/v0.21.2
- rootless 统计方案:https://github.com/henrygd/beszel/issues/640
默认评论
Halo系统提供的评论