Envoy代理中实现Redis与HTTP健康检查共存的配置实践

背景介绍

在现代微服务架构中，Envoy作为高性能代理被广泛使用。一个常见场景是同时处理Redis协议和HTTP协议的流量，特别是在需要为Redis服务添加健康检查端点时。本文将详细介绍如何在Envoy中配置同时支持Redis代理和HTTP健康检查端点。

核心问题分析

当尝试在同一个监听端口上同时处理Redis协议和HTTP协议时，Envoy需要明确区分两种协议类型。默认情况下，如果没有正确配置协议检测机制，Envoy无法自动识别传入连接是HTTP还是Redis协议，这会导致健康检查端点无法正常工作。

解决方案实现

1. 协议检测配置

关键点在于为监听器添加HTTP协议检测器。这个检测器会检查传入连接的前几个字节，判断是否为HTTP请求：

listeners:
- name: valkey_listener
  address:
    socket_address:
      address: 0.0.0.0
      port_value: 6389
  listener_filters:
  - name: envoy.filters.listener.http_inspector
    typed_config:
      "@type": type.googleapis.com/envoy.extensions.filters.listener.http_inspector.v3.HttpInspector

2. 完整配置示例

以下是一个完整的配置示例，展示了如何同时支持Redis代理和HTTP健康检查：

static_resources:
  listeners:
  - name: valkey_listener
    address:
      socket_address:
        address: 0.0.0.0
        port_value: 6389
    listener_filters:
    - name: envoy.filters.listener.http_inspector
      typed_config:
        "@type": type.googleapis.com/envoy.extensions.filters.listener.http_inspector.v3.HttpInspector
    
    filter_chains:
    - filter_chain_match:
        application_protocols: ["http/1.1", "h2"]
      filters:
      - name: envoy.filters.network.http_connection_manager
        typed_config:
          "@type": type.googleapis.com/envoy.extensions.filters.network.http_connection_manager.v3.HttpConnectionManager
          stat_prefix: ingress_http
          route_config:
            name: local_route
            virtual_hosts:
              - name: backend
                domains: ["*"]
                routes:
                  - match: { path: "/health" }
                    direct_response:
                      status: 200
                      body: { inline_string: "healthy" }
          http_filters:
          - name: envoy.filters.http.router
            typed_config:
              "@type": type.googleapis.com/envoy.extensions.filters.http.router.v3.Router

    default_filter_chain:
      filters:
      - name: envoy.filters.network.redis_proxy
        typed_config:
          "@type": type.googleapis.com/envoy.extensions.filters.network.redis_proxy.v3.RedisProxy
          stat_prefix: egress_valkey
          settings:
            op_timeout: 1s
            enable_hashtagging: true
          prefix_routes:
            catch_all_route:
              cluster: valkey_standalone
          downstream_auth_passwords: { inline_string: "worker" }
          downstream_auth_username: { inline_string: "worker" }

配置要点解析

1. 协议检测机制：HTTP检测器会检查连接的前几个字节，如果是HTTP请求则路由到HTTP连接管理器，否则走默认的Redis代理链。

2. 路由配置：在HTTP连接管理器中，我们配置了简单的直接响应路由，当访问/health路径时返回200状态码和"healthy"文本。

3. 认证配置：Redis代理链中配置了用户名和密码认证，确保只有授权客户端可以访问Redis服务。

日志配置建议

为了更好监控两种协议的流量，可以添加访问日志：

http_filters:
- name: envoy.filters.http.router
  typed_config:
    "@type": type.googleapis.com/envoy.extensions.filters.http.router.v3.Router
    dynamic_stats: true
    access_log:
    - name: envoy.access_loggers.file
      typed_config:
        "@type": type.googleapis.com/envoy.extensions.access_loggers.file.v3.FileAccessLog
        path: "/dev/stdout"
        log_format:
          text_format: "[%START_TIME%] \"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%\" %RESPONSE_CODE% %RESPONSE_FLAGS% %BYTES_RECEIVED% %BYTES_SENT% %DURATION% %RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)% \"%REQ(X-FORWARDED-FOR)%\" \"%REQ(USER-AGENT)%\" \"%REQ(X-REQUEST-ID)%\" \"%REQ(:AUTHORITY)%\"\n"

实际应用价值

这种配置模式特别适合以下场景：

1. 需要为Redis服务添加健康检查端点
2. 在Kubernetes环境中配合LoadBalancer使用
3. 需要同时监控Redis和HTTP流量的场景
4. 在有限端口资源情况下实现多功能代理

通过这种配置，运维人员可以轻松实现服务健康检查，而无需额外开放端口或部署单独的健康检查服务，既简化了架构又提高了资源利用率。