You need to enable JavaScript to run this app. 树莓派4B搭建K3S集群:接入Agent节点后kubectl命令执行超时
优惠活动
大模型
产品
解决方案
定价
更多

树莓派4B搭建K3S集群:接入Agent节点后kubectl命令执行超时

树莓派4B搭建K3S集群接入Agent后kubectl命令超时问题

问题现象

  • 服务端以单节点独立模式运行时,执行所有kubectl命令均可正常返回结果;运行期间监控到服务端资源占用正常:CPU利用率稳定在30%-40%,总内存3.74G,已使用583M,不存在资源过载情况
  • 按标准流程接入第二台Agent节点后,在服务端节点执行kubectl命令出现固定超时错误,执行kubectl get nodes的报错信息如下:
root@k3s-master:/home/marc# kubectl get nodes
Error from server (Timeout): the server was unable to return a response in the time allotted, but may still be processing the request (get nodes)

基础配置与部署流程

硬件与系统参数

  • 集群硬件为2台配置4GB内存的树莓派4B
  • 节点系统为全新安装的Raspbian Lite(Buster版本),已按K3S官方要求开启Legacy iptables、cgroups相关系统配置

集群部署操作

  • 服务端节点执行官方标准安装命令完成部署:curl -sfL https://get.k3s.io | sh -
  • Agent节点配置服务端接入地址K3S_URL与集群认证K3S_TOKEN后,执行接入命令完成节点注册:curl -sfL https://get.k3s.io | K3S_URL=https://k3s-master:6443 K3S_TOKEN=<token> sh -

可落地排查方案与解决方向

  • 排查跨节点网络与端口放通状态
    • 从Agent节点主动测试服务端6443 API端口的连通性,排除端口被拦截、IPtables规则异常导致的API Server连接阻塞
    • 逐一验证集群内部必需通信端口的连通性:Flannel VXLAN通信的8472/udp端口、K3S内部控制器的8900/tcp端口、节点metrics采集的9100/tcp端口
    • 注意:仅在raspi-config中开启Legacy iptables参数但未重启节点的情况下,系统依然会使用nftables后端的规则链,直接导致跨节点通信丢包,是树莓派Buster版本运行K3S的高频踩坑点
  • 修正节点主机名解析配置
    • 检查所有节点/etc/hosts条目,确保两个节点可通过主机名双向解析到正确内网IP,排除反向解析失败导致的API Server查询节点列表时挂起等待
    • 可通过带短超时的命令快速定位问题:执行kubectl get nodes --request-timeout=5s,如果请求无响应或耗时极长后返回结果,基本可确认是DNS解析链路阻塞
  • 调整K3S服务端参数适配ARM平台特性
    • 树莓派ARM架构下,K3S默认的kube-apiserver并发线程配置偏高会引发不必要的上下文切换开销,可在服务端K3S启动参数中增加配置:--kube-apiserver-flag="--max-requests-inflight=200" --kube-apiserver-flag="--max-mutating-requests-inflight=100",修改完成后重启k3s服务验证
  • 临时关闭非必要组件排除资源争抢
    • 单节点独立运行状态下资源消耗低、命令响应正常,接入Agent后可先临时停用Traefik Ingress、CoreDNS自动扩容功能,验证是否为组件资源争抢引发的API响应超时

内容的提问来源于stack exchange,提问作者plsfix

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 05:15:04