使用eksctl创建EKS集群后 kubectl可正常访问 浏览器控制台报命名空间加载未授权错误
报错前提:eksctl创建EKS集群、
kubectl get nodes命令行正常、使用admin权限账号,浏览器访问Web可视化界面时报错:Error loading Namespaces. Unauthorized: Verify you have access to the Kubernetes cluster
核心排查逻辑
EKS采用 IAM身份→aws-auth ConfigMap映射→K8s RBAC 的权限模型:命令行能正常操作,说明本地kubeconfig绑定的IAM身份已完成权限映射;Web端报错的核心原因是 Web界面使用的身份凭证与命令行有效身份不一致 或 Web使用的身份未完成EKS权限映射。
具体排查步骤
1. 校验Web界面对应的身份凭证
以最常见的自建Kubernetes Dashboard为例:
- 确认Web登录使用的凭证(如Dashboard token、上传的kubeconfig),与本地
kubectl使用的kubeconfig是否为 同一个身份 - 常见坑:Dashboard默认使用
kubernetes-dashboard命名空间的默认ServiceAccount,该SA仅具备有限命名空间权限,无Namespaces列表查询资格 - 验证操作:
执行命令检查默认SA的权限:
若返回kubectl auth can-i list namespaces --as=system:serviceaccount:kubernetes-dashboard:defaultno,说明是SA权限不足。
2. 检查EKS权限映射配置(aws-auth ConfigMap)
EKS仅将aws-auth(kube-system命名空间下的ConfigMap)中配置的IAM身份/角色,映射为K8s可识别的权限主体:
- 查看当前aws-auth配置:
kubectl get configmap aws-auth -n kube-system -o yaml - 排查要点:
- 若Web界面使用IAM身份(如EKS控制台临时凭证、Ingress注入的IAM角色),需确认该身份的ARN已加入
mapRoles或mapUsers块,且绑定system:masters组(对应K8s admin权限) - 常见坑:eksctl创建集群时,仅将 创建集群的原始IAM身份 自动加入
system:masters,后续新增的IAM身份(哪怕是同账号的AWS管理员)需手动配置aws-auth才能获得K8s权限
- 若Web界面使用IAM身份(如EKS控制台临时凭证、Ingress注入的IAM角色),需确认该身份的ARN已加入
3. 排查Web界面自身配置错误
- 若为Kubernetes Dashboard:
- 检查是否开启
--enable-skip-login:该模式默认使用Dashboard内部SA权限,而非用户传入的凭证,会触发权限不足 - 检查Ingress/负载均衡的身份转发规则:若Ingress将用户身份改写为匿名用户(
system:anonymous),会直接触发Unauthorized
- 检查是否开启
- 验证方式:直接使用Web登录token调用EKS集群API:
若返回401,说明token本身权限无效;若返回200,说明是Web界面的代码逻辑错误。curl -k -H "Authorization: Bearer <Web登录token>" https://<EKS集群API端点>/api/v1/namespaces
针对性修复方案
方案1:为Dashboard配置高权限SA(快速验证)
# 在Dashboard命名空间创建专属admin SA kubectl create serviceaccount dashboard-admin -n kubernetes-dashboard # 绑定集群admin权限 kubectl create clusterrolebinding dashboard-admin-binding \ --clusterrole=cluster-admin \ --serviceaccount=kubernetes-dashboard:dashboard-admin # 获取该SA的登录token kubectl get secret $(kubectl get sa dashboard-admin -n kubernetes-dashboard -o jsonpath="{.secrets[0].name}") \ -n kubernetes-dashboard -o jsonpath="{.data.token}" | base64 -d
用生成的token在Dashboard登录页登录即可。
方案2:补充EKS的IAM权限映射
若Web界面使用IAM身份,编辑aws-auth配置:
kubectl edit configmap aws-auth -n kube-system
在对应块中添加Web使用的IAM身份(以IAM角色为例):
mapRoles: - rolearn: arn:aws:iam::<AWS账号ID>:role/<Web使用的IAM角色名> username: <Web使用的IAM角色名> groups: - system:masters
内容的提问来源于stack exchange,提问作者opensource-developer
相关产品推荐
相关产品推荐

