Beszel：轻量易用的服务器监控平台 #

Beszel 是什么？ #

Beszel 是一款轻量级的服务器监控平台，它将 Docker / Podman 容器统计、历史数据与告警功能集成在一个友好的 Web 界面中，开箱即用、配置简单。

随着自托管服务和多台云主机的普及，传统监控方案（如 Prometheus + Grafana、Netdata 等）虽然功能强大，但部署复杂、资源占用高，对个人和小团队而言往往"杀鸡用牛刀"。Beszel 正是为解决这一痛点而生：它采用 Hub + Agent 的双组件架构——Hub 是基于 PocketBase 构建的中央 Web 应用，负责展示与管理面板；Agent 则运行在每一台你需要监控的主机上，轻量采集指标并上报给 Hub。整个平台占用极小、无需公网暴露，支持多用户隔离、OAuth / OIDC 单点登录、自动备份到磁盘或 S3 存储，并提供 REST API 方便接入自有脚本。它采用 MIT 许可证开源，非常适合个人 VPS 用户、家庭实验室（HomeLab）爱好者以及需要轻量监控的中小团队。

Beszel 有哪些亮点特色？ #

• 极致轻量：官方明确表示，Beszel 比主流监控解决方案体积更小、资源占用更低，Hub 与 Agent 的安装包均在十几 MB 以内，几乎不影响被监控主机性能。
• 配置简单，开箱即用：安装流程仅需部署 Hub 与 Agent 两步，几乎不需要手动配置；Agent 主动向 Hub 上报数据，无需将监控端暴露在公网，大幅降低安全风险。
• Docker / Podman 容器统计：可跟踪每个容器的 CPU、内存和网络使用历史，直观呈现各容器资源占用，是自托管爱好者的刚需功能。
• 灵活可配置的告警系统：支持为大多数监控指标设置告警阈值，并内置了 Bark、Discord、Gotify、Slack、Telegram、Pushover、Twilio、企业微信（WeCom）等数十种通知服务集成。
• 多用户与权限共享：每个用户可以独立管理自己的系统，管理员则可在用户之间共享系统，适合团队协作场景。
• OAuth / OIDC 单点登录：支持多种 OAuth2 提供程序，并可完全禁用密码认证，方便与现有身份体系集成。
• 自动备份与恢复：可将数据保存至本地磁盘或兼容 S3 的对象存储，并支持一键恢复，避免数据丢失。
• 丰富指标与深度监控：除 CPU、内存、磁盘、网络、负载、温度、风扇转速外，还支持 GPU 使用率与功耗（Nvidia / AMD / Intel）、电池电量、S.M.A.R.T. 磁盘健康、ZFS 存储池、以及 ICMP / TCP / HTTP / DNS 网络探测。
• REST API 与第三方集成：可通过 REST API 在自有脚本和应用程序中读取或更新数据，并可与 Home Assistant、Synology 等第三方生态集成。

免费下载 Beszel #

以下为官方提供的各平台安装包，包含 Hub（控制端）与 Agent（被监控端）两类文件。请根据自己的操作系统与 CPU 架构选择对应版本，点击链接即可下载。

提示：生产环境更推荐使用 Docker 方式部署 Hub 与 Agent，以便统一管理、升级与自动重启。上述二进制包则适合在不同平台上快速体验或手动部署。

Beszel 如何使用？ #

Beszel 的使用流程围绕"Hub + Agent"两个组件展开，整体只需 4~5 步即可完成搭建：

1. 部署 Hub（中央控制端）：在你选定的服务器或本机运行 Hub。推荐使用官方 Docker 镜像启动（一条 docker run 命令即可），也可以直接运行下载的 beszel 二进制。Hub 默认会在指定端口（如 8090）启动 Web 服务。
2. 注册管理员账户：首次访问 Hub 的 Web 地址时，系统会引导你创建管理员账号，完成后即可进入仪表板界面。
3. 部署 Agent（被监控端）：在需要监控的每一台主机上运行 beszel-agent。启动 Agent 时需要提供 Hub 生成的公钥以及一个 SSH 密钥或令牌，用于与 Hub 安全通信。
4. 在 Hub 中添加系统：进入 Hub 的 "Add system" 页面，填写系统名称、主机地址、端口以及 Agent 密钥。提交后 Hub 会立即开始接收指标数据，并在面板上绘制实时图表。
5. 查看监控与配置告警：在系统详情页可查看 CPU、内存、磁盘、网络、容器、温度、GPU 等指标的历史曲线；进入 Settings → Notifications 可配置 Telegram、Slack、企业微信等通知服务，为指定指标设置告警阈值。
6. （可选）启用自动备份与 REST API：在设置中把数据备份目标指向本地磁盘或 S3 兼容存储；如有二次开发需求，可通过 REST API 读取或写入数据。

Agent 通常以 systemd 服务、Docker 容器或后台进程方式常驻运行，无需人工干预。

Beszel 的常见问题？ #

Beszel 是免费的吗？ 是的。Beszel 采用 MIT 许可证发布，全部功能完全开源免费，无需付费订阅。你可以自由部署、修改和分发（遵循 MIT 协议）。

