# 【教程】Beszel 极轻量探针教程

**URL:** <https://idcflare.com/t/topic/33723>\
**Category:** 教程\
**Tags:** 原创, 服务器\
**Created:** [2025 年10 月 18 日 11:50 UTC](https://idcflare.com/t/topic/33723 "2025-10-18T11:50:11Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

作者： ![Usagi](https://idcflare.com/user_avatar/idcflare.com/usagi/32/3027_2.png) [@Usagi](https://idcflare.com/u/Usagi)\
发布日期： [2025 年10 月 18 日 11:50 UTC](https://idcflare.com/t/topic/33723/1 "2025-10-18T11:50:11Z")

</div>

现在有很多轻量的小鸡探针，这边为大家介绍 [Beszel](https://github.com/henrygd/beszel) 探针。

# 1. 优缺点

## 1.1 Beszel 优点

1. 👍 可以 Rootless (Agent 与 Hub)
  - Podman 或 Rootless Docker 可以直接使用

2. 👍 可以一开始 Proxied DNS (小黄云)
3. 👍 无法远端执行命令 (对我来说是优点)
4. 👍 非常轻
5. 👍 Agent 与 Hub 都有容器版本
6. 👍 支持 WebSocket 与 SSH 连线。
7. 👍 可以看到容器的状况。
8. 👍 可以看 GPU 状况。
9. 👍 可以用电子邮件或是 Webhook (Discord, Telegram, etc) 推送通知。
10. 👍 `v0.15.0` 支持 `S.M.A.R.T.` 硬盘健康信息

> [!success] **小鸡 容器 资源信息**
> 
> ![小鸡与容器资源信息](https://idcflare.com/uploads/default/original/3X/2/9/293164a6de2e39ffabfbbb9b169fd20e65789407.png)

> [!success] **存储信息**
> 
> ![存储信息](https://idcflare.com/uploads/default/original/3X/f/d/fd97e79a5f2c0e6053fae14ca6414ba9123a51d2.png)

> [!success] **GPU信息**
> 
> ![GPU信息](https://idcflare.com/uploads/default/original/3X/4/2/42084642a14419fcabacda785324d232fe698616.png)

> [!success] **跨鸡容器总览**
> 
> ![跨鸡容器总览](https://idcflare.com/uploads/default/original/3X/6/f/6f9fc9460facd9590eedec95648dbc598c6c5633.jpeg)

> [!success] **单鸡容器总览**
> 
> ![单鸡容器总览](https://idcflare.com/uploads/default/original/3X/f/0/f049d36e05747ba4feecde8b7dce7fcd6ab2ff30.jpeg)

> [!success] **网络信息 1**
> 
> ![网络信息_1](https://idcflare.com/uploads/default/original/3X/5/1/5168f5737927b7b0543bf8451f4130b8665e3fb4.jpeg)

> [!success] **网络信息 2**
> 
> ![网络信息_2](https://idcflare.com/uploads/default/original/3X/2/5/258f99c53a4b9f6a0bc3d6ac9cbfdda8c24d151f.jpeg)

* * *

## 1.2 Beszel 缺点

1. 🥲 没有延迟测试
2. 🥲 不会显示国家/地区
3. 🥲 一定要 有帐号/登入 才可以看到小🐔
4. 🥲 没有地图显示

* * *

## 1.3 其他

1. 刷新比较慢，但是 `Beszel 0.13.0` 新增了一分钟视图，可以每秒刷新。  
(仅限单🐔)
2. komari-agent 有 [容器版本](https://github.com/komari-monitor/komari-agent/pkgs/container/komari-agent)

* * *

# 2. Beszel 教程

一般的探针都会有两端

1. 小鸡端，也就是 Agent 端
2. 探针资料收集展示端，也就是 Hub 端
3. 一个 Hub 通常会与一个或是一个以上的 Agents 建立持续的连线 (e.g., WebSocket)

## 2.1 Beszel Hub 搭建 (i.e., 与小鸡连线作为对外展示 Web 的端点)

**命令行版本**

```bash
docker run -d \
  --name beszel \
  --restart unless-stopped \
  -p 8090:8090 \
  -v ./beszel_data:/beszel_data \
  --security-opt no-new-privileges \
  henrygd/beszel

```

> [!note] 无需区网连接 Hub 时的安全设置  
> 如果不需要内网连上 Hub 的话 (特别是部署在 VPS 时)  
> 可以将 ports 改成以下，会更安全些。(感谢 @kuluoxiaohuamc 提供的建议)
> 
> ```bash
> ...
> -p 127.0.0.1:8090:8090 \
> ...
> 
> ```

**docker-compose.yml 版本**

```yml
services:
  beszel:
    image: henrygd/beszel
    container_name: beszel
    restart: unless-stopped
    ports:
      - 8090:8090
    volumes:
      - ./beszel_data:/beszel_data
    security_opt:
      - no-new-privileges

```

> [!note] 无需区网连接 Hub 时的安全设置  
> 如果不需要内网连上 Hub 的话 (特别是部署在 VPS 时)  
> 可以将 ports 改成以下，会更安全些。(感谢 @kuluoxiaohuamc 提供的建议)
> 
> ```yml
> ...
> ports:
> - 127.0.0.1:8090:8090
> ...
> 
> ```

## 2.2 搭建小鸡端 Beszel Agent

先回到刚刚搭建好的 Hub Web，进行以下操作。  
以下有两种方式，择一即可。  
通用令牌会比较方便些，特别是对那种不能从外网直通的小鸡。

不管是以下哪种方式，都可以使用容器、二进制部署。

### 2.2.1 不需要明确指定小鸡 IP - 通用令牌

你可以直接使用 `通用令牌`，那样就不用输入`主机/IP`。  
简单来说 `通用令牌` 就是任何有 `公钥` 与 `令牌` 的小鸡，不管你的 IP 是啥都可以连上 Beszel Hub。但是这 `通用令牌` 会在一小时后自动关闭，若还需要再手动打开就可以了。

 ![通用令牌](https://idcflare.com/uploads/default/original/3X/1/1/111cd9c7584f25ecaeb74c11b952e21b75cacd01.jpeg)

### 2.2.2 需要明确指定小鸡 IP

如果添加新客户端时你不是使用 `通用令牌`，就要明确指定 `主机/IP`

1. `名称`：小鸡的名称
2. `主机/IP`： 就是小鸡的 域名 (non-proxied) 或是 IP。(使用 `通用令牌` 就不用管这个，因为根本不会跳出这填写表单)，只有 Beszel Hub 中有记录的 IP 才可以连上。(所以要先添加客户端后，再让小鸡连上 Beszel Hub)
3. `公钥` 与`令牌`： 这两项就不能乱填，因为在建立 websocket 时会用这两项去验证，若是 `令牌` 对了，但是 `公钥` 是错的，也会无法连接。直接使用生成好的就可以了。当然 Beszel 也支持以 SSH 连线，但使用者不需要去特别设定，Beszel 会自动选择最好的方式 (通常是 Websocket)。

 ![明确指定小鸡IP](https://idcflare.com/uploads/default/original/3X/3/b/3bab12307732466dc2628f64117a8494ac9d045e.jpeg)

# 3. 常见问题

> [@【教程】Beszel 极轻量探针教程](https://idcflare.com/t/topic/33723/3):
>
> komari的agent支持docker吗

> [@【教程】Beszel 极轻量探针教程](https://idcflare.com/t/topic/33723/15):
>
> 好奇怪，为什么我的beszel没有上传 下载 这两个诶

> [@【教程】Beszel 极轻量探针教程](https://idcflare.com/t/topic/33723/29):
>
> 感谢大佬，请问通知支持同时配置多个吗？ 比如一部分服务想要通知给A，另一部分想要通知给B

# 4. 其他

> [@【教程】Beszel 极轻量探针教程](https://idcflare.com/t/topic/33723/12):
>
> ps:没有网络信息监控，最好找台互联靠谱的机器跑不然玄学问题多 以及可以直接可执行文件然后bind127.0.0.1+cloudflare tunnel更安全

> [@clawcloudrun部署一个占用极低的探针-beszel](https://idcflare.com/t/topic/4346):
>
> github:[GitHub - henrygd/beszel: Lightweight server monitoring hub with historical data, docker stats, and alerts.](https://github.com/henrygd/beszel)其为一个纯粹的占用显示及警告,并不带延迟检测功能，由此带来了极低占用 agentdocker:[henrygd/beszel-agent - Docker Image](https://hub.docker.com/r/henrygd/beszel-agent) （3…

> [@【教程】Beszel 极轻量探针教程](https://idcflare.com/t/topic/33723/20):
>
> 自己看轻量就用 beszel，肯折腾就用 Prometheus+ Grafana 公开访问现在用得多的就 nezha 和 komari，我选择 komari，搭起来 docker 一把梭，等以后有想法了再折腾别的 另外近期也看到个国外开发者开源的项目，也挺简洁的

---

_[View the full topic](https://idcflare.com/t/topic/33723)._