在 debian 系统上安装 docker engine 的核心是使用官方 apt 仓库安装 docker-ce 及配套组件，需先卸载冲突的旧版 docker.io 等包，再添加 gpg 密钥、配置稳定仓库路径，最后安装 docker-ce、docker-ce-cli、containerd.io 和插件，并启用服务、验证安装及配置用户权限。
在 debian 系统上安装 docker engine，核心是使用官方 apt 仓库安装 docker-ce 及其配套组件，避免使用系统自带的旧版 docker.io。整个过程需清理旧包、添加可信源、正确配置仓库路径，并赋予普通用户操作权限。
卸载冲突的旧版本
Debian 默认仓库中的 docker.io、docker-compose 或第三方打包的 podman-docker 会与官方 Docker Engine 冲突，必须先移除：
- 运行命令一次性清理常见冲突包：
sudo apt-get remove docker docker-engine docker.io docker-doc podman-docker containerd runc - 若提示“未安装”，说明无冲突，可跳过；该步骤不会删除
/var/lib/docker/下已有的镜像和容器数据（除非你额外加--purge）
配置官方 APT 仓库
确保使用 Docker 官方源而非 Debian 默认源，这是获取新版、安全更新和完整功能（如 Buildx、Compose Plugin）的前提：
OpenClaw Docker Setup
下载
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 更新包索引并安装 HTTPS 支持依赖：
sudo apt update && sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release - 下载并安装 Docker 官方 GPG 密钥（推荐存入
/etc/apt/keyrings/）：sudo install -m 0755 -d /etc/apt/keyringscurl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpgsudo chmod a+r /etc/apt/keyrings/docker.gpg - 添加稳定版仓库条目（注意路径和变量写法，避免报错
Type 'echo' is not known）：echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
安装并启用 Docker Engine
完成源配置后，即可安装最新稳定版引擎及配套工具：
- 刷新包列表：
sudo apt update - 安装核心组件：
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin - 启动服务并设为开机自启：
sudo systemctl start docker && sudo systemctl enable docker - 验证服务状态：
sudo systemctl status docker—— 应显示active (running)
验证安装并配置用户权限
安装成功后建议立即测试，并让当前用户免密使用 Docker：
- 运行官方测试镜像：
sudo docker run hello-world—— 成功会输出欢迎信息并退出 - 将当前用户加入
docker组（避免每次敲sudo）：sudo usermod -aG docker $USER - ⚠️ 注意：该操作需重新登录终端或执行
newgrp docker才能生效 - 验证非 root 权限可用：
docker ps（应返回空列表，不报 permission denied）
