确认版本代号与架构:20.04 为 focal、22.04 为 jammy、24.04 为 noble
lsb_release -cs
cat /etc/os-release | head -3
dpkg --print-architecture适用于 Ubuntu 20.04 / 22.04 / 24.04 的一键安装脚本:自动识别版本代号与架构、导入 GPG 公钥并配置阿里云 Docker 源、安装 docker-ce 与 compose 插件,附旧版本清理、镜像加速、免 sudo 与卸载步骤。
确认版本代号与架构:20.04 为 focal、22.04 为 jammy、24.04 为 noble
lsb_release -cs
cat /etc/os-release | head -3
dpkg --print-architecture卸载发行版自带或旧版 Docker,避免与 docker-ce 的 containerd 冲突
sudo apt remove -y docker docker-engine docker.io containerd runc
sudo apt autoremove -y卸载不会删除 /var/lib/docker,镜像与容器数据仍会保留
Ubuntu 24.04 预装了 containerd,全新系统建议先移除再装 docker-ce
sudo apt remove -y containerd
sudo apt autoremove -y安装脚本所需的依赖:https 传输、证书、curl、gnupg 与版本探测工具
sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release整段保存为 install-docker.sh 后执行 bash install-docker.sh 即可完成安装
#!/bin/bash
set -euo pipefail
CODENAME=$(lsb_release -cs)
echo "当前系统版本代号: ${CODENAME}"
# 前置依赖
sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release
# 导入阿里云 Docker GPG 公钥
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg
# 添加阿里云 Docker 软件源,架构与版本代号自动识别
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/trusted.gpg.d/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu ${CODENAME} stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 安装 Docker 引擎、Buildx 与 Compose 插件
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# 验证
docker --version
docker compose version脚本可重复执行;重复运行前建议确认 docker.list 中的源地址是否正确
赋予执行权限并以 root 运行,避免脚本内 sudo 反复提示
chmod +x install-docker.sh
sudo bash install-docker.sh导入阿里云镜像站的 Docker 仓库公钥,写入独立 keyring 文件
curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker.gpg添加软件源,arch 与 signed-by 必须保留,否则 apt 会拒绝该源
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/trusted.gpg.d/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list刷新索引并确认可安装的 docker-ce 版本来自阿里云源
sudo apt update
apt-cache policy docker-ce若提示 NO_PUBKEY,说明公钥未正确导入,重新执行上一步
安装引擎、CLI、containerd、buildx 与 compose 插件,一次装齐常用组件
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin验证三个组件均可执行,compose 是插件形式而非旧的 docker-compose 二进制
docker --version
docker compose version
docker buildx version把当前用户加入 docker 组以免 sudo,newgrp 可立即生效,否则需重新登录
sudo usermod -aG docker "$USER"
newgrp dockerdocker 组等价于 root 权限,多用户主机请谨慎授权
设置开机自启并立即启动,确认状态为 active (running)
sudo systemctl enable --now docker
systemctl status docker --no-pager配置镜像加速地址,替换为云厂商控制台提供的专属地址,不要直接抄公开链接
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{
"registry-mirrors": ["<你的镜像加速地址>"]
}
EOF重载配置并重启,输出中出现加速地址说明已生效
sudo systemctl daemon-reload
sudo systemctl restart docker
docker info | grep -A2 "Registry Mirrors"限制容器日志大小,避免长期运行后把磁盘写满;多个配置项需合并到同一个 JSON
sudo tee /etc/docker/daemon.json <<'EOF'
{
"log-driver": "json-file",
"log-opts": { "max-size": "100m", "max-file": "3" }
}
EOF运行官方测试镜像,能输出提示信息说明引擎与镜像拉取均正常
docker run --rm hello-world服务启动失败时先看这两处日志,常见原因是 daemon.json 格式错误
systemctl status docker --no-pager
journalctl -u docker -n 50 --no-pager查看 cgroup 版本与存储驱动,Ubuntu 24.04 默认使用 systemd cgroup 与 overlay2
docker info | grep -iE "cgroup|storage driver|server version"Ubuntu 24.04 默认 iptables-nft,Docker 会自动适配;端口映射异常时查看 NAT 规则
sudo iptables -t nat -L DOCKER -n -v若同时启用 ufw,需在 /etc/docker/daemon.json 之外额外放行所需端口
卸载 Docker 相关软件包,保留 /var/lib/docker 中的数据
sudo apt purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin删除全部镜像、容器与卷数据,执行后无法恢复
sudo rm -rf /var/lib/docker /var/lib/containerd移除软件源与公钥文件,否则重装时可能读到失效配置
sudo rm -f /etc/apt/sources.list.d/docker.list /etc/apt/trusted.gpg.d/docker.gpg
sudo apt update本网站使用 Cookie 以确保您在我们的网站上获得最佳体验。 隐私政策.