Beszel项目在Docker Swarm环境下的Agent部署问题解析

问题背景

Beszel是一个轻量级的系统监控工具，旨在替代Netdata等监控解决方案。在单节点Docker环境中部署Beszel时表现良好，但当用户尝试在Docker Swarm集群中部署Beszel Agent时，遇到了指标数据异常下降的问题。

问题现象

用户最初在单节点环境中成功部署Beszel，各项监控指标与HTOP和Swarmpit等工具显示的数据基本一致。然而，当将Beszel Agent以全局部署模式(global)扩展到Swarm集群中的其他节点后，出现了以下异常情况：

1. 原本占用约7GB内存的Minecraft服务器容器在监控中显示为0内存使用
2. 各节点的Docker容器指标全部归零
3. 不同节点的容器信息出现交叉显示（如A节点的容器显示在B节点的监控中）

技术分析

Docker Swarm网络特性影响

在Docker Swarm环境中，默认使用ingress网络和内部负载均衡机制。当多个Agent使用相同的SSH端口时，Swarm的负载均衡可能导致连接请求被随机路由到不同的节点，从而造成监控数据混乱。

端口配置问题

用户最初尝试的配置中，所有Agent都使用相同的SSH端口(45876)，并通过Swarm的端口映射暴露。这种配置在全局部署模式下会导致：

1. 端口冲突：虽然Docker会处理端口映射，但监控中心无法区分不同节点的Agent
2. 数据混淆：监控请求可能被路由到任意节点的Agent，导致数据显示错误

解决方案

临时解决方案

用户发现可以通过以下方式临时解决问题：

1. 放弃全局部署模式，为每个节点单独配置Agent服务
2. 为每个节点的Agent分配不同的SSH端口
3. 使用节点约束确保每个Agent只在指定节点运行

示例配置：

beszel-agent-nano:
  image: henrygd/beszel-agent:latest
  environment:
    FILESYSTEM: /dev/nvme0n1p1
    KEY: ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIPaeg+GJnJByGCq/3H5V0n/Rw/DAkpTWAV2VX9nj1e9O
    PORT: '45876'
  ports:
   - 45876:45876
  deploy:
    placement:
      constraints:
       - node.hostname==nano

beszel-agent-pico:
  image: henrygd/beszel-agent:latest
  environment:
    FILESYSTEM: /dev/mmcblk2p1
    KEY: ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIPaeg+GJnJByGCq/3H5V0n/Rw/DAkpTWAV2VX9nj1e9O
    PORT: '45877'
  ports:
   - 45877:45877
  deploy:
    placement:
      constraints:
       - node.hostname==pico

更优解决方案

1. 使用节点静态IP：在Beszel中添加节点时，直接使用节点的静态IP地址而非主机名或Swarm虚拟IP
2. 端口差异化：即使使用全局部署模式，也应确保每个节点的Agent使用不同端口
3. Agent主动上报：改进Beszel架构，使Agent能够主动向监控中心上报数据（"phone home"模式），而非等待监控中心拉取数据

最佳实践建议

1. 在Docker Swarm环境中部署Beszel时，建议为每个节点单独配置Agent服务
2. 确保每个Agent使用唯一的SSH端口
3. 在Beszel监控中心添加节点时，使用节点的静态IP地址
4. 考虑使用节点标签等Swarm特性来管理Agent部署
5. 对于大规模集群，建议开发者考虑实现Agent主动上报机制

总结

Beszel在Docker Swarm环境中的部署需要特别注意网络和端口配置问题。通过合理的节点隔离和端口分配，可以避免监控数据混乱的问题。对于希望简化部署的用户，等待开发者实现Agent主动上报功能可能是更好的长期解决方案。