首次推出了beszel、beszel-agent;

This commit is contained in:
waxgourd
2025-12-10 18:51:36 +08:00
parent 2df5406e5b
commit 2c10251ca2
14 changed files with 204 additions and 0 deletions

39
beszel-agent/DOCS.md Normal file
View File

@@ -0,0 +1,39 @@
# Beszel Agent
## 简介
Beszel Agent 是一个轻量级的监控代理,专门用于收集主机系统的 Docker 容器指标和系统性能数据并将这些数据回传到中央监控服务器Beszel Hub
## 功能
- **轻量级**: 比主要解决方案更小,资源占用更少。
- **简单**: 易于设置,无需公网暴露。
- **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)后,点击界面的【打开网页界面】,根据系统提示创建账号并登录。
- **启动代理(agent)**: 在加载项商店里找到Beszel Agent并安装。
- **配置添加系统**: 在启动中心(hub)界面中点击右上角的【添加客户端】按钮,打开添加系统对话框,根据提示填写信息。
- **配置代理(agent)并启动**: 将中心(hub)的【添加系统】对话框里自动生成的公钥、令牌和中心(hub)URL地址分别粘贴到代理的配置中点击【启动】。
- **完成添加系统**: 在中心(hub)URL界面中看到添加的新系统显示为绿色表示添加成功。