Hub 和 Agent 有什么区别？ Hub 是中央 Web 应用，负责接收、存储和展示监控数据，并提供告警与用户管理功能；Agent 是运行在被监控主机上的轻量程序，只负责采集指标并上报给 Hub。一台 Hub 可以同时管理多台 Agent。

Beszel 支持哪些操作系统？ Hub 与 Agent 均提供 Linux、macOS、Windows 等多平台二进制包，也提供 Docker 镜像。Agent 还支持 FreeBSD 等系统，具体平台以官网发布页为准。

使用 Beszel 需要把监控端口暴露到公网吗？ 不需要。官方强调 Agent 主动连接 Hub 上报数据，因此无需在公网上暴露被监控系统的端口，安全性更高。

Beszel 的数据存储在哪里？ Hub 基于 PocketBase 构建，数据默认保存在本地磁盘的 PocketBase 数据库中。你也可以在设置中启用自动备份，将数据保存到本地磁盘或兼容 S3 的对象存储。

Beszel 支持哪些告警通知方式？ 官网列出了 Bark、Discord、Gotify、Google Chat、IFTTT、Join、Lark（飞书）、Mattermost、Matrix、MQTT、Ntfy、OpsGenie、Pushbullet、Pushover、Rocketchat、Signal、Slack、Teams、Telegram、Twilio、WeCom（企业微信）、Zulip Chat 等多种通知服务，并支持通用 Webhook。

为什么监控数据没有显示？ 请检查 Agent 是否已正确启动、Hub 与 Agent 之间的网络是否互通、以及添加系统时填写的密钥是否正确。若使用 Docker 部署，需确保容器网络能够访问 Hub 的端口。可参考官网 Troubleshooting 页面排查。

Beszel 如何安装？ #

Beszel 分为 Hub 与 Agent 两部分，建议优先使用 Docker 部署。以下分平台说明。

一、通过 Docker 安装（推荐） #

1. 安装 Hub：在服务器上执行官方提供的 Docker 命令，映射 Hub 的 Web 端口（默认 8090）与数据卷，容器启动后即可通过浏览器访问 http://服务器IP:8090。
2. 安装 Agent：在每台被监控主机上运行 Agent 的 Docker 容器，通过环境变量传入 Hub 公钥、令牌等参数，使 Agent 能够连接 Hub。
3. 开机自启：为容器添加 --restart unless-stopped 参数，确保主机重启后服务自动恢复。

二、Windows #

1. 下载 beszel_windows_amd64.zip（Hub）或 beszel-agent_windows_amd64.zip（Agent），解压到任意目录。
2. 双击或在命令行运行可执行文件；若要长期运行，建议注册为 Windows 服务或使用任务计划程序开机启动。
3. 浏览器访问 http://localhost:8090 完成 Hub 的初始设置。

三、macOS #

1. 根据芯片类型下载 beszel_darwin_arm64.tar.gz（Apple Silicon）或 beszel_darwin_amd64.tar.gz（Intel）。
2. 解压后通过终端运行 ./beszel serve（Hub）或 ./beszel-agent（Agent）。
3. 如提示"无法验证开发者"，可在"系统设置 → 隐私与安全性"中允许运行，或使用 xattr -d com.apple.quarantine 移除隔离属性。

四、Linux #

1. 推荐使用官方安装脚本或 Docker 镜像部署 Hub 与 Agent。
2. 也可下载对应架构的二进制包，手动创建 systemd 服务单元文件，实现开机自启与日志管理。
3. 浏览器访问 Hub 地址完成初始化。

注意：Hub 与 Agent 之间需要通过密钥安全通信，部署 Agent 前请先在 Hub 中生成对应密钥，并妥善保存。

Beszel 如何卸载？ #

Windows #

1. 如果以可执行文件方式运行：先在任务管理器中结束 beszel.exe 或 beszel-agent.exe 进程。
2. 删除安装目录及对应的可执行文件。
3. 若注册为 Windows 服务，可执行 sc delete <服务名> 删除服务。
4. 检查并清理数据目录（默认位于程序同级的 pb_data 文件夹）以及 %APPDATA% 下的残留配置。

macOS #

1. 通过活动监视器或在终端执行 pkill beszel 结束进程。
2. 删除解压目录及可执行文件。
3. 若通过 Homebrew 安装，可执行 brew uninstall beszel。
4. 清理用户目录下的相关配置或数据文件夹。

Linux #

1. 停止并禁用 systemd 服务：sudo systemctl stop beszel && sudo systemctl disable beszel。
2. 删除服务单元文件（如 /etc/systemd/system/beszel.service）并执行 sudo systemctl daemon-reload。
3. 删除二进制文件及数据目录（如 /opt/beszel、/var/lib/beszel 等）。
4. 若通过 Docker 部署，执行 docker stop <容器名> && docker rm <容器名>，并按需删除关联的数据卷。

提醒：卸载前请确认是否需要保留 Hub 的历史监控数据与备份文件，必要时先做一次导出或 S3 备份，以免误删导致数据不可恢复。