教程/NAS/正文

Beszel安装及部署教程

置顶精华原创
2025/12/25阅读时间 5 分钟

什么是 Beszel?

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

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

功能

  • 轻量级: 比主要解决方案更小,资源占用更少。

  • 简单: 易于设置,无需公网暴露。

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

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

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

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

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

  • 电池: 主机系统电池电量。

架构

Beszel 由两个主要组件组成:中心 (hub) 和 代理 (agent)

  • 中心 (hub): 一个基于 [PocketBase](https://pocketbase.io/" \t "_blank) 构建的 Web 应用程序,提供用于查看和管理连接系统的仪表板。

  • 代理 (agent): 在您要监控的每个系统上运行,并将系统指标传递给中心。

支持的指标

  • CPU 使用率 - 主机系统和 Docker / Podman 容器。

  • 内存使用率 - 主机系统和容器。包括交换分区和 ZFS ARC。

  • 磁盘使用率 - 主机系统。支持多个分区和设备。

  • 磁盘 I/O - 主机系统。支持多个分区和设备。

  • 网络使用率 - 主机系统和容器。

  • 负载平均值 - 主机系统。

  • 温度 - 主机系统传感器。

  • GPU 使用率 / 温度 / 功耗 - 仅限 Nvidia 和 AMD。必须使用二进制代理。

显示多个已连接系统的仪表板页面

图形用户界面

教程开始

以fnOS为例,在文件管理-docker文件夹中创建如下两个文件夹(群晖需要在beszel中提前创建beszel_data和beszel_socket两个文件,在beszel-agent中创建beszel_agent_data文件夹,fnOS可以不创建)

图形用户界面, 文本, 应用程序

打开Docker,选择Compose,点击新增项目

图形用户界面, 文本, 应用程序, 电子邮件

填写项目名称,选择上面创建的beszel文件夹路径,选择docker-compose.yml,将compose代码复制到代码框中,修改代码volumes部分中 /vol2/1000/docker/beszel 修改为自己上面创建的beszel的原始路径(右击beszel文件夹-详细信息-复制原始路径),勾选创建项目后立即启动,点击确定

图形用户界面, 文本, 应用程序

显示如下内容说明容器安装成功

文本

浏览器输入fnOS的IP地址:8090,即可打开Beszel登录页面,输入邮箱和密码创建账户

图形用户界面

创建账户后,进入到Beszel仪表板页面,点击右上角添加客户端

图形用户界面, 文本, 应用程序, 电子邮件

输入主机名称,填写fnOS主机IP地址,端口号,点击复制docker compose文件,先不要点击创建客户端

图形用户界面, 文本, 应用程序, 聊天或短信

接下来返回Docker,选择Compose,点击新增项目,填写项目名称,选择上面创建的beszel-agent文件夹路径,选择docker-compose.yml,将上面复制的compose代码复制到代码框中,修改代码volumes部分中 /vol2/1000/docker/beszel-agent 修改为自己上面创建的beszel-agent的原始路径(右击beszel文件夹-详细信息-复制原始路径),勾选创建项目后立即启动,点击确定

图形用户界面, 文本, 应用程序, Teams

显示如下内容,容器创建成功

文本

返回Beszel仪表板,点击创建客户端

图形用户界面, 文本, 应用程序, 聊天或短信, 电子邮件

稍等片刻,显示fnOS运行状态,客户端添加成功

图形用户界面, 应用程序

点击右上角视图可以切换布局,选择监控信息

图片包含 表格

点击系统可查看更多信息

图形用户界面, 应用程序

图形用户界面, 应用程序

鼠标放在卡片上可以查看docker内存占用情况