安装Docker并使用镜像仓库ACR - 云服务器 ECS

Docker是一个开放平台，用于开发、发布和运行应用程序。如果您需要在实例上安装和使用Docker，可以参考本文，文中将介绍如何在实例上部署Docker以及一些基本的操作方法。

安装Docker

Alibaba Cloud Linux 3

在安装最新版本的Docker之前，您可以使用docker -v命令来检查当前的Docker版本。如果提示没有此命令，说明您还未安装Docker，若已安装旧版本的Docker，则需先卸载及其相关组件。

卸载旧版本的Docker

执行以下命令来卸载旧版本的Docker和相关的软件包，这个命令会帮您卸载掉所有列出的与Docker相关的程序。
说明
如果系统提示说部分软件包没有安装，说明您还未安装此软件包。
```
sudo dnf -y remove \
docker-ce \
containerd.io \
docker-ce-rootless-extras \
docker-buildx-plugin \
docker-ce-cli \
docker-compose-plugin
```
Docker默认保存位置是/var/lib/docker/，卸载Docker时，镜像、容器、存储卷和网络不会被自动删除。如果您想要删除这些数据，需要手动删除。

更新您的包管理工具。
```
sudo dnf -y update
```

添加阿里云源到您的实例中，这个源包含Docker软件包，方便您使用命令来安装和更新Docker。

如果您的实例网络可以访问公网。

sudo dnf config-manager --add-repo=https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

如果您的实例网络无法访问公网，使用VPC网络访问地址。

sudo dnf config-manager --add-repo=http://mirrors.cloud.aliyuncs.com/docker-ce/linux/centos/docker-ce.repo
sudo sed -i 's|https://mirrors.aliyun.com|http://mirrors.cloud.aliyuncs.com|g' /etc/yum.repos.d/docker-ce.repo

安装Alibaba Cloud Linux3专用的dnf源兼容插件。

sudo dnf -y install dnf-plugin-releasever-adapter --repo alinux3-plus

安装Docker社区版本，容器运行时containerd.io，以及Docker构建和编排工具的插件。
```
sudo dnf -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
启动Docker并设置Docker守护进程在系统启动时自动启动，这样可以确保每次系统启动时，Docker服务也会自动启动。
说明
如果您的systemctl命令执行异常，请参见在Linux实例中执行systemctl命令报错怎么办？
```
sudo systemctl start docker
sudo systemctl enable docker
```
通过查看Docker版本命令，验证Docker是否安装成功。
```
sudo docker -v
```
如下图回显信息所示，表示Docker已安装成功。

Alibaba Cloud Linux 2

卸载旧版本的Docker

执行以下命令来卸载旧版本的Docker和相关的软件包，这个命令会帮您卸载掉所有列出的与Docker相关的程序。
说明
如果系统提示说部分软件包没有安装，说明您还未安装此软件包。
```
sudo yum -y remove \
docker-ce \
containerd.io \
docker-ce-rootless-extras \
docker-buildx-plugin \
docker-ce-cli \
docker-compose-plugin
```
Docker默认保存位置是/var/lib/docker/，卸载Docker时，镜像、容器、存储卷和网络不会被自动删除。如果您想要删除这些数据，需要手动删除。

更新您的包管理工具。
```
sudo yum -y update
```

添加阿里云源到您的实例中，这个源包含Docker软件包，方便您使用命令来安装和更新Docker。

如果您的实例网络可以访问公网。

sudo wget -O /etc/yum.repos.d/docker-ce.repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

如果您的实例网络无法访问公网，使用VPC网络访问地址。

sudo wget -O /etc/yum.repos.d/docker-ce.repo http://mirrors.cloud.aliyuncs.com/docker-ce/linux/centos/docker-ce.repo
sudo sed -i 's|https://mirrors.aliyun.com|http://mirrors.cloud.aliyuncs.com|g' /etc/yum.repos.d/docker-ce.repo

安装Alibaba Cloud Linux2专用的yum源兼容插件。

sudo yum install yum-plugin-releasever-adapter --disablerepo=* --enablerepo=plus

安装Docker社区版本，容器运行时containerd.io，以及Docker构建和编排工具的插件。
```
sudo yum -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
启动Docker并设置Docker守护进程在系统启动时自动启动，这样可以确保每次系统启动时，Docker服务也会自动启动。
说明
如果您的systemctl命令执行异常，请参见在Linux实例中执行systemctl命令报错怎么办？
```
sudo systemctl start docker
sudo systemctl enable docker
```
通过查看Docker版本命令，验证Docker是否安装成功。
```
sudo docker -v
```
如下图回显信息所示，表示Docker已安装成功。

