ingress default_LIST DEFAULT HASH

在Kubernetes Ingress的配置体系中，default_LIST和DEFAULT HASH分别控制默认后端流量分发与请求哈希路由策略，合理配置这两项能显著提升集群的稳定性和性能。

ingress default_LIST配置方法详解

什么是default_LIST

default_LIST在Ingress语境中通常指默认后端服务列表，当请求没有匹配到Ingress规则中的任何路径时，流量会被转发至该列表中的服务，它相当于一个兜底策略,防止因路由缺失导致404错误。

default_LIST配置步骤

• 确认目标后端Service已存在,并位于同一集群。
• 在Ingress资源中添加nginx.ingress.kubernetes.io/default-backend注解，格式为namespace/serviceName。
• 若使用Nginx Ingress Controller，也可通过ConfigMap全局设置default-backend-service字段。
• 应用配置后，通过kubectl describe ingress验证注解是否生效。

配置示例

apiVersion: networking.k8s.io/v1 kind: Ingress metadata: annotations: nginx.ingress.kubernetes.io/default-backend: production/my-default-backend name: example-ingress spec: rules: host: app.example.com http: paths: path: /api pathType: Prefix backend: service: name: api-service port: number: 80

上述配置中，未匹配/api的请求将进入my-default-backend服务。

配置注意事项

• default_LIST指定的服务应当具备健康检查机制,避免流量被转发至故障实例。
• 若使用多个Ingress Controller，需确保注解前缀与控制器匹配（如traefik.ingress.kubernetes.io/default-backend）。
• 行业共识认为，default_LIST作为兜底策略，应当配置一个返回友好错误页面的静态服务,而非直接返回404。

ingress default_hash是什么意思与配置指南

哈希算法的作用

DEFAULT HASH指的是Ingress中用于负载均衡的默认哈希策略，通过计算请求的特定字段（如客户端IP、Cookie、URI）生成哈希值，将请求定向到同一后端实例,实现会话保持或缓存亲和性。

常用哈希算法类型

• 基于客户端IP：使用$remote_addr,适合需要源IP一致性的场景。
• 基于Cookie：使用$cookie_name,用于业务层会话跟踪。
• 基于URI：使用$request_uri,适用于缓存节点或静态资源分发。
• 一致性哈希：配合consistent关键字,减少后端节点增减时的哈希漂移。

如何配置upstream-hash-by

Nginx Ingress Controller通过nginx.ingress.kubernetes.io/upstream-hash-by注解实现自定义哈希。

• 支持变量组合，如$remote_addr$http_x_forwarded_for。
• 添加consistent后缀启用一致性哈希，例：$remote_addr consistent。
• 若未指定哈希键,则默认使用轮询算法。

选择哈希策略的考量

• 会话保持需求：优先使用Cookie或IP哈希，但需注意IP地址变化（如NAT）。
• 后端节点稳定性：一致性哈希适合节点频繁扩缩的集群,能减少缓存失效。
• 业内专家指出，在电商促销场景下，基于Cookie的哈希能够避免用户重复登录,但需确保Cookie名称不包含敏感信息。

生产环境ingress配置实战

场景1：多服务共用默认后端

当多个Ingress共享同一默认后端时，可在ConfigMap中统一设置default-backend-service,而非在每个Ingress重复注解。

apiVersion: v1 kind: ConfigMap metadata: name: nginx-configuration namespace: ingress-nginx data: default-backend-service: shared/default-backend

• 优点：统一管理,减少资源冗余。
• 注意：不同Ingress如需不同默认后端,仍需使用注解覆盖。

场景2：基于Cookie的会话保持

适用于购物车、用户登录等需保持状态的应用。

• 配置哈希键为$cookie_session_id,确保同一会话的请求始终落在同一Pod。
• 配合session-cookie属性自定义Cookie名称,避免与业务Cookie冲突。
• 测试发现，当后端Pod数量为素数时，哈希分布更均匀,可以尝试调整副本数。

场景3：蓝绿发布与哈希策略

蓝绿发布期间，新旧版本服务同时存在，使用一致性哈希可以让已建立会话的用户继续访问旧版本，直到会话超时,降低迁移影响。

• 新版本Ingress使用upstream-hash-by: "$remote_addr consistent"。
• 旧版本Ingress保持相同哈希配置,但指向旧版本Service。
• 切换时逐步调整Service标签选择器,实现平滑迁移。

ingress default_LIST与default_hash协同优化

避免配置冲突

• default_LIST的本质是proxy_pass到固定后端，而default_hash是upstream的负载均衡策略，两者在同一Ingress中可独立生效,但需确保default_LIST指向的服务正确处理未匹配请求。
• 若同时使用default-backend和upstream-hash-by，默认后端不会参与哈希分发,而是直接转发所有未匹配请求。

性能调优建议

• 缓存哈希计算结果：Nginx Ingress默认会缓存哈希值，可通过ingress.nginx.io/hash-cache-size调整缓存大小（单位KB）。
• 调整哈希键复杂度：避免使用过长变量，如$request_uri可能包含大量查询参数，建议截取或使用$uri。
• 使用least_conn替代哈希：当无会话保持需求时，least_conn算法通常比哈希更均衡,但无法保证一致性。

ingress default_LIST DEFAULT HASH 常见问题

问题1：default_LIST配置后流量未按预期转发？

检查注解的命名空间是否正确，以及目标Service的端口是否暴露，使用kubectl exec -it <ingress-controller-pod> -cat /etc/nginx/nginx.conf查看生成的配置，确认server块中是否存在proxy_pass指向默认后端，若注解未生效，可能是Ingress Controller版本不支持该注解,需升级或改用ConfigMap方式。

问题2：default_hash是否支持多变量？

支持，在upstream-hash-by中可以使用$变量名组合，例如$remote_addr$http_user_agent，但需注意变量长度限制，默认不超过1024个字符，若哈希值过长，会导致Nginx计算性能下降,多数情况下建议使用不超过3个变量。

问题3：如何验证default_LIST和default_hash生效？

发送请求并观察响应头，若配置了upstream-hash-by，可在Nginx日志中启用$upstream_addr字段，查看同一源IP是否始终指向同一Pod，对于default_LIST，访问不存在的路径（如/test-404），确认返回内容来自默认后端服务，使用kubectl logs检查默认后端Pod的请求记录,能直观验证流量走向。