Beszel

介绍

Beszel 是一个轻量级服务器监控平台，由 Hub 和 Agent 两部分组成：

• Hub：提供管理界面，负责展示指标、历史数据和告警信息。
• Agent：部署在被监控主机上，采集系统与容器运行指标。

支持监控 CPU、内存、磁盘、网络、温度及 Docker 容器状态等信息。

部署 Beszel Hub

创建部署目录：

mkdir -p ~/apps/beszel
cd ~/apps/beszel

创建 compose.yml：

services:
  beszel:
    image: henrygd/beszel:latest
    container_name: beszel
    restart: unless-stopped
    ports:
      - '8090:8090'
    volumes:
      - ./beszel_data:/beszel_data
    environment:
      APP_URL: http://服务器地址:8090

APP_URL 应填写实际访问 Hub 的地址，用于邮件和通知中的链接。使用域名时可填写 https://beszel.example.com。

启动服务：

docker compose up -d

访问 http://<服务器地址>:8090，根据页面提示创建管理员账户并登录。

部署 Agent

Agent 部署在需要监控的服务器上。其 Compose 配置由 Hub 根据系统信息自动生成，不需要手动填写公钥、令牌和 Hub 地址。

1. 添加系统

在 Hub 中选择 Add System，填写以下信息：

• 名称：用于区分服务器。
• 主机 / IP：被监控服务器的地址。
• 端口：Agent 的监听端口，默认使用页面提供的值。

公钥和令牌由 Hub 自动生成。切换到 Docker，点击 复制 docker compose 文件。

2. 创建 Agent 部署目录

登录被监控服务器，创建并进入部署目录：

mkdir -p ~/apps/beszel-agent
cd ~/apps/beszel-agent

创建 compose.yml，粘贴从 Hub 复制的完整内容。复制的配置通常已经包含 KEY、TOKEN、HUB_URL、监听端口及所需的数据卷。

3. 启动 Agent

docker compose up -d
docker compose logs --tail 100 beszel-agent

返回 Hub 保存系统。系统状态变为绿色后，即表示 Hub 已与 Agent 建立连接。

注意事项

• 不要将包含 KEY 和 TOKEN 的 compose.yml 提交到公开仓库。
• 每台被监控服务器分别部署一个 Agent，并使用各自在 Hub 中生成的配置。
• 需要监控 Docker 容器时，保留复制配置中的 Docker Socket 挂载。

参考

• Beszel Getting Started
• Beszel Agent Installation