封面图片：Set Up a Kubernetes Node on Ubuntu 24.04 with containerd (the Docker-Compatible Runtime)

James Joyner

这是 2026 年在 Ubuntu 上运行 Kubernetes "with Docker" 的主流方式：containerd 作为运行时（Docker 在底层使用的同一引擎），你的 Docker 构建镜像 可直接运行。下面是在 Ubuntu 24.04 (Noble) 上通过 kubeadm 搭建节点的清晰流程，并指出关键注意事项。

以下所有命令请以 root 用户或通过 sudo 执行。本文搭建的是单控制平面节点；若要加入工作节点，请使用最后输出的 kubeadm join 命令。

1. 内核前置要求

Kubernetes 需要桥接流量通过 iptables 并开启 IP 转发：

cat <<'EOF' | sudo tee /etc/modules-load.d/k8s.conf
overlay
br_netfilter
EOF
sudo modprobe overlay
sudo modprobe br_netfilter

cat <<'EOF' | sudo tee /etc/sysctl.d/k8s.conf
net.bridge.bridge-nf-call-iptables  = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.ip_forward                 = 1
EOF
sudo sysctl --system

Enter fullscreen mode Exit fullscreen mode

禁用 swap —— kubelet 默认情况下若 swap 已开启则会拒绝启动：

sudo swapoff -a
sudo sed -i.bak '/\bswap\b/s/^/#/' /etc/fstab

Enter fullscreen mode Exit fullscreen mode

2. 安装 containerd 

sudo apt-get update
sudo apt-get install -y containerd
sudo mkdir -p /etc/containerd
containerd config default | sudo tee /etc/containerd/config.toml >/dev/null

Enter fullscreen mode Exit fullscreen mode

在 Ubuntu 上唯一需要修改的地方。 Ubuntu 22.04+ 使用 cgroup v2，因此 containerd 和 kubelet 必须都使用 systemd cgroup 驱动，否则节点会在 Ready/NotReady 之间反复切换：

sudo sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml
sudo systemctl restart containerd
sudo systemctl enable containerd

Enter fullscreen mode Exit fullscreen mode

（此不匹配情况较为常见，因此我在本系列后续文章中单独撰文说明。）

3. 安装 kubeadm、kubelet、kubectl

旧的 apt.kubernetes.io 仓库已下线，请改用 pkgs.k8s.io。请锁定你所需的次要版本（此处以 1.30 为例）：

sudo apt-get install -y apt-transport-https ca-certificates curl gpg
curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.30/deb/Release.key \
  | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/v1.30/deb/ /' \
  | sudo tee /etc/apt/sources.list.d/kubernetes.list

sudo apt-get update
sudo apt-get install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl   # 防止无人值守升级跳过次要版本

Enter fullscreen mode Exit fullscreen mode

4. 初始化控制平面

选择与你的 CNI 匹配的 Pod CIDR。这里使用 Flannel 的默认值：

sudo kubeadm init --pod-network-cidr=10.244.0.0/16

# 为当前用户配置 kubectl
mkdir -p $HOME/.kube
sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config

Enter fullscreen mode Exit fullscreen mode

5. 安装 CNI，然后验证 

kubectl apply -f https://github.com/flannel-io/flannel/releases/latest/download/kube-flannel.yml

kubectl get nodes -o wide
# STATUS 应在 1 分钟内变为 Ready；CONTAINER-RUNTIME 显示 containerd://1.7.x

Enter fullscreen mode Exit fullscreen mode

对于单节点实验环境，允许工作负载调度到控制平面：

kubectl taint nodes --all node-role.kubernetes.io/control-plane-

Enter fullscreen mode Exit fullscreen mode

6. 验证 Docker 镜像可运行 

kubectl create deployment web --image=nginx:1.27
kubectl expose deployment web --port=80
kubectl get pods -o wide     # Running，运行在你的 containerd 节点上

Enter fullscreen mode Exit fullscreen mode

该 nginx 镜像由 Docker 构建。由于它是 OCI 镜像，因此可直接在 containerd 上运行，无需转换——这也是本系列文章的核心要点。

当节点无法启动时

首次搭建节点时常见的失败原因包括：kubelet 无法启动（几乎总是 swap 或 cgroup 驱动问题），或 Pod 一直处于 Pending 状态（尚未安装 CNI）。我把具体修复方法放在这里：Kubernetes pod-startup errors 和 Kubernetes troubleshooting stack。

下一步：如果你特别需要将 Docker Engine 作为运行时（而非裸 containerd），请使用 cri-dockerd。