henrygd/beszel-agent-intel

Beszel Docker镜像文档

Beszel是一款轻量级服务器监控平台，具备Docker统计、历史数据记录和告警功能。它拥有友好的Web界面，配置简单且开箱即用，支持自动备份、多用户管理、OAuth认证及API访问。

!Docker镜像大小 !Docker镜像大小 !MIT许可证 !本地化

!Beszel仪表盘和系统页面的截图，并排显示。仪表盘展示多个已连接系统的指标，系统页面则显示单个系统的详细指标。

核心功能和特性

• 轻量级：相比主流解决方案，体积更小且资源占用更低。
• 简单易用：设置便捷，几乎无需手动配置。
• Docker统计：跟踪每个容器的CPU、内存和网络使用历史。
• 告警功能：可配置CPU、内存、磁盘、带宽、温度、负载平均值和状态的告警。
• 多用户支持：用户管理自己的系统，管理员可跨用户共享系统。
• OAuth/OIDC集成：支持多种OAuth2提供商，可禁用密码认证。
• 自动备份：支持保存到磁盘或S3兼容存储并从中恢复。

架构

Beszel由两个主要组件构成：hub和agent。

• hub：基于PocketBase构建的Web应用，提供用于查看和管理已连接系统的仪表盘。
• agent：运行在每个需要监控的系统上，将系统指标传输至hub。

使用场景和适用范围

适用于需要监控服务器和容器环境的个人用户、小型团队及企业。特别适合资源有限的环境，或需要简单部署和维护监控系统的场景，支持同时监控多台服务器及Docker/Podman容器。

详细使用方法和配置说明

快速开始

快速入门指南及其他文档可在官方网站beszel.dev获取，几分钟内即可完成部署和使用。

组件部署

Hub部署

Hub是提供仪表盘的Web应用，可通过Docker运行：

bash
docker run -d -p 8090:8090 -v ./beszel-hub:/data henrygd/beszel

Agent部署

Agent需在每个被监控的系统上运行，通过Docker部署：

bash
docker run -d \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e HUB_URL=http://your-hub-ip:8090 \
  -e AGENT_KEY=your-agent-key \
  henrygd/beszel-agent

注：具体配置参数和高级选项请参考官方文档。

截图

!仪表盘 !系统页面 !通知设置

支持的指标

• CPU使用率 - 主机系统及Docker/Podman容器
• 内存使用率 - 主机系统及容器，包括交换空间和ZFS ARC
• 磁盘使用率 - 主机系统，支持多个分区和设备
• 磁盘I/O - 主机系统，支持多个分区和设备
• 网络使用率 - 主机系统及容器
• 负载平均值 - 主机系统
• 温度 - 主机系统传感器
• GPU使用率/温度/功耗 - 仅支持Nvidia和AMD，需使用二进制agent
• 电池状态 - 主机系统电池电量

帮助与讨论

使用前请先搜索现有issue和讨论。开发者会尽力回复，但可能无法保证及时响应。

Bug报告和功能请求

Bug报告和详细功能请求请提交至https://github.com/henrygd/beszel/issues%E3%80%82

支持和一般讨论

支持请求和一般讨论可发布在https://github.com/henrygd/beszel/discussions%E6%88%96%E7%A4%BE%E5%8C%BA%E8%BF%90%E8%90%A5%E7%9A%84Matrix%E6%88%BF%E9%97%B4%EF%BC%9A%60#beszel:matrix.org%60%E3%80%82

许可证

Beszel采用MIT许可证，详情参见https://github.com/henrygd/beszel/blob/main/LICENSE%E6%96%87%E4%BB%B6%E3%80%82