0 官方教程

官方安装教程有坑，安装后不能正常 sudo apt update，这是因为无法连接 docker 的官方源。换成阿里源就好了。

接下来记录完美的安装流程。

1 卸载冲突的包

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)

2 准备环境

安装工具

sudo apt update
sudo apt install ca-certificates curl

导入阿里云 GPG 公钥

curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

配置apt的阿里云源（DEB822 格式）

sudo tee /etc/apt/sources.list.d/docker.sources <<'EOF'
X-Repolib-Name: docker
Types: deb
URIs: https://mirrors.aliyun.com/docker-ce/linux/ubuntu
Suites: noble
Components: stable
Architectures: amd64
Signed-By: /usr/share/keyrings/docker-archive-keyring.gpg
EOF

更新

sudo apt update

3 安装 docker 和 docker compose

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

注意：不再推荐使用 docker-compose 指令，现在推荐使用 docker compose 指令。

把当前用户加入 docker 组（不用每次运行docker指令都加上sudo了）

立即生效需重新登录，或执行 newgrp docker。

sudo usermod -aG docker $USER

4 配置镜像加速器

由于运营商网络原因，从Docker Hub拉取镜像会失败。配置镜像加速器可解决该问题（DockerHub 国内加速镜像列表）。

创建文件夹

sudo mkdir -p /etc/docker

配置 daemon.json

sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.xuanyuan.me",
    "https://docker.m.daocloud.io"
  ]
}
EOF

重启 docker

sudo systemctl daemon-reload
sudo systemctl restart docker

5 测试

查看 docker 服务状态

sudo systemctl status docker

启动 docker 服务

sudo systemctl start docker

测试

sudo docker run hello-world