进阶 uptime.kuma.pet 2026-11-20 10:30:00 · 10 阅读

第12章 如何监控 Docker 容器(Uptime Kuma 配置指南)

如何监控 Docker 容器(版本 >= 1.18.0) 如果你正在通过 Docker 运行 Uptime Kuma 默认情况下,Docker 容器是封闭的,这意味着 Uptime Kuma 无法访问宿主机的资源。你需要将 /var/run/docker.sock 挂载到容器中。 注意 向 Uptime Kuma 暴露 Docker socket 或 TCP 端口,会使其获得对宿主机 Docker daemon 的完全控制权。如果容器被攻破,攻击者也可能借此控制整个系统。因此,使用这种监控类型时,强烈不建议将 Uptime Kuma 直接暴露给互联网。 方法一:与 Uptime Kuma 容器共享 docker.sock 命令行参数: -v /var/run/docker.sock:/var/run/docker.sock docker-compose 配置: volumes: - /var/run/docker.sock:/var/run/docker.sock 方法二:TCP - 桥接模式 暴露 TCP 端口
要启用 TCP 监控,需要先把 Docker daemon 暴露在 TCP 端口上。官方文档在这里,下面的示例提供了一些快速配置方法。 编辑位于 /etc/docker/daemon.json 的 daemon 配置: { #保留原有参数 #不安全选项,仅在封闭网络中使用 "tls": false, "hosts": ["unix:///var/run/docker.sock", "tcp://:2375"] #安全选项 "tls": true, "tlscacert": "/var/docker/ca.pem", "tlscert": "/var/docker/server.pem", "tlskey": "/var/docker/serverkey.pem", "hosts": ["unix:///var/run/docker.sock", "tcp://:2376"] } 执行 sudo systemctl restart docker.service 重启 daemon。 如果 daemon 启动失败,可能是出现了重复键(这里是 hosts),因为它已经是 daemon 启动配置的一部分。 可以用 sudo systemctl edit docker.service 编辑启动配置: [Service] #空白的 ExecStart 用于清除当前条目 ExecStart= #替换原有的 ExecStart,但只删除你已在 daemon.json 中添加的属性,其余保持不变 ExecStart=/usr/bin/dockerd --containerd=/run/containerd/containerd.sock 我原来的 ExecStart 是:ExecStart=/usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock,注意其中的 -H 会导致重复属性错误。 注意 如果你是通过 snap 安装的 Docker: Snap 会把 daemon.json 存放在 /var/snap/docker/current/config/daemon.json 用 sudo nano /var/snap/docker/current/config/daemon.json 编辑文件,改成: { "log-level": "error", "storage-driver": "overlay2", + "hosts": ["unix:///var/run/docker.sock", "tcp://0.0.0.0:2375"] } 执行 sudo systemctl restart snap.docker.dockerd.service 重启服务。 用 sudo systemctl status snap.docker.dockerd.service 检查服务状态。 服务应该正常运行,显示 docker snap 服务。 更新 uptime-kuma 添加新的 Docker 主机时,将连接选项设为 TCP。填入该主机的 IP 地址及之前暴露的 TCP 端口,如下所示。 配置 Docker TLS 连接证书 假设你已按此处说明,将远程 docker 实例配置为安全地监听 TLS 连接,那么需要配置 Uptime-Kuma 使用你生成的证书。证书查找的基础路径可以通过环境变量 DOCKER_TLS_DIR_PATH 设置,默认值为 data/docker-tls/。 若需在 docker 中运行 uptime-kuma,请将父目录挂载到 /app/data/docker-tls: -v /docker-cert:/app/data/docker-tls 如果该路径下存在一个与 Docker 主机 FQDN 名称匹配的目录(例如 https://example.com:2376 的 FQDN 是 example.com,则会搜索 data/docker-tls/example.com/ 目录下的证书文件),系统会加载 ca.pem、key.pem 和 cert.pem 文件,并将其包含在 agent 选项中。文件名也可以通过 DOCKER_TLS_FILE_NAME_(CA|KEY|CERT) 环境变量覆盖。 相关讨论 https://github.com/louislam/uptime-kuma/issues/2061 Docker 标签 上一页 维护 您可以通过左上角的菜单访问维护管理。

评论 (0)