Ubuntu 自动安装 Docker 脚本 - 码剑客

适用于 Ubuntu 20.04 / 22.04 / 24.04 的一键安装脚本:自动识别版本代号与架构、导入 GPG 公钥并配置阿里云 Docker 源、安装 docker-ce 与 compose 插件,附旧版本清理、镜像加速、免 sudo 与卸载步骤。

Ubuntu 20.04 / 22.04 / 24.04 · Docker 27.x更新于 2026-10-30共 23 条

前置检查与清理

确认版本代号与架构: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 docker

docker 组等价于 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 以确保您在我们的网站上获得最佳体验。 隐私政策.