Beszel

简体中文

English

简体中文

English

主题

常见问题 ​

如果您的问题没有在此处列出，请搜索我们的 GitHub 问题 和 讨论 来寻找解决方案。您也可以在社区运营的 Matrix 聊天室 中咨询。

代理程序未连接 ​

请查看 PocketBase 中的日志页面 (/_/#/logs) 以获取有关错误的信息。下面描述的两个通信方向中的一个需要正常工作。

代理程序会向中心的 /api/beszel/agent-connect 发起 WebSocket 连接，因此请确保此端点可访问。如果使用反向代理，请确保它能够代理 WebSocket 连接。

中心会向代理程序发起 TCP 连接，因此请确保代理系统上的端口未被阻止。

  1. 检查所有活动的防火墙，例如 iptables，以及您的云服务提供商的防火墙设置（如果适用）。添加允许 TCP 连接到该端口的入站规则。
  2. 或者，使用 WireGuard、Tailscale（视频教程）、Cloudflare Tunnel（教程）或 Pangolin（教程）等软件安全地绕过防火墙。

您可以通过在网络中的另一台设备上运行 telnet <代理IP> <端口> 来测试连接性。

在同一系统上使用 Docker 连接中心和代理 ​

连接到本地代理时，localhost 将不起作用，因为容器位于不同的网络中。推荐的连接方式是使用 Unix 套接字。

单击查看完整的 docker-compose.yml 配置，包括本地代理

重要

此配置通常可以直接使用，但在 Web 界面添加系统时需要执行以下步骤：

  1. 使用您的公钥和令牌更新 KEY 和 TOKEN 环境变量，然后重新启动代理：
docker compose up -d
  1. 在 Web 界面中使用 Unix 套接字路径作为 主机/IP：
/beszel_socket/beszel.sock
yaml
services:
  beszel:
    image: henrygd/beszel:latest
    container_name: beszel
    restart: unless-stopped
    ports:
      - 8090:8090
    volumes:
      - ./beszel_data:/beszel_data
      - ./beszel_socket:/beszel_socket

  beszel-agent:
    image: henrygd/beszel-agent:latest
    container_name: beszel-agent
    restart: unless-stopped
    network_mode: host
    volumes:
      - ./beszel_agent_data:/var/lib/beszel-agent
      - ./beszel_socket:/beszel_socket
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      LISTEN: /beszel_socket/beszel.sock
      HUB_URL: http://localhost:8090
      TOKEN: <令牌>
      KEY: "<密钥>"
单击查看运行 docker compose 的说明

注意

如果您更喜欢以不同的方式设置容器，请随意

  1. 如果尚未安装，请安装 Docker 和 Docker Compose.

  2. 复制 docker-compose.yml 内容

  3. 创建一个目录用于存储 docker-compose.yml 文件

bash
mkdir beszel
cd beszel
  1. 创建一个 docker-compose.yml 文件，粘贴内容并保存
bash
nano docker-compose.yml
bash
vim docker-compose.yml
bash
emacs docker-compose.yml
bash
code docker-compose.yml
  1. 启动服务
bash
docker compose up -d

实时统计数据不工作或更改未保存 ​

检查您是否在代理级别应用了 gzip 或其他编码。

我们需要在内容类型为 text/event-stream 的任何内容上禁用压缩，以便 SSE 正常工作。

如果您使用 Coolify，请在中心服务设置中取消选中"启用 gzip 压缩"。

查找正确的文件系统 ​

使用 FILESYSTEM 环境变量指定用于根磁盘统计的文件系统/设备/分区。

如果没有设置，代理程序将尝试找到挂载在 / 上的分区并使用它。这在容器中可能无法正常工作，因此建议设置此值。使用以下方法之一查找正确的文件系统：

  • 运行 lsblk 并选择 "NAME" 下的选项。
  • 运行 df -h 并选择 "Filesystem" 下的选项。
  • 运行 sudo fdisk -l 并选择 "Device" 下的选项。

Docker 中的自签名证书问题 ​

在 Docker 容器中运行 Beszel 并连接到使用自签名证书的服务时，您可能会遇到 TLS 证书验证错误。

错误通常如下所示：

tls: failed to verify certificate: x509: certificate signed by unknown authority

要解决此问题，您需要向 Docker 容器提供自定义 CA 证书：

  1. 将您的 CA 证书文件（例如 custom-ca.crt）保存在主机系统上
  2. 将其挂载到容器的证书目录中：
yaml
volumes:
  - /path/to/custom-ca.crt:/etc/ssl/certs/custom-ca.crt:ro

实施此解决方案后，与使用自签名证书的服务的连接应该能够正常工作。

Docker 容器图表为空或丢失 ​

如果容器图表显示为空数据或根本不显示，您可能需要启用 cgroup 内存记帐。要进行验证，请运行 docker stats。如果显示内存使用率为零，请遵循以下指南解决问题：

https://akashrajpurohit.com/blog/resolving-missing-memory-stats-in-docker-stats-on-raspberry-pi/

无根代理的 Docker 统计信息缺失 ​

请参阅 issue #640，其中 tercerapersona 发布了解决方案。使用适合您用户的正确套接字路径，如果 CPU 统计信息缺失，请启用 cgroup CPU 委派。

Docker 容器填充不可靠 ​

如果可能，请升级代理程序系统上的 Docker 版本。Docker 24 及更早版本可能存在导致此问题的错误。我们已经向代理程序添加了缓解此问题的解决方法，但这不是完美的解决方案。

月/周记录填充不可靠 ​

较长时间段的记录是通过平均较短时期的统计数据创建的。代理程序必须不间断运行才能使这些记录填充完整的数据集。

暂停/取消暂停代理程序超过一分钟将导致数据不完整，重置当前间隔的计时。

基于 MIT 许可发布