henrygd/beszel

Beszel

镜像概述和主要用途

Beszel 是一款轻量级服务器监控平台，专注于提供 Docker 容器统计、历史性能数据及告警功能。其设计目标是简化服务器监控流程，通过友好的 Web 界面、极简配置实现开箱即用，同时支持自动备份、多用户管理、OAuth 认证及 API 访问，适用于个人服务器、小型数据中心及资源受限环境的监控需求。

核心功能和特性

核心优势

• 轻量级架构：相比主流监控方案，资源占用更小，部署更灵活。
• 极简配置：无需复杂手动配置，快速完成部署与接入。
• Docker 容器监控：追踪容器 CPU、内存、网络使用的历史数据。
• 多维度告警：支持 CPU、内存、磁盘、带宽、温度、负载及状态的可配置告警。
• 多用户管理：用户独立管理自有系统，管理员可跨用户共享系统权限。
• OAuth/OIDC 集成：兼容主流 OAuth2 提供商，支持禁用密码认证。
• 自动备份：支持本地磁盘或 S3 兼容存储的备份与恢复。

架构

Beszel 采用分布式架构，包含两个核心组件：hub 和 agent。

Hub

基于 PocketBase 构建的 Web 应用，提供监控仪表盘，用于集中查看和管理所有接入的服务器。

Agent

运行在被监控的服务器上，负责采集系统指标并发送至 hub。

使用场景和适用范围

目标用户

• 系统管理员、DevOps 工程师
• 个人服务器/小型集群管理者
• 需要多用户协作监控的团队

适用场景

• 轻量级服务器监控（资源受限环境优先）
• Docker/Podman 容器集群性能追踪
• 多系统统一监控与告警管理
• 需 OAuth 认证及权限隔离的企业环境

详细使用方法和配置说明

前置要求

• Docker 或 Podman 环境
• 网络连通性（agent 需访问 hub 服务）

Docker 部署方案

Hub 部署

通过 Docker 快速启动 hub 服务：

bash
docker run -d \
  --name beszel-hub \
  -p 8090:8090 \
  -v ./beszel-hub-data:/pb_data \  # 持久化存储配置与数据
  -e TZ=Asia/Shanghai \            # 设置时区
  henrygd/beszel:latest

访问 http://<hub-ip>:8090 即可打开 Web 界面，首次登录需创建管理员账户。

Agent 部署

在需监控的服务器上部署 agent，连接至 hub：

bash
docker run -d \
  --name beszel-agent \
  -v /var/run/docker.sock:/var/run/docker.sock \  # 访问 Docker 容器数据
  -v /proc:/host/proc:ro \                        # 读取主机系统指标
  -v /sys:/host/sys:ro \
  -e HUB_URL="http://<hub-ip>:8090" \             # hub 服务地址（必填）
  -e AGENT_KEY="your-agent-key" \                 # 从 hub 获取的 agent 密钥（必填）
  -e POLL_INTERVAL=10 \                           # 指标采集间隔（秒，默认 10）
  henrygd/beszel-agent:latest

Docker Compose 配置示例

本地监控场景（hub 与 agent 部署在同一主机）：

yaml
version: "3"
services:
  hub:
    image: henrygd/beszel:latest
    container_name: beszel-hub
    ports:
      - "8090:8090"
    volumes:
      - ./hub-data:/pb_data
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped

  agent:
    image: henrygd/beszel-agent:latest
    container_name: beszel-agent
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /proc:/host/proc:ro
      - /sys:/host/sys:ro
    environment:
      - HUB_URL="http://hub:8090"  # 容器内通过服务名访问 hub
      - AGENT_KEY="your-agent-key"
      - POLL_INTERVAL=10
    depends_on:
      - hub
    restart: unless-stopped

配置参数说明

Hub 核心环境变量

Agent 核心环境变量

支持的监控指标

主机系统指标

• CPU 使用率（整体及核心级）
• 内存使用率（含交换空间、ZFS ARC）
• 磁盘使用率（多分区/设备支持）
• 磁盘 I/O（读写速率、IOPS）
• 网络流量（进出带宽、连接数）
• 系统负载（1/5/15 分钟平均负载）
• 硬件温度（传感器数据）
• GPU 监控（仅限 Nvidia/AMD，需二进制 agent 支持）：使用率、温度、功耗

Docker/Podman 容器指标

• CPU 使用率
• 内存使用率
• 网络流量（进出）

截图

!仪表盘
多系统聚合监控仪表盘

!系统详情页
单系统详细指标页面

!告警配置
告警规则与通知设置界面

帮助与支持

问题反馈

• Bug 报告：提交至 https://github.com/henrygd/beszel/issues
• 功能请求：通过 https://github.com/henrygd/beszel/discussions 提交

社区支持

• Matrix 房间：#beszel:matrix.org（访问链接）
• 官方文档：beszel.dev

许可证

Beszel 采用 MIT 许可证开源，详见 https://github.com/henrygd/beszel/blob/main/LICENSE 文件。