进阶 uptime.kuma.pet 2026-11-20 10:30:00 · 3 阅读
第20章 故障排查
排查故障:Uptime Kuma 报告宕机,但服务实际可访问
提示
如果你还不知道:Docker 有多种网络类型,其中仅部分类型允许访问本地网络,有些甚至无法访问远程网络。
当 Uptime Kuma 报告你的服务宕机(DOWN)时,判断问题根源是 Uptime Kuma 的 Bug、Docker 网络配置错误还是防火墙问题,是解决问题的好起点。
要调试此问题,请通过以下命令进入容器的 bash 环境:
`docker exec -it uptime-kuma bash`
安装 curl:
`apt update && apt --yes install curl`
然后你可以使用 `ping`、`curl` 等命令来排查问题。示例:
`curl https://google.com`
`ping google.com`
IPv6
如果你使用 Docker 运行 Uptime Kuma,且服务仅能通过 IPv6 访问。请参阅 Docker 官方 Wiki 以启用 IPv6 支持。
Docker 默认不支持 IPv6。 对于 docker compose,只需在 compose 文件中添加一个启用 IPv6 的网络即可。更新项目模板后的配置将如下所示: ```yaml services: uptime-kuma: image: louislam/uptime-kuma:2 volumes: - ./data:/app/data ports: #:
- 3001:3001
restart: unless-stopped
+ networks:
+ - uptime-kuma-net
+ networks:
+ uptime-kuma-net:
+ enable_ipv6: true
```
网络在文件底部创建,并设置 `enable_ipv6: true`,然后将其添加到服务中。
测试 Pull Requests
现在你可以测试 Pull Requests,而无需搭建任何开发环境。
Docker 默认不支持 IPv6。 对于 docker compose,只需在 compose 文件中添加一个启用 IPv6 的网络即可。更新项目模板后的配置将如下所示: ```yaml services: uptime-kuma: image: louislam/uptime-kuma:2 volumes: - ./data:/app/data ports: #