开源项目自动化与 Agent 类新手
Beszel:轻量级服务器监控平台(Docker 统计、历史数据与告警)
Beszel 是一个轻量级服务器监控平台,内置 Docker 统计、历史数据与告警功能,提供友好的 Web 界面、开箱即用的简单配置,并支持自动备份、多用户、OAuth/OIDC 认证与 API 访问。项目采用 Hub + Agent 架构,Hub 基于 PocketBase 构建,Agent 部署在每台被监控主机上。
0 次阅读2026/09/15 发布
社区作者 · zZz
它解决什么问题
项目概览
Beszel 是一个轻量级服务器监控平台,包含 Docker 统计、历史数据和告警功能。它提供友好的 Web 界面、简单的配置方式,开箱即可使用,并支持自动备份、多用户、OAuth 认证和 API 访问。
配图 1 展示了 Beszel 仪表盘与单机系统页并排的效果:仪表盘汇总多台已连接系统的指标,系统页展示单台主机的详细指标。
核心特性
- **轻量**:相比主流监控方案体积更小、资源占用更低。
- **简单**:安装配置简单,几乎不需要手动配置。
- **Docker 统计**:跟踪每个容器的 CPU、内存和网络使用历史。
- **ZFS**:跟踪存储池容量、健康状态与 I/O,并提供每个 dataset 的使用情况。
- **告警**:可针对 CPU、内存、磁盘、带宽、温度、风扇转速、平均负载和状态配置告警。
- **多用户**:用户可以管理自己的系统;管理员可在多个用户之间共享系统。
- **OAuth / OIDC**:支持多种 OAuth2 提供方,可禁用密码认证。
- **自动备份**:可备份到磁盘或兼容 S3 的存储,并从中恢复。
架构
Beszel 由两个主要组件构成:**Hub** 与 **Agent**。
- **Hub**:基于 PocketBase 构建的 Web 应用,提供查看和管理已连接系统的仪表盘。
- **Agent**:运行在每一台需要被监控的系统上,负责将系统指标上报给 Hub。
配图 2 为仪表盘(Dashboard),配图 3 为系统详情页(System page),配图 4 为通知设置页(Notification Settings)。
支持的指标
- CPU 使用率:主机系统及 Docker / Podman 容器。
- 内存使用:主机系统与容器,包含 swap 和 ZFS ARC。
- 磁盘使用:主机系统,支持多分区与多设备。
- 磁盘 I/O:主机系统,支持多分区与多设备。
- 网络使用:主机系统与容器。
- 平均负载:主机系统。
- 温度:主机系统传感器。
- 风扇转速:主机系统传感器(Linux,通过 /sys/class/hwmon)。
- GPU 使用率 / 功耗:Nvidia、AMD 和 Intel。
- 电池:主机系统电池电量。
- 容器:所有运行中的 Docker / Podman 容器的状态与指标。
- S.M.A.R.T.:主机系统磁盘健康(在可用时包含 eMMC 磨损/EOL,以及通过 sysfs 获取的 Linux mdraid 阵列健康)。
- ZFS:存储池容量、使用量、健康状态、I/O 吞吐、scrub 状态以及每个 dataset 的使用量。
快速开始与文档
快速开始指南及其他文档发布在官网 beszel.dev,按照文档操作可在几分钟内跑起来。
帮助与讨论
- 提交新问题前,请先搜索已有的 issues 和 discussions。
- Bug 报告与功能请求:GitHub issues。
- 支持请求与一般讨论:GitHub discussions,或社区运营的 Matrix 房间 #beszel:matrix.org。
许可证
Beszel 采用 MIT 许可证,详见仓库中的 LICENSE 文件。
— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
来源未提供逐条命令形式的安装清单,仅说明架构与文档入口,具体命令需以官网 beszel.dev 的快速开始指南为准(待核验)。以下为来源可支撑的部署流程:
- 准备环境:确认架构为 Hub + Agent 两部分——Hub 是基于 PocketBase 构建的 Web 应用,负责仪表盘与系统管理;Agent 运行在每台需要被监控的系统上,负责上报指标。因此至少需要一台主机运行 Hub,并在每台被监控主机上部署 Agent。
- 部署 Hub:搭建 Hub Web 应用,作为监控数据的接收端与展示端(提供查看和管理已连接系统的仪表盘)。
- 部署 Agent:在每台待监控系统上运行 Agent,使其与 Hub 建立通信并上报系统指标。
- 首次运行:访问 Hub 的 Web 界面完成初始配置,确认已连接系统出现在仪表盘(配图 2),单机详细指标见系统页(配图 3)。
- 配置告警:在通知设置(配图 4)中为 CPU、内存、磁盘、带宽、温度、风扇转速、平均负载和状态配置告警规则。
- 配置认证与多用户:可启用 OAuth2 / OIDC 登录,并可禁用密码认证;普通用户管理自己的系统,管理员可跨用户共享系统。
- 配置备份:设置自动备份,保存到磁盘或兼容 S3 的存储,并验证可从备份恢复。
常见问题(来源明确提及的排查方向):
- 新问题提交前应先搜索已有的 issues 与 discussions,避免重复提问。
- Bug 报告与功能请求走 GitHub issues;支持请求与一般讨论走 GitHub discussions 或 Matrix 房间 #beszel:matrix.org。
- 风扇转速监控依赖 Linux 的 /sys/class/hwmon;S.M.A.R.T. 中的 mdraid 阵列健康依赖 sysfs 且需系统可用;这些指标在条件不满足时可能不可用。
- 具体的安装命令、镜像名称、端口与运行参数来源未给出,需核验官网文档。
适用场景
服务器与 VPS 的轻量级资源监控(CPU
内存
磁盘
网络
负载)
Docker / Podman 容器级指标与历史趋势跟踪
ZFS 存储池容量
健康
I/O 与 dataset 用量监控
通过阈值告警及时发现 CPU
带宽
温度