CentOS 7.x

卸载旧版本的Docker

执行以下命令来卸载旧版本的Docker和相关的软件包，这个命令会帮您卸载掉所有列出的与Docker相关的程序。
说明
如果系统提示说部分软件包没有安装，说明您还未安装此软件包。
```
sudo yum -y remove \
docker-ce \
containerd.io \
docker-ce-rootless-extras \
docker-buildx-plugin \
docker-ce-cli \
docker-compose-plugin
```
Docker默认保存位置是/var/lib/docker/，卸载Docker时，镜像、容器、存储卷和网络不会被自动删除。如果您想要删除这些数据，需要手动删除。

更新您的包管理工具。
```
sudo yum -y update
```

添加阿里云源到您的实例中，这个源包含Docker软件包，方便您使用命令来安装和更新Docker。

如果您的实例网络可以访问公网。

sudo wget -O /etc/yum.repos.d/docker-ce.repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

如果您的实例网络无法访问公网，使用VPC网络访问地址。

sudo wget -O /etc/yum.repos.d/docker-ce.repo http://mirrors.cloud.aliyuncs.com/docker-ce/linux/centos/docker-ce.repo
sudo sed -i 's|https://mirrors.aliyun.com|http://mirrors.cloud.aliyuncs.com|g' /etc/yum.repos.d/docker-ce.repo

安装Docker社区版本，容器运行时containerd.io，以及Docker构建和编排工具的插件。
```
sudo yum -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
启动Docker并设置Docker守护进程在系统启动时自动启动，这样可以确保每次系统启动时，Docker服务也会自动启动。
说明
如果您的systemctl命令执行异常，请参见在Linux实例中执行systemctl命令报错怎么办？
```
sudo systemctl start docker
sudo systemctl enable docker
```
通过查看Docker版本命令，验证Docker是否安装成功。
```
sudo docker -v
```
如下图回显信息所示，表示Docker已安装成功。

CentOS 8.x

卸载旧版本的Docker

执行以下命令来卸载旧版本的Docker和相关的软件包，这个命令会帮您卸载掉所有列出的与Docker相关的程序。
说明
如果系统提示说部分软件包没有安装，说明您还未安装此软件包。
```
sudo dnf -y remove \
docker-ce \
containerd.io \
docker-ce-rootless-extras \
docker-buildx-plugin \
docker-ce-cli \
docker-compose-plugin
```
Docker默认保存位置是/var/lib/docker/，卸载Docker时，镜像、容器、存储卷和网络不会被自动删除。如果您想要删除这些数据，需要手动删除。

更新您的包管理工具。
```
sudo dnf -y update
```

添加阿里云源到您的实例中，这个源包含Docker软件包，方便您使用命令来安装和更新Docker。

如果您的实例网络可以访问公网。

sudo dnf config-manager --add-repo=https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

如果您的实例网络无法访问公网，使用VPC网络访问地址。

sudo dnf config-manager --add-repo=http://mirrors.cloud.aliyuncs.com/docker-ce/linux/centos/docker-ce.repo
sudo sed -i 's|https://mirrors.aliyun.com|http://mirrors.cloud.aliyuncs.com|g' /etc/yum.repos.d/docker-ce.repo

安装Docker社区版本，容器运行时containerd.io，以及Docker构建和编排工具的插件。
```
sudo dnf -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
启动Docker并设置Docker守护进程在系统启动时自动启动，这样可以确保每次系统启动时，Docker服务也会自动启动。
说明
如果您的systemctl命令执行异常，请参见在Linux实例中执行systemctl命令报错怎么办？
```
sudo systemctl start docker
sudo systemctl enable docker
```
通过查看Docker版本命令，验证Docker是否安装成功。
```
sudo docker -v
```
如下图回显信息所示，表示Docker已安装成功。

