内核版本过低导致docker engine安装失败，本质是cgroups v2、overlay2等依赖功能缺失；需按环境分别处理：wsl2下执行wsl --update --web-download并确认内核≥5.10.60.1，linux主机则升级内核至最低要求（centos 3.10+/ubuntu 4.15+），同时启用overlay、br_netfilter模块并验证cgroup2fs支持。
安装 docker engine 时提示“内核版本过低”，核心问题不是 docker engine 本身不兼容，而是它所依赖的 linux 内核功能（如 cgroups v2、overlay2 存储驱动、namespaces）未被当前系统内核支持。不同平台解决路径差异较大，需先明确运行环境。
Windows 上通过 WSL2 安装 Docker Engine
这是目前最常见也最易出内核问题的场景——Docker Engine 实际运行在 WSL2 的 Linux 内核里，而非 Windows 内核上。
- 检查当前 WSL2 内核版本：在 PowerShell 中运行 wsl --status 或 wsl -k（新版本支持），重点关注 Kernel version 是否 ≥ 5.10.60.1
- 强制更新内核：执行 wsl --update --web-download，绕过 Windows Update 限制，直接拉取微软签名的最新内核包
- 若仍失败，手动下载安装：https://www.php.cn/link/374d383550f673cead5c903caca73d6f → 运行 .msi 文件 → 必须重启电脑
- 确认发行版已升级到 WSL2：用 wsl --list --verbose 查看 VERSION 列，非 2 的需执行 wsl --set-version
2
Linux 主机安装 Docker Engine
原生 Linux 系统中，内核版本不足通常出现在老旧发行版（如 CentOS 7.2、Ubuntu 16.04）或定制固件（如 OpenWRT）上。
- 查看当前内核：uname -r，Docker Engine 最低要求为 3.10（CentOS）或 4.15（Ubuntu 20.04+ 推荐）
- CentOS/RHEL 系统可升级内核：yum install kernel-ml（elrepo 源），再用 grubby --set-default 切换启动项并重启
- OpenWRT 等嵌入式系统一般无法升级内核，建议改用轻量级替代方案（如 podman machine 或 LXC 容器），或迁移到 Alpine Linux 等支持高内核版本的发行版
验证内核能力是否就绪
即使内核版本达标，某些关键模块可能被禁用或未编译进内核，导致 Docker 启动失败。
- 检查 cgroups v2 是否启用：stat -fc %T /sys/fs/cgroup，应返回 cgroup2fs；若为 cgroup，需在 GRUB 启动参数中添加 systemd.unified_cgroup_hierarchy=1
- 确认 overlay2 支持：modprobe overlay && modprobe br_netfilter，再检查 lsmod | grep overlay 是否有输出
- 运行 docker info，重点看 Storage Driver 和 Cgroup Version 字段是否正常，而非仅看内核号
跳过内核限制的务实替代方案
当升级内核不可行（如权限受限、设备固件锁定、生产环境不允许重启），可考虑更适配的运行时。
- 使用 Podman：无需守护进程，不依赖 systemd 或 cgroups v2，rootless 模式在低内核上更稳定
- 启用 dockerd --storage-driver=vfs：牺牲性能换取兼容性，适合测试环境
- 在 WSL2 中安装原生 Docker Engine 而非 Docker Desktop：避免中间层代理对内核调用的额外约束，实测在相同内核下更易启动成功
