waxgourd-addons/beszel/DOCS.md

# Beszel Hub

## 简介

Beszel Hub 是一个轻量级的服务器监控平台，包含 Docker 统计信息、历史数据和警报功能。

它拥有友好的 Web 界面、简单的配置，并且开箱即用。它支持自动备份、多用户、OAuth 身份验证和 API 访问。

## 功能
- **轻量级**: 比主要解决方案更小，资源占用更少。
- **简单**: 易于设置，无需公网暴露。
- **Docker 统计**: 跟踪每个容器的 CPU、内存和网络使用历史。
- **警报**: 可配置 CPU、内存、磁盘、带宽、温度、负载平均值和状态的警报。
- **多用户**: 用户管理自己的系统。管理员可以在用户之间共享系统。
- **OAuth / OIDC**: 支持多种 OAuth2 提供程序。可以禁用密码验证。
- **自动备份**: 从磁盘或 S3 兼容的存储保存和恢复数据。
- **电池**: 主机系统电池电量。

## 架构
Beszel 由两个主要组件组成：中心 (hub) 和 代理 (agent)。
- **中心 (hub)**: 一个基于 PocketBase 构建的 Web 应用程序，提供用于查看和管理连接系统的仪表板。
- **代理 (agent)**: 在您要监控的每个系统上运行，并将系统指标传递给中心。

## 支持的指标
- **CPU 使用率** - 主机系统和 Docker / Podman 容器。
- **内存使用率** - 主机系统和容器。包括交换分区和 ZFS ARC。
- **磁盘使用率** - 主机系统。支持多个分区和设备。
- **磁盘 I/O** - 主机系统。支持多个分区和设备。
- **网络使用率** - 主机系统和容器。
- **负载平均值** - 主机系统。
- **温度** - 主机系统传感器。
- **GPU 使用率 / 功耗** - Nvidia, AMD, 和 Intel。
- **电池** - 主机系统电池电量。
## 使用说明
- **启动中心(hub)**: 在加载项商店里找到Beszel Hub安装后并启动。
- **创建管理员用户**: 启动中心(hub)后，点击界面的【打开网页界面】,根据系统提示创建账号并登录。
- **配置添加系统**: 在启动中心(hub)界面中点击右上角的【添加客户端】按钮，打开添加系统对话框,填写名称和主机/ip。
- **完成添加系统**: 在中心(hub)URL界面中看到添加的新系统显示为绿色，表示添加成功。
- **注意**: 需要配合代理(Beszel Agent)进行使用