Ubuntu

卸载旧版本的Docker

执行以下命令来卸载旧版本的Docker和相关的软件包，这个命令会帮您卸载掉所有列出的与Docker相关的程序。
说明
如果系统提示说部分软件包没有安装，说明您还未安装此软件包。
```
for pkg in docker.io docker-buildx-plugin docker-ce-cli docker-ce-rootless-extras docker-compose-plugin docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove -y $pkg; done
```
Docker默认保存位置是/var/lib/docker/，卸载Docker时，镜像、容器、存储卷和网络不会被自动删除。如果您想要删除这些数据，需要手动删除。

更新您的包管理工具。
```
sudo apt-get update
```

添加阿里云源到您的实例中，这个源包含Docker软件包，方便您使用命令来安装和更新Docker。

如果您的实例网络可以访问公网。

sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common
sudo curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | apt-key add -
sudo add-apt-repository -y "deb [arch=$(dpkg --print-architecture)] https://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"

如果您的实例网络无法访问公网，使用VPC网络访问地址。

sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common
sudo curl -fsSL http://mirrors.cloud.aliyuncs.com/docker-ce/linux/ubuntu/gpg | apt-key add -
sudo add-apt-repository -y "deb [arch=$(dpkg --print-architecture)] http://mirrors.cloud.aliyuncs.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"

安装Docker社区版本，容器运行时containerd.io，以及Docker构建和编排工具的插件。

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

启动Docker并设置Docker守护进程在系统启动时自动启动，这样可以确保每次系统启动时，Docker服务也会自动启动。
说明
如果您的systemctl命令执行异常，请参见在Linux实例中执行systemctl命令报错怎么办？
```
sudo systemctl start docker
sudo systemctl enable docker
```
通过查看Docker版本命令，验证Docker是否安装成功。
```
sudo docker -v
```
如下图回显信息所示，表示Docker已安装成功。

Debian

卸载旧版本的Docker

执行以下命令来卸载旧版本的Docker和相关的软件包，这个命令会帮您卸载掉所有列出的与Docker相关的程序。
说明
如果系统提示说部分软件包没有安装，说明您还未安装此软件包。
```
for pkg in docker.io docker-buildx-plugin docker-ce-cli docker-ce-rootless-extras docker-compose-plugin docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove -y $pkg; done
```
Docker默认保存位置是/var/lib/docker/，卸载Docker时，镜像、容器、存储卷和网络不会被自动删除。如果您想要删除这些数据，需要手动删除。

更新您的包管理工具。
```
sudo apt-get update
```

添加阿里云源到您的实例中，这个源包含Docker软件包，方便您使用命令来安装和更新Docker。

如果您的实例网络可以访问公网。

sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common
sudo curl -fsSL https://mirrors.aliyun.com/docker-ce/linux/debian/gpg | apt-key add -
sudo add-apt-repository -y "deb [arch=$(dpkg --print-architecture)] https://mirrors.aliyun.com/docker-ce/linux/debian $(lsb_release -cs) stable"
sudo apt-get update

如果您的实例网络无法访问公网，使用VPC网络访问地址。

sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common
sudo curl -fsSL http://mirrors.cloud.aliyuncs.com/docker-ce/linux/debian/gpg | apt-key add -
sudo add-apt-repository -y "deb [arch=$(dpkg --print-architecture)] http://mirrors.cloud.aliyuncs.com/docker-ce/linux/debian $(lsb_release -cs) stable"
sudo apt-get update

安装Docker社区版本，容器运行时containerd.io，以及Docker构建和编排工具的插件。

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

启动Docker并设置Docker守护进程在系统启动时自动启动，这样可以确保每次系统启动时，Docker服务也会自动启动。
说明
如果您的systemctl命令执行异常，请参见在Linux实例中执行systemctl命令报错怎么办？
```
sudo systemctl start docker
sudo systemctl enable docker
```
通过查看Docker版本命令，验证Docker是否安装成功。
```
sudo docker -v
```
如下图回显信息所示，表示Docker已安装成功。

Fedora

卸载旧版本的Docker

执行以下命令来卸载旧版本的Docker和相关的软件包，这个命令会帮您卸载掉所有列出的与Docker相关的程序。
说明
如果系统提示说部分软件包没有安装，说明您还未安装此软件包。
```
sudo dnf -y remove \
docker-ce \
containerd.io \
docker-ce-rootless-extras \
docker-buildx-plugin \
docker-ce-cli \
docker-compose-plugin
```
Docker默认保存位置是/var/lib/docker/，卸载Docker时，镜像、容器、存储卷和网络不会被自动删除。如果您想要删除这些数据，需要手动删除。

更新您的包管理工具。
```
sudo dnf -y update
```

添加阿里云源到您的实例中，这个源包含Docker软件包，方便您使用命令来安装和更新Docker。

如果您的实例网络可以访问公网。

sudo dnf config-manager --add-repo=https://mirrors.aliyun.com/docker-ce/linux/fedora/docker-ce.repo

如果您的实例网络无法访问公网，使用VPC网络访问地址。

sudo dnf config-manager --add-repo=http://mirrors.cloud.aliyuncs.com/docker-ce/linux/fedora/docker-ce.repo
sudo sed -i 's|https://mirrors.aliyun.com|http://mirrors.cloud.aliyuncs.com|g' /etc/yum.repos.d/docker-ce.repo

安装Docker社区版本，容器运行时containerd.io，以及Docker构建和编排工具的插件。
```
sudo dnf -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
启动Docker并设置Docker守护进程在系统启动时自动启动，这样可以确保每次系统启动时，Docker服务也会自动启动。
说明
如果您的systemctl命令执行异常，请参见在Linux实例中执行systemctl命令报错怎么办？
```
sudo systemctl start docker
sudo systemctl enable docker
```
通过查看Docker版本命令，验证Docker是否安装成功。
```
sudo docker -v
```
如下图回显信息所示，表示Docker已安装成功。

Red Hat

卸载旧版本的Docker

执行以下命令来卸载旧版本的Docker和相关的软件包，这个命令会帮您卸载掉所有列出的与Docker相关的程序。
说明
如果系统提示说部分软件包没有安装，说明您还未安装此软件包。
```
sudo yum -y remove \
docker-ce \
containerd.io \
docker-ce-rootless-extras \
docker-buildx-plugin \
docker-ce-cli \
docker-compose-plugin
```
Docker默认保存位置是/var/lib/docker/，卸载Docker时，镜像、容器、存储卷和网络不会被自动删除。如果您想要删除这些数据，需要手动删除。

更新您的包管理工具。
```
sudo dnf -y update
```

添加阿里云源到您的实例中，这个源包含Docker软件包，方便您使用命令来安装和更新Docker。

如果您的实例网络可以访问公网。

sudo wget -O /etc/yum.repos.d/docker-ce.repo https://mirrors.aliyun.com/docker-ce/linux/rhel/docker-ce.repo

如果您的实例网络无法访问公网，使用VPC网络访问地址。

sudo wget -O /etc/yum.repos.d/docker-ce.repo http://mirrors.cloud.aliyuncs.com/docker-ce/linux/rhel/docker-ce.repo
sudo sed -i 's|https://mirrors.aliyun.com|http://mirrors.cloud.aliyuncs.com|g' /etc/yum.repos.d/docker-ce.repo

安装Docker社区版本，容器运行时containerd.io，以及Docker构建和编排工具的插件。
```
sudo yum -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
启动Docker并设置Docker守护进程在系统启动时自动启动，这样可以确保每次系统启动时，Docker服务也会自动启动。
说明
如果您的systemctl命令执行异常，请参见在Linux实例中执行systemctl命令报错怎么办？
```
sudo systemctl start docker
sudo systemctl enable docker
```
通过查看Docker版本命令，验证Docker是否安装成功。
```
sudo docker -v
```
如下图回显信息所示，表示Docker已安装成功。

