K8s RBAC 怎么配?给 ServiceAccount 最小权限,4 步搞定

技术教程 · K8s · 安全与权限 · 2026-09-27

K8s RBAC 怎么配?给 ServiceAccount 最小权限,4 步搞定

同事把一个服务扔上集群,跑起来 Pod 里调 K8s API 报 pods is forbidden: User "system:serviceaccount:dev:app-sa" cannot list resource "pods"。旁边有人接了一句「绑个 cluster-admin 不就行了」。确实能跑起来,但这个 Pod 从此握着整个集群的钥匙。

下面这套流程,4 步就能给它一份刚好够用的权限。

前置准备

步骤 1:别用 default,单独建一个 ServiceAccount

kubectl create namespace dev
kubectl create serviceaccount app-sa -n dev
kubectl get sa app-sa -n dev

每个 namespace 都自带一个 default ServiceAccount。Pod 里没写 serviceAccountName,用的就是它。所以给 default 加权限 = 这个 namespace 里所有没指定 SA 的 Pod 一起拿到权限。要授权就给专门的 SA。

步骤 2:写一个最小权限 Role(动词 + 资源 + 名字)

命令行版本:

kubectl create role app-sa-pod-reader -n dev \
  --verb=get --verb=list --verb=watch --resource=pods

但更推荐存成 YAML 进 Git(RBAC as code):

apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  namespace: dev
  name: app-sa-pod-reader
rules:
- apiGroups: [""]              # "" 表示 core API group,pods/services/configmaps 都在这里
  resources: ["pods", "pods/log"]
  verbs: ["get", "list", "watch"]
- apiGroups: [""]
  resources: ["secrets"]
  verbs: ["get"]
  resourceNames: ["db-credentials"]   # 只允许读这一个 Secret

三个要点:

步骤 3:用 RoleBinding 绑定,尽量别用 ClusterRoleBinding

kubectl create rolebinding app-sa-pod-reader \
  --role=app-sa-pod-reader \
  --serviceaccount=dev:app-sa \
  -n dev

Role + RoleBinding 只在一个 namespace 内生效。要跨 namespace 复用,或者想直接用官方内置角色,就用 ClusterRole + RoleBinding 组合 —— 权限定义一次,授权范围仍然锁在某个 namespace:

kubectl create rolebinding app-sa-view \
  --clusterrole=view \
  --serviceaccount=dev:app-sa \
  -n dev

四个内置 ClusterRole 的取舍:

所以给业务的起点应该是 view 或自己写的 Role,别图省事上 admin / edit。

步骤 4:验证 —— kubectl auth can-i

kubectl auth can-i list pods \
  --as=system:serviceaccount:dev:app-sa -n dev      # yes

kubectl auth can-i delete pods \
  --as=system:serviceaccount:dev:app-sa -n dev      # no

kubectl auth can-i --list \
  --as=system:serviceaccount:dev:app-sa -n dev      # 完整权限清单

遇到 403 的排查顺序:

注意 --as= 是在做身份模拟(impersonate),你自己得有 impersonate 权限,否则这条命令本身就会 403。默认的 admin 角色有,普通只读账号不一定。

常见坑

一句话总结

ServiceAccount 是身份,Role 是权限清单,RoleBinding 把两者绑起来;因为 RBAC 只做加法,所以从「一个 SA + 一个 namespace + 一个最小 Role」起步,再用 kubectl auth can-i 验证,比出了事再收权限省力得多。