Uptime-Kuma 监控系统中 Gotify 通知服务的网络配置问题解析

问题背景

在使用 Uptime-Kuma 监控系统时，用户发现当 Gotify 通知服务运行在非标准端口时会出现连接问题。具体表现为当 Gotify 服务端口从默认的80/443改为3080/3443时，Uptime-Kuma 无法成功发送测试通知，并返回ETIMEDOUT连接超时错误。

技术分析

通过分析用户提供的配置信息，可以确定问题根源在于Docker网络配置层面。用户采用了以下网络架构：

1. Gotify 服务运行在桥接模式，映射端口为3080和3443
2. Uptime-Kuma 运行在MACVLAN网络模式，拥有独立IP地址
3. 两个容器分别连接不同的物理网卡

这种配置导致了一个典型的容器间通信问题：MACVLAN网络中的容器默认无法直接访问宿主机网络中的其他容器或服务。

解决方案

针对这一问题，有以下几种可行的解决方案：

方案一：修改网络架构

将Uptime-Kuma容器也改为桥接模式，使其与Gotify服务处于同一网络环境中。这是最简单的解决方案，但可能不适用于需要独立IP地址的场景。

方案二：配置MACVLAN网络特殊路由

通过添加特殊路由规则，允许MACVLAN网络中的容器访问宿主机网络。这需要执行以下步骤：

1. 在宿主机上添加路由规则
2. 配置iptables允许特定网络流量
3. 可能需要调整Docker网络配置

方案三：使用Docker自定义网络

创建一个自定义的Docker网络，将两个服务都加入该网络，这样它们可以直接通过容器名称相互访问，无需考虑端口映射问题。

最佳实践建议

对于需要在不同网络环境中部署监控服务和通知服务的场景，建议：

1. 优先考虑使用Docker自定义网络简化容器间通信
2. 如果必须使用MACVLAN，确保正确配置网络路由
3. 测试容器间的连通性，可以使用docker exec进入容器执行ping或curl测试
4. 考虑使用服务发现机制，如DNS解析，而不是直接依赖IP地址

总结

Uptime-Kuma与Gotify的集成问题通常源于网络配置不当。理解Docker网络模型和容器间通信机制对于解决此类问题至关重要。通过合理的网络架构设计，可以确保监控系统与通知服务之间的可靠通信，无论它们运行在标准端口还是自定义端口上。