Anolis OS

卸载旧版本的Docker

执行以下命令来卸载旧版本的Docker和相关的软件包，这个命令会帮您卸载掉所有列出的与Docker相关的程序。
说明
如果系统提示说部分软件包没有安装，说明您还未安装此软件包。
```
sudo yum -y remove \
docker-ce \
containerd.io \
docker-ce-rootless-extras \
docker-buildx-plugin \
docker-ce-cli \
docker-compose-plugin
```
Docker默认保存位置是/var/lib/docker/，卸载Docker时，镜像、容器、存储卷和网络不会被自动删除。如果您想要删除这些数据，需要手动删除。

更新您的包管理工具。
```
sudo yum -y update
```

添加阿里云源到您的实例中，这个源包含Docker软件包，方便您使用命令来安装和更新Docker。

如果您的实例网络可以访问公网。

sudo wget -O /etc/yum.repos.d/docker-ce.repo https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo

如果您的实例网络无法访问公网，使用VPC网络访问地址。

sudo wget -O /etc/yum.repos.d/docker-ce.repo http://mirrors.cloud.aliyuncs.com/docker-ce/linux/centos/docker-ce.repo
sudo sed -i 's|https://mirrors.aliyun.com|http://mirrors.cloud.aliyuncs.com|g' /etc/yum.repos.d/docker-ce.repo

安装Docker社区版本，容器运行时containerd.io，以及Docker构建和编排工具的插件。
```
sudo yum -y install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
```
启动Docker并设置Docker守护进程在系统启动时自动启动，这样可以确保每次系统启动时，Docker服务也会自动启动。
说明
如果您的systemctl命令执行异常，请参见在Linux实例中执行systemctl命令报错怎么办？
```
sudo systemctl start docker
sudo systemctl enable docker
```
通过查看Docker版本命令，验证Docker是否安装成功。
```
sudo docker -v
```
如下图回显信息所示，表示Docker已安装成功。

创建简单Web程序镜像

接下来，我将为您演示使用Nginx镜像作为基础镜像，创建简单Web程序镜像。

前期准备

您的实例可以连接公网，使用docker pull命令获取Nginx最新版镜像。

sudo docker pull nginx:latest

创建镜像

您需要创建一个名为Dockerfile的文件。Dockerfile是一个特殊的文本文件，它用来定义如何构建一个 Docker 镜像。这个文件会告诉Docker需要使用哪个基础镜像，以及在这个基础镜像上需要安装哪些软件和进行哪些配置。
```
sudo touch Dockerfile
```

编辑创建的Dockerfile并添加内容。

FROM nginx:latest
RUN echo 'Hello World!' > /usr/share/nginx/html/index.html

使用Dockerfile构建您的镜像。

sudo docker build . -t hello-world:latest

为您的新镜像创建容器，并且命名容器名称为hello-world。
```
sudo docker run -d -p 80:80 --name hello-world hello-world:latest
```
验证您的镜像，执行命令curl http://localhost，输出hello world!。

常见问题

Linux ECS实例中执行dnf config-manager命令报错

