Docker在Debian上不支持源码编译安装，官方仅推荐APT安装或一键脚本；因其依赖复杂、无标准make流程、构建需Docker环境，强行编译会导致组件缺失、服务启动失败及维护困难。
Docker 不推荐也不支持在 Debian 上通过源码编译安装，官方明确要求使用预编译的二进制包（docker-ce）或官方脚本安装。原因很实际：
- Docker 依赖大量 Go 语言生态、容器运行时（如
containerd）、内核特性（cgroups v2、overlayfs 等），源码构建需同步维护数十个子项目版本； - 官方未提供
./configure && make && make install流程，也没有发布可直接make的 tarball 源码包； -
moby/moby主仓库虽开源，但它是开发用仓库，构建产物非生产就绪，且构建脚本（hack/dockerfile/installers/）本身依赖 Docker 构建环境 —— 属于“用 Docker 构建 Docker”，无法脱离已有 Docker 运行。
所以，所谓“编译安装”在 Debian 上并不存在标准路径，强行尝试会陷入以下问题：
- 缺少
runc、containerd、buildkit等组件的兼容版本管理； -
dockerd启动失败，报错如failed to load plugin "io.containerd.snapshotter.v1.overlayfs"或no such file or directory: /usr/bin/containerd； - systemd 单元文件、默认配置（
/etc/docker/daemon.json）、CLI 补全等均需手动补全，易遗漏； - 无法通过
apt更新，后续升级、安全修复完全靠手动追踪和重编译。
✅ 正确做法是：用官方支持的方式安装预编译包，它本质就是“已编译好、经验证、带签名的二进制分发”，这才是 Debian 场景下的标准实践。
✅ 推荐方式：APT 安装（稳定、安全、可更新）
# 1. 更新系统并安装基础依赖 sudo apt update && sudo apt upgrade -y sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release # 2. 添加 Docker 官方 GPG 密钥（Debian 12+ 推荐新路径） sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg sudo chmod a+r /etc/apt/keyrings/docker.gpg # 3. 添加官方仓库（自动适配架构与发行版代号） echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \ https://download.docker.com/linux/debian $(lsb_release -cs) stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null # 4. 安装 Docker Engine 及配套工具 sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin # 5. 启动并验证 sudo systemctl enable docker sudo systemctl start docker sudo docker run --rm hello-world
⚠️ 如果你真有特殊需求（如定制 dockerd 日志格式、打补丁调试），可考虑：
- 在已有 Docker 环境中，用
docker build编译moby项目（仅用于开发/测试）：git clone https://github.com/moby/moby cd moby DOCKER_BUILDKIT=1 docker build --target daemon -t my-docker-daemon .
- 但这生成的是镜像，不是系统级二进制；要替换宿主机
dockerd，仍需手动拷贝二进制、重写服务单元，不适用于生产环境。
? 额外建议（提升体验）
-
加用户到
docker组（免sudo）：sudo usermod -aG docker $USER # 注销重登后生效
-
配置国内镜像加速（解决拉取慢）：
sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<'EOF' { "registry-mirrors": ["https://docker.m.daocloud.io", "https://hub-mirror.c.163.com"] } EOF sudo systemctl restart docker
不复杂但容易忽略。
