一、前言

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

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

功能：

轻量级：比主要解决方案更小，资源占用更少。

简单：易于设置，无需公网暴露。

Docker 统计：跟踪每个容器的 CPU、内存和网络使用历史。

警报：可配置 CPU、内存、磁盘、带宽、温度、负载平均值和状态的警报。

多用户：用户管理自己的系统。管理员可以在用户之间共享系统。

OAuth / OIDC：支持多种 OAuth2 提供程序。可以禁用密码验证。

自动备份：从磁盘或 S3 兼容的存储保存和恢复数据。

二、教程

这里以docker做为演示

server安装

# docker-compose.yml
services:
  beszel:
    image: henrygd/beszel
    container_name: beszel
    restart: unless-stopped
    ports:
      - 8090:8090
    volumes:
      - ./beszel_data:/beszel_data #需要改文件存储路径

# 创建目录目录
xxxx@xxxx-PowerEdge-R710:~/wxm$ mkdir beszel

docker run -d \
  --name beszel \
  --restart=unless-stopped \
  -v ./beszel_data:/beszel_data \
  -p 8090:8090 \
  henrygd/beszel

agent安装

services:
  beszel-agent:
    image: henrygd/beszel-agent
    container_name: beszel-agent
    restart: unless-stopped
    network_mode: host
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
      - ./beszel_agent_data:/var/lib/beszel-agent
      # monitor other disks / partitions by mounting a folder in /extra-filesystems
      # - /mnt/disk/.beszel:/extra-filesystems/sda1:ro
    environment:
      LISTEN: 45876
      KEY: 'ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIBDOIOGDyCxoQIArMmJDzCqqzDa+KTOu6W9JWJ9duf5j'
      TOKEN: ngDNRCHoyBUPrnxKC9FO
      HUB_URL: http://172.16.17.54:8090

GPU监控

| 厂商 | 监控方式 | 说明 |

| ----------------- | --------------------------------------- | ----------------------------- |

| NVIDIA | nvidia-smi (默认) / nvml | 需要安装 NVIDIA 驱动 |

| AMD | amd_sysfs (推荐) / rocm-smi / nvtop | amd_sysfs 通过 sysfs 直接监控，更高效 |

| Intel | intel_gpu_top | 支持 Intel 显卡监控 |

| NVIDIA Jetson | tegrastats | Jetson 开发板专用 |

二进制(实际使用)

# 二进制安装命令示例
curl -sL https://raw.githubusercontent.com/henrygd/beszel/main/supplemental/scripts/install-agent.sh -o install-agent.sh && chmod +x install-agent.sh && ./install-agent.sh -p 45876 -k "你的SSH公钥"
# ssh公钥示例
ssh-ed25519 AAAAC3NzaC... 你的公钥

# 查看当前服务文件，确认密钥配置
sudo cat /etc/systemd/system/beszel-agent.service

| 变量              | 说明                                             |
| --------------- | ---------------------------------------------- |
| `GPU_COLLECTOR` | 指定要使用的收集器，如 `nvidia-smi`、`amd_sysfs`、`nvtop` 等 |
| `SKIP_GPU`      | 设置为 `true` 可禁用 GPU 监控                          |

ssh公钥获取

Docker(未验证)

beszel-agent:
  image: henrygd/beszel-agent-nvidia
  deploy:
    resources:
      reservations:
        devices:
          - driver: nvidia
            count: all
            capabilities:
              - utility