问题现象：在Linux系统实例中执行dnf config-manager命令出现如下报错：

/usr/lib/python3/dist-packages/dnf/const.py:22: DeprecationWarning: The distutils package is deprecated and slated for removal in Python 3.12. Use setuptools or check PEP 632 for potential alternatives.

可能原因：dnf版本太旧导致安装失败。
解决方案：您可以尝试使用sudo dnf update dnf来更新dnf软件包到最新状态，然后再尝试安装docker。

Linux ECS实例中执行dnf install docker-ce命令报错

问题现象一：在Linux系统实例中执行dnf -y install docker-ce命令出现如下报错：

(8-9/12): docker-ce-24.0.7-1.el8.x86_64.rpm 38% [================- ] 8.2 MB/s | 38 MB 00:07 ETA
The downloaded packages were saved in cache until the next successful transaction.
You can remove cached packages by executing 'dnf clean packages'.
Error: Error downloading packages:
containerd.io-1.6.26-3.1.el8.x86_64: Cannot download, all mirrors were already tried without success.

可能原因：软件包缓存太旧导致安装失败。

解决方案：您可以尝试使用sudo dnf clean packages清理软件包缓存之后，再尝试安装docker。

问题现象二：在Linux系统实例中执行dnf -y install docker-ce命令出现如下报错：

CentOS- Base                                                                                                                         0.0  B/s |   0  B     00:30    
Errors during downloading metadata for repository 'base':
  - Curl error (6): Couldn't resolve host name for http://mirror.centos.org/os/BaseOS/x86_64/os/repodata/repomd.xml [Could not resolve host: mirror.aliyuncs.com]
  - Curl error (28): Timeout was reached for http://mirror.centos.org/os/BaseOS/x86_64/os/repodata/repomd.xml [Connection timed out after 30000 milliseconds]
  - Curl error (6): Couldn't resolve host name for http://mirror.centos.org/os/BaseOS/x86_64/os/repodata/repomd.xml [Could not resolve host: mirror.cloud.aliyuncs.com]
Error: Failed to download metadata for repo 'base': Cannot download repomd.xml: Cannot download repodata/repomd.xml: All mirrors were tried

可能原因：使用了已下线的CentOS 8软件源。

解决方案：可参考如下步骤，使用阿里提供的可用源替换已下线的CentOS 8软件源。

# 备份过期软件源。
sudo mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup
# 下载阿里提供的CentOS-Base.repo 到 /etc/yum.repos.d/。
wget -O /etc/yum.repos.d/CentOS-Base.repo http://mirrors.cloud.aliyuncs.com/repo/Centos-vault-8.5.2111.repo
# 将阿里源中的软件源地址替换为ECS可访问的源地址。
sudo sed -i 's/mirrors.cloud.aliyuncs.com/url_tmp/g' /etc/yum.repos.d/CentOS-Base.repo && sudo sed -i 's/mirrors.aliyun.com/mirrors.cloud.aliyuncs.com/g' /etc/yum.repos.d/CentOS-Base.repo && sudo sed -i 's/url_tmp/mirrors.aliyun.com/g' /etc/yum.repos.d/CentOS-Base.repo
# 清理旧缓存并生成缓存。
sudo yum clean all && sudo yum makecache

执行完上述步骤后再尝试安装docker即可。

说明

如果您不想使用阿里提供的可用源，您可以自行注释掉原有/etc/yum.repos.d/CentOS-Base.repo中不可用的软件源地址，然后再尝试安装docker。

云服务器 ECS：安装Docker

安装Docker

Alibaba Cloud Linux 3

Alibaba Cloud Linux 2

CentOS 7.x

CentOS 8.x

Ubuntu

Debian

Fedora

Red Hat

Anolis OS

创建简单Web程序镜像

前期准备

创建镜像

常见问题

Linux ECS实例中执行dnf config-manager命令报错

Linux ECS实例中执行dnf install docker-ce命令报错

相关文档