小岳
2026-11-14
点 赞
0
热 度
0
评 论
0

Beszel:一台小面板管住所有服务器

  1. 首页
  2. 开源分享
  3. Beszel:一台小面板管住所有服务器

文章摘要

摸鱼小助手

手头三四台服务器,平时谁也顾不上看 CPU 和磁盘,直到某台磁盘写满、某个容器悄悄重启,才想起来上去查一眼。Beszel 干的就是这件事:给每台机器放一个很小的采集器,网页上一张总览表把所有主机的状态排在面前,异常还能主动发通知。

项目名片

项目 信息
仓库 henrygd/beszel
数据 27,307 star(2026-11-14 抓取)
技术栈 Go / PocketBase
许可证 MIT
最新版本 v0.21.2(2026-11-12 发布)
默认端口 Hub 8090,Agent 45876

它解决什么问题

几台自托管服务器的观测困境:Prometheus 加 Grafana 是标准答案,但组件多、配置长,装完还要维护;每台机器各看各的 htop,又没有全局视角。Beszel 只有两个组件:Hub 是网页面板,Agent 是装在被监控机上的采集器,Go 编译的单文件,官方 README 明确写着比同类方案更轻、占用资源更少。指标覆盖 CPU、内存、磁盘、网络、温度、GPU、S.M.A.R.T. 硬盘健康和每个容器的用量,还带告警、多用户、OAuth 登录和自动备份,Docker 和 Podman 都支持(官方文档分别给出了两种运行命令)。某些场景可替代重型监控栈:装好就用、数据留在自己机器上;替不掉的是长周期明细存储、自定义查询语言和告警插件生态。

核心机制

  1. Hub 基于 PocketBase 构建,负责面板、用户和告警配置;Agent 在每台被监控机上采集指标上报(README 的 Architecture 一节原文如此)。(推断:复用 PocketBase 省掉了自建后端和数据库,所以备份能直接走 S3)
  2. Agent 与 Hub 有两条通道:Agent 主动向 Hub 的 agent-connect 接口发起 WebSocket,Hub 也可以反向连 Agent 的 TCP 端口,任意一条通就能工作(官方文档 Common Issues 页写明)。(推断:双通道让内网穿透部署更灵活)
  3. 容器统计来自 Docker socket,因此以容器方式跑 Agent 时必须只读挂载 docker.sock,远程 Agent 官方还要求 host 网络模式以读取网卡流量(官方 Agent 安装文档)。
  4. 周、月粒度的记录由短周期数据平均而来,Agent 中断超过一分钟,当期统计作废(官方文档写明)。(推断:保活和定时备份要认真对待)
  5. 从 0.12.0 版本起支持通用令牌:在 Hub 的设置里生成一个令牌,Agent 用它连上来即可,不用提前在网页里逐台登记公钥(官方快速开始文档注明)。

跑起来

在 hub 所在机器建目录,写两个文件。先建 .env:

AGENT_DIR=./beszel_agent_data
DOCKER_SOCK=/var/run/docker.sock

再写 docker-compose.yml(含本机 agent):

services:
  beszel:
    image: henrygd/beszel:latest
    ports:
      - 8090:8090
    volumes:
      - ./beszel_data:/beszel_data
      - ./beszel_socket:/beszel_socket
    environment:
      APP_URL: http://localhost:8090
  beszel-agent:
    image: henrygd/beszel-agent:latest
    network_mode: host
    volumes:
      - ${AGENT_DIR}:/var/lib/beszel-agent
      - ./beszel_socket:/beszel_socket
      - ${DOCKER_SOCK}:${DOCKER_SOCK}:ro
    environment:
      LISTEN: /beszel_socket/beszel.sock
      HUB_URL: http://localhost:8090

启动:

docker compose up -d

注意把 compose 里的 APP_URL 改成你实际访问 Hub 的地址,比如带公网 IP 或域名的完整地址,官方文档把这一步列为必做项,不改会影响后续登录和通知回调。

远程机器装 Agent 最省事的方式是官方二进制脚本(需要 root),公钥和令牌从网页的 Add System 对话框里复制:

curl -sL https://get.beszel.dev \
  -o /tmp/install-agent.sh
chmod +x /tmp/install-agent.sh
/tmp/install-agent.sh

从零到能用

  1. 浏览器打开 http://你的服务器IP:8090,首次访问创建管理员账号。
  2. 点右上角 Add System,本机就在 Host 里填 unix socket 路径 /beszel_socket/beszel.sock。
  3. 对话框会给出远程机器的 agent 配置或安装命令,照抄到目标机执行。
  4. 回到对话框点确认,总览表里这台机器的图标变绿就是通了。
  5. 点进系统详情,看 CPU、内存、磁盘和容器图表。
  6. 在告警设置里加规则,比如磁盘用量超过九成时发邮件通知。

适合谁用 / 别用

适合:手里有三五台自托管服务器或一台 NAS、想要一张总览表加基础告警的个人开发者和小团队,今晚装好,第二天就能截图进周报。数据全部落在 hub 那台机器的 beszel_data 目录里,迁走目录就等于搬完家。别用:需要保存秒级明细、做复杂自定义大盘的场景,内嵌存储不是时序数据库,这个规模该上 Prometheus 那套生态。

三个真实的坑

  1. Hub 和 Agent 在同一台机器上跑,配置里写 localhost 连不通:两个容器分属不同网络,官方文档建议改用共享 unix socket,在网页里把 Host 填成 socket 路径(官方 Common Issues 页原文)。
  2. 挂了反代后实时数据不动:代理层的 gzip 压缩会破坏 SSE 流,官方要求对 text/event-stream 类型关闭压缩,Agent 走反代时还要放行 WebSocket(官方 Common Issues 页原文)。
  3. rootless 方式跑 Agent 时容器统计缺失:官方文档说要使用正确的 socket 路径并给 cgroup 开启 CPU 委托,温度、GPU、S.M.A.R.T. 也可能拿不到,具体方案见 issue #640。

小结

回到开头:磁盘写满才想起来上去看一眼,这种事交给一个十几兆的面板盯就够了。Beszel 装起来不费劲,表格一眼扫完,告警直达邮箱,对个人和小团队来说正好够用。

参考资料

  • 仓库:https://github.com/henrygd/beszel
  • 快速开始:https://beszel.dev/guide/getting-started
  • 常见问题:https://beszel.dev/guide/common-issues
  • 版本发布:https://github.com/henrygd/beszel/releases/tag/v0.21.2
  • rootless 统计方案:https://github.com/henrygd/beszel/issues/640

本站站长,主角光环,怎么滴,你还想攻击你的站长吗,真是好big的狗胆

小岳

intp 逻辑家

站长

不具版权性
不具时效性

文章内容不具时效性。若文章内容有错误之处,请您批评指正。

目录

欢迎来到摸鱼干货栈,这里为您提供开源与摸鱼源码

43 文章数
7 分类数
0 评论数
47标签数
最近评论