AWS Load Balancer Controller 在 AL2023 AMIs 中遇到的 IMDSv1 兼容性问题解析

背景概述

在 Amazon EKS 优化版 AL2023 AMIs 环境中部署 AWS Load Balancer Controller 时，用户可能会遇到 Pod 持续 CrashLoopBackOff 的问题。核心错误日志显示控制器无法通过 EC2 元数据服务获取 VPC 信息，并返回 401 状态码。这本质上是由于 AL2023 强制使用 IMDSv2（Instance Metadata Service Version 2）安全协议，而传统 IMDSv1 请求被拒绝所致。

技术原理深度剖析

IMDS 协议演进

IMDSv2 是 AWS 推出的增强型元数据服务协议，采用会话令牌机制：

1. 首先通过 PUT 请求获取临时令牌
2. 后续请求需在 Header 中携带该令牌 相比 IMDSv1 的直接 GET 请求方式，v2 版本能有效防御 SSRF 等安全攻击。

控制器工作机制

AWS Load Balancer Controller 启动时需要获取以下关键信息：

1. 当前实例所在的 VPC ID
2. 可用区信息
3. 子网配置 这些信息传统上通过访问元数据服务获取，路径为： http://169.254.169.254/latest/meta-data/network/interfaces/macs/[mac]/vpc-id

问题根因

控制器使用的 aws-sdk-go-v1 虽然支持 IMDSv2，但其工作流程存在以下特点：

1. 默认优先尝试 IMDSv2 请求
2. 当 v2 请求失败时会自动降级到 v1
3. 在 AL2023 完全禁用 IMDSv1 的环境下，这种降级机制会导致彻底失败

解决方案矩阵

推荐方案：配置 IMDSv2 跳数限制

1. 通过 AWS CLI 修改实例属性：

aws ec2 modify-instance-metadata-options \
    --instance-id i-1234567890abcdef \
    --http-put-response-hop-limit 2 \
    --http-endpoint enabled

2. 关键参数说明：
   • hop-limit=2 允许 Pod 通过宿主机访问元数据服务
   • 必须确保安全组允许实例与元数据服务的通信

备选方案：显式指定 VPC ID

在 Helm 部署时通过参数强制指定：

--set vpcId=vpc-xxxxxxx

优点：完全绕过元数据服务查询 缺点：需要维护不同环境的差异化配置

架构建议

对于生产环境，建议采用分层防护策略：

1. 基础设施层：配置 IMDSv2 并设置适当跳数
2. 部署层：通过 IAM 角色限制控制器权限
3. 运行时层：启用 Pod 安全策略限制元数据访问

版本兼容性说明

当前稳定版 v2.7.1 的兼容性矩阵：

• 完全支持 EKS 1.24-1.29
• 支持 AL2/AL2023 节点组
• 未来版本计划迁移到 aws-sdk-go-v2 实现原生 IMDSv2

故障排查指南

当出现类似问题时，建议按以下步骤诊断：

1. 检查实例元数据服务状态
2. 验证 hop limit 配置
3. 检查控制器 Pod 的网络连通性
4. 审查 IAM 角色权限边界

通过系统性地理解 IMDS 工作机制和控制器架构，可以更有效地解决这类云原生环境下的集成问题。