首页/云/Kubernetes 速查/用调试 Pod 进入节点排查
集群运维与排障54 条

用调试 Pod 进入节点排查

节点上没有 SSH 或只想临时看宿主环境时,可用 kubectl debug node 启动一个挂载宿主根目录的调试 Pod,在 /host 下操作。

Kubernetes 速查云更新于 2026-10-13

不登节点也能排查

集群里的调试 Pod 可以在不开放远程登录的前提下进入宿主环境:它把节点根目录挂载到容器内,用容器运行时与内核工具查看磁盘、进程与容器列表。适合临时排查节点侧问题,也适合在安全策略禁止直接登录节点的环境里取一次现场。代价是这类 Pod 权限极高,用完必须清理。

基本信息

适用平台Kubernetes 1.20+,需要创建调试 Pod 的权限
命令入口kubectl debug node/<节点名>
宿主访问点容器内的 /host 目录
常用镜像busybox 等轻量镜像
权限代价挂载宿主根目录,权限等同节点管理权限

典型使用场景

  • 节点没有开放远程登录,需要临时查看磁盘与进程
  • 确认节点侧容器运行时里的容器与集群对象是否一致
  • 排查网络问题:查看节点路由、接口与转发规则
  • 内核或系统参数核验,例如连接数上限与转发开关
  • 节点被隔离后仍要取一次现场信息

进入节点(临时)

进入节点(临时)
kubectl debug node/node1 -it --image=busybox:1.36   # 启动调试 Pod 并进入
# 容器内:宿主根文件系统挂载在 /host
chroot /host df -h                                  # 查看宿主磁盘水位
chroot /host crictl ps | head                       # 查看运行时里的容器
chroot /host ip route | head                        # 查看宿主路由
chroot /host journalctl -u kubelet --no-pager | tail -20   # 看节点组件日志

需要保留现场时的清单(谨慎使用)

需要保留现场时的清单(谨慎使用)
apiVersion: v1
kind: Pod
metadata:
  name: node-debug
spec:
  hostNetwork: true        # 使用宿主网络命名空间
  hostPID: true            # 可见宿主进程
  containers:
    - name: shell
      image: busybox:1.36
      command: ["sleep", "infinity"]
      securityContext:
        privileged: true   # 特权模式,等同节点管理权限
      volumeMounts:
        - name: host-root
          mountPath: /host
  volumes:
    - name: host-root
      hostPath:
        path: /

调试入口怎么选

入口适合场景代价
调试节点需要看宿主文件与进程权限等同节点管理权限
调试容器副本业务容器缺少工具,需临时加工具排查影响单个副本,不触及宿主
临时容器生产 Pod 无法重建,只想临时进入依赖容器运行时支持
直接登节点常规系统维护需要开放登录通道与账号管理
调试容器里的工具集与节点宿主的工具集不同。进入后先确认命令是否存在,取宿主信息通常要在宿主目录下执行或在容器里直接指向宿主根目录。
挂载宿主根目录并开启特权,等价于拿到节点的管理权限。使用后立即删除并确认没有残留,生产集群应通过准入策略限制这类 Pod 的创建。

易错点

  • 用完忘记清理:这类 Pod 长期存在且权限极高,等于给集群留了一个常开后门
  • 在调试环境里直接修改宿主文件或内核参数:改动会连带影响节点上的其他工作负载
  • 把调试 Pod 当成常规运维通道:长期依赖它会让权限管理失控
  • 在生产命名空间里随意创建:缺少准入策略限制时,任何有创建权限的人都可能拿到节点权限

数据来源与参考

  • Kubernetes 官方文档 · kubectl debug 调试节点
  • Kubernetes 官方文档 · Pod 安全标准
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