henrygd/beszel-agent

Beszel - 轻量级服务器监控平台

镜像概述和主要用途

Beszel 是一款轻量级服务器监控平台，具备 Docker 统计、历史数据记录和告警功能。其核心优势在于友好的 Web 界面、简化的配置流程和开箱即用的特性，支持自动备份、多用户管理、OAuth 认证及 API 访问。适用于需要高效监控服务器及容器资源的场景，尤其适合资源受限或追求简单部署的环境。

核心功能和特性

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

架构

Beszel 由两个核心组件构成：hub 和 agent。

• Hub：基于 PocketBase 构建的 Web 应用，提供仪表盘功能，用于查看和管理已连接的系统。
• Agent：运行在需监控的目标系统上，负责收集系统指标并发送至 Hub。

使用场景和适用范围

• 个人服务器监控：跟踪家庭或个人服务器的资源使用情况。
• 小型企业环境：监控多台服务器及 Docker/Podman 容器的实时状态。
• 资源受限场景：适合对服务器资源占用敏感的环境，如边缘计算节点。
• 多用户协作：团队内部分工管理不同系统，管理员统一分配权限。

详细使用方法和配置说明

前提条件

• 运行 Hub 和 Agent 的环境需安装 Docker 或 Podman。
• 网络需确保 Agent 可访问 Hub（默认通过 HTTP/HTTPS 通信）。

Hub 部署

Hub 作为核心组件，提供 Web 界面和数据存储功能。

Docker Run 命令

bash
docker run -d \
  --name beszel-hub \
  -p 8090:8090 \  # Web 界面端口
  -v ./beszel-hub-data:/pb_data \  # 数据持久化
  -e TZ=Asia/Shanghai \  # 设置时区
  henrygd/beszel:latest

Docker Compose 示例

yaml
version: '3'
services:
  beszel-hub:
    image: henrygd/beszel:latest
    container_name: beszel-hub
    ports:
      - "8090:8090"
    volumes:
      - ./beszel-hub-data:/pb_data
    environment:
      - TZ=Asia/Shanghai
      # 更多配置参数可参考官方文档：https://beszel.dev/guide/hub-configuration
    restart: unless-stopped

配置说明

• 数据持久化：通过 -v ./beszel-hub-data:/pb_data 挂载目录，确保数据（配置、指标、用户信息）不丢失。
• 端口映射：默认使用 8090 端口，可根据需求修改（如 -p 80:8090）。
• 环境变量：支持时区（TZ）、数据库配置、OAuth 提供商设置等，详细参数见 官方 Hub 配置指南。

Agent 部署

Agent 需部署在每台待监控的服务器上，负责收集并发送指标至 Hub。

Docker Run 命令

bash
docker run -d \
  --name beszel-agent \
  --net=host \  # 需 host 网络以获取准确系统指标
  --privileged \  # 访问系统传感器（如温度）时需要
  -v /var/run/docker.sock:/var/run/docker.sock \  # 监控 Docker 容器（可选）
  -v /proc:/host/proc:ro \  # 读取系统进程信息
  -v /sys:/host/sys:ro \  # 读取系统设备信息
  -e HUB_URL="http://your-hub-ip:8090" \  # Hub 访问地址
  -e AGENT_TOKEN="your-agent-token" \  # 从 Hub 获取的 Agent 令牌
  -e TZ=Asia/Shanghai \
  henrygd/beszel-agent:latest

配置说明

• 网络模式：使用 --net=host 确保 Agent 能获取主机网络指标。
• 权限与挂载：
  • /var/run/docker.sock：用于监控 Docker 容器（若无需监控容器可移除）。
  • /proc 和 /sys：只读挂载，用于收集系统 CPU、内存、磁盘等指标。
• 核心环境变量：
  • HUB_URL：Hub 的访问地址（需确保 Agent 可访问）。
  • AGENT_TOKEN：在 Hub 中添加系统后生成的令牌，用于 Agent 认证。
  • 更多参数（如采集间隔、代理设置）见 官方 Agent 配置指南。

初始设置流程

1. 启动 Hub：按上述命令启动 Hub 容器，访问 http://hub-ip:8090 进入 Web 界面。
2. 创建管理员账户：首次访问时注册管理员用户。
3. 添加系统：在 Hub 界面中创建“系统”，获取 Agent 令牌。
4. 启动 Agent：在待监控服务器上运行 Agent 容器，填入 HUB_URL 和 AGENT_TOKEN。
5. 查看指标：Agent 连接成功后，在 Hub 仪表盘查看实时/历史指标，配置告警规则。

支持的指标

• CPU 使用率：主机系统及 Docker/Podman 容器。
• 内存使用率：主机系统及容器，含交换空间和 ZFS ARC。
• 磁盘使用率：主机系统，支持多分区和设备。
• 磁盘 I/O：主机系统，支持多分区和设备。
• 网络使用率：主机系统及容器。
• 负载均值：主机系统。
• 温度：主机传感器数据。
• GPU 使用率/温度/功耗：仅支持 Nvidia 和 AMD 显卡（需使用二进制 Agent）。

截图

!仪表盘
!系统详情页
!告警设置

帮助与支持

• 官方文档：完整指南和配置说明见 beszel.dev。
• 问题反馈：Bug 报告和功能请求请提交至 https://github.com/henrygd/beszel/issues%E3%80%82
• 社区讨论：通过 https://github.com/henrygd/beszel/discussions 或 Matrix 房间 #beszel:matrix.org 交流。

许可证

Beszel 采用 MIT 许可证，详见 https://github.com/henrygd/beszel/blob/main/LICENSE%E3%80%82