Docker 不支持 Kubernetes 的 RuntimeClass，仅通过 --runtime 参数调用指定运行时（如 kata-runtime）；RuntimeClass 是 Kubernetes 通过 kubelet 与 CRI（如 containerd）协同实现的 Pod 级运行时调度机制，需正确配置 containerd shim、RuntimeClass 对象及 handler 对齐。

不能直接在 Docker 中用 RuntimeClass —— 这是 Kubernetes 的概念，Docker 不支持 RuntimeClass。 你看到的 docker run --runtime=kata-container 是 Docker 自己的 --runtime 参数，和 Kubernetes 的 RuntimeClass 完全无关。混淆这两者会导致配置失败、调度异常或根本起不来 Kata 容器。

为什么 Docker 没有 RuntimeClass

Docker 的运行时选择机制早于 Kubernetes CRI 标准，它只认 --runtime 字符串（如 kata-runtime），不解析 YAML、不读取 RuntimeClass 对象、也不做调度决策。Kubernetes 的 RuntimeClass 是通过 kubelet + CRI Shim（如 containerd）协同实现的：它把 Pod 的 runtimeClassName 字段传给 CRI，再由 CRI Shim 调用对应运行时（比如 io.containerd.kata.v2）。Docker 根本没有这套抽象层。

常见错误现象：

• 把 Kubernetes 的 RuntimeClass YAML 直接丢进 /etc/docker/daemon.json，结果 daemon 启动失败
• 在 docker run 命令里加 --runtime-class kata，报错 unknown flag: --runtime-class
• 误以为 docker info 显示了 runtimes 就等于支持 RuntimeClass

在 containerd + Kubernetes 中正确配置 Kata RuntimeClass

真正需要 RuntimeClass 的场景，一定是跑在 Kubernetes 上、且希望按 Pod 级别动态指定 Kata 或 runc。这要求底层容器运行时是 containerd（不是 Docker），并启用 Kata 的 CRI 插件。

实操关键点：

• 确认 containerd 已安装 Kata shim：containerd-shim-kata-v2 必须存在且可执行，路径通常为 /usr/bin/containerd-shim-kata-v2
• 修改 /etc/containerd/config.toml，在 [plugins."io.containerd.grpc.v1.cri".containerd.runtimes] 下添加：

  [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.kata]
    runtime_type = "io.containerd.kata.v2"

• 创建 RuntimeClass 对象（注意 handler 必须与 config.toml 中的 key 一致）：

  apiVersion: node.k8s.io/v1
  kind: RuntimeClass
  metadata:
    name: kata
  handler: kata

• Pod 中显式声明：runtimeClassName: kata；不写则默认走 runc

漏掉 handler 名称对齐，或没重启 containerd，都会导致 Pod 卡在 ContainerCreating。

OpenClaw Docker Setup

在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

下载

docker run --runtime=kata-container 的真实含义

这是 Docker 的遗留机制，本质是让 dockerd 直接 fork 并调用 kata-runtime 二进制，绕过 containerd。它不经过 CRI，也不受 RuntimeClass 控制。

使用前提：

• kata-runtime 已安装且在 $PATH 中
• /etc/docker/daemon.json 中已注册：

  "runtimes": {
    "kata": {
      "path": "/usr/bin/kata-runtime"
    }
  }

• 必须用 --runtime kata（不是 kata-container，除非你自定义了这个名字）
• 不支持 --privileged、--pid=host 等多数高级选项 —— Kata MicroVM 无法共享宿主机命名空间

典型失败命令：docker run --runtime kata --network host nginx，因为 Kata VM 没有 host 网络栈，会卡住或报 failed to create network namespace。

MTU 和网络配置容易被忽略

Kata 容器启动后实际走的是虚拟网卡（如 veth → tap → MicroVM 内部 virtio-net），链路比原生容器多跳。默认 Docker mtu 1500 在 Kata 下极易引发分片丢包。

必须同步调整：

• Docker daemon 配置中设 "mtu": 1450（推荐值，适配大多数云环境）
• 如果用 CNI（如 Calico/Cilium），也要检查其 mtu 是否匹配，否则 Pod 间 TCP 握手失败
• kata-runtime kata-check 会提示 MTU 不匹配警告，但不会阻止启动 —— 这个警告真得当回事

网络不通时，先看 kata-runtime list 是否有运行中实例，再查 ip link show 里有没有 kata- 开头的 tap 设备，最后抓包确认是否在 tap 层就丢包。