Beszel项目在Rootless Docker环境下的监控配置指南

背景介绍

Beszel是一款优秀的系统监控工具，能够提供全面的系统资源使用情况和Docker容器监控功能。然而在Rootless Docker环境下，Beszel的Docker监控功能可能会遇到一些特殊问题，需要特别的配置才能正常工作。

Rootless Docker环境特点

Rootless Docker是一种以非root用户身份运行Docker的安全模式，它与传统Docker安装有几个关键区别：

1. Docker守护进程以普通用户身份运行
2. Docker socket默认路径不同
3. Cgroups资源控制需要额外配置

常见问题及解决方案

问题一：Docker socket权限问题

在Rootless模式下，Docker socket默认位于/run/user/<UID>/docker.sock而非传统的/var/run/docker.sock。这会导致Beszel Agent无法连接到Docker守护进程。

解决方案： 修改docker-compose.yml文件，正确挂载Docker socket：

services:
  beszel-agent:
    image: henrygd/beszel-agent:latest
    volumes:
      - /run/user/1000/docker.sock:/run/user/1000/docker.sock:ro
    environment:
      DOCKER_HOST: unix:///run/user/1000/docker.sock

更通用的做法是使用环境变量XDG_RUNTIME_DIR：

volumes:
  - ${XDG_RUNTIME_DIR}/docker.sock:/var/run/docker.sock:ro

问题二：CPU监控数据缺失

Rootless模式下，默认不启用CPU、cpuset和I/O控制组(cgroup)功能，导致无法获取容器CPU使用率数据。

解决方案： 需要手动启用cgroup委托功能：

1. 编辑/etc/systemd/system/user@.service.d/delegate.conf文件
2. 添加或修改以下内容：

[Service]
Delegate=cpu cpuset io memory pids

3. 重启系统使配置生效

问题三：内存监控数据不准确

类似CPU监控问题，内存监控也需要cgroup支持。

解决方案： 在/boot/cmdline.txt中添加以下内核参数：

cgroup_enable=cpuset cgroup_enable=memory cgroup_memory=1

完整配置示例

以下是Rootless Docker环境下Beszel的推荐配置：

services:
  beszel:
    image: henrygd/beszel:latest
    ports:
      - 8090:8090
    volumes:
      - ./beszel_data:/beszel_data

  beszel-agent:
    image: henrygd/beszel-agent:latest
    network_mode: host
    volumes:
      - ${XDG_RUNTIME_DIR}/docker.sock:/var/run/docker.sock:ro
    environment:
      PORT: 45876
      KEY: "HUB_PUB_KEY"

验证配置

配置完成后，可以通过以下方式验证：

1. 检查Docker容器列表是否可见
2. 确认CPU和内存监控数据是否正常显示
3. 查看Beszel Agent日志，确保没有权限错误

总结

在Rootless Docker环境下使用Beszel进行监控需要特别注意Docker socket路径和cgroup配置。通过正确的socket挂载和cgroup委托设置，可以确保Beszel能够完整获取系统资源和Docker容器的监控数据。这种配置不仅解决了监控问题，还保持了Rootless Docker的安全优势。