Solo.io Gloo 中的 TCP Keepalive 配置指南

什么是 TCP Keepalive

TCP Keepalive 是一种网络机制，用于检测和维护 TCP 连接的活跃状态。在 Solo.io Gloo 项目中，这项功能可以帮助管理员优化网关代理与上下游服务之间的连接稳定性。

TCP Keepalive 的工作原理

TCP Keepalive 通过两种主要方式提升连接稳定性：

1. 保持连接活跃：在连接空闲特定时间后发送探测包，避免频繁重建连接导致的延迟波动。
2. 检测失效连接：当探测失败时（如因防火墙设置），及时关闭失效连接，避免长时间等待和重试。

核心配置参数

在 Gloo 中配置 TCP Keepalive 时，需要了解以下三个关键参数：

参数名称	默认值	作用描述
tcp_keepalive_time	7200秒	连接空闲多长时间后开始发送探测包
tcp_keepalive_intvl	75秒	两次探测包之间的间隔时间
tcp_keepalive_probes	9次	发送多少次探测包后仍无响应则关闭连接

配置建议

网络环境考量

• 在低速或不稳定网络中，过低的 tcp_keepalive_intvl 或 tcp_keepalive_probes 值可能导致不必要的流量或误断连接。
• 过高的探测间隔可能导致无法及时发现连接问题。
• 注意应用层协议（如 HTTP/gRPC）可能自带 keepalive 机制，会覆盖 TCP 层的设置。

典型应用场景

1. 控制平面与代理通信：Gloo 控制平面与 Envoy 代理之间可能出现连接假死情况，适当调整 keepalive 参数可改善此问题。

2. 负载均衡环境：当 Gloo 网关前有网络负载均衡器时，keepalive 可防止连接被错误回收。

下游连接配置

下游连接指客户端到 Envoy 网关的连接。由于 Envoy 不直接支持下游连接的 TCP keepalive 设置，需要通过 socket 选项实现。

apiVersion: gateway.solo.io/v1
kind: Gateway
spec:
  options:
    socketOptions:
      - level: 1  # SOL_SOCKET
        name: 9   # SO_KEEPALIVE
        intValue: 1
      - level: 6  # IPPROTO_TCP
        name: 4   # TCP_KEEPIDLE
        intValue: 60
      - level: 6
        name: 5   # TCP_KEEPINTVL
        intValue: 20
      - level: 6
        name: 6   # TCP_KEEPCNT
        intValue: 2

此配置表示：连接空闲60秒后开始探测，每20秒发送一次，连续2次失败则断开连接。

上游连接配置

上游连接指 Envoy 网关到后端服务的连接。Gloo 提供了更直接的配置方式：

apiVersion: gloo.solo.io/v1
kind: Upstream
spec:
  connectionConfig:
    tcpKeepalive:
      keepaliveTime: 60
      keepaliveInterval: 20
      keepaliveProbes: 2

静态集群配置

对于通过 Helm 配置的静态集群，可通过以下参数调整 keepalive 时间：

gloo:
  gatewayProxies:
    NAME:
      tcpKeepaliveTimeSeconds: 60

注意：静态集群的 tcp_keepalive_intvl 和 tcp_keepalive_probes 使用系统默认值。

最佳实践

1. 生产环境测试：任何 keepalive 配置变更都应先在测试环境验证。
2. 监控调整：结合连接监控指标，逐步优化参数。
3. 环境差异：不同网络环境（云/本地）可能需要不同配置。

通过合理配置 TCP Keepalive，可以显著提升 Gloo 网关在各种网络环境下的连接稳定性和可靠性。