CentOS 系统 Docker 安装详解：解决常见问题 – wiki基地

CentOS 系统 Docker 安装详解：解决常见问题

Docker 已经成为现代软件开发和部署的基石，它提供了一种轻量级、可移植、可重复使用的方式来打包、分发和运行应用程序。CentOS 作为一款流行的 Linux 发行版，在服务器领域占据着重要的地位。本文将详细介绍如何在 CentOS 系统上安装 Docker，并重点解决安装过程中常见的各种问题，帮助读者顺利搭建 Docker 环境。

一、准备工作

在安装 Docker 之前，我们需要进行一些准备工作，确保系统满足安装要求，并避免潜在的冲突。

1. 更新系统软件包: 这是安装任何软件之前都应该养成的良好习惯，它可以确保系统软件包是最新的，并解决潜在的安全漏洞和依赖问题。

bash
sudo yum update -y

这条命令会更新所有已安装的软件包到最新版本，-y 参数表示自动确认所有升级提示。

1. 确认系统版本: Docker 对 CentOS 版本有最低要求，确认你的 CentOS 版本是否符合 Docker 的安装要求。通常，CentOS 7 及以上的版本可以安装 Docker。

bash
cat /etc/redhat-release

该命令会显示 CentOS 的版本信息，例如 CentOS Linux release 7.9.2009 (Core)。

1. 卸载旧版本 Docker (如果存在): 如果你的系统之前安装过 Docker，为了避免版本冲突，建议卸载旧版本。

bash
sudo yum remove docker \
docker-client \
docker-client-latest \
docker-common \
docker-latest \
docker-latest-logrotate \
docker-logrotate \
docker-engine

该命令会尝试卸载所有可能的旧 Docker 相关软件包。

1. 配置 Yum 源: Docker 官方提供了一个 Yum 源，我们需要配置该源以便从官方仓库下载 Docker。

bash
sudo yum install -y yum-utils
sudo yum-config-manager \
--add-repo \
https://download.docker.com/linux/centos/docker-ce.repo

第一条命令安装 yum-utils 包，该包提供了一些有用的 Yum 工具，例如 yum-config-manager。第二条命令添加 Docker 的官方 Yum 源。

问题 1：下载 Docker CE 仓库速度慢或无法访问？

解决方案： 由于地理位置的原因，从 Docker 官方仓库下载软件包可能会很慢甚至无法访问。可以考虑使用国内的镜像源，例如阿里云、清华大学等。

阿里云 Docker CE 镜像源配置方法：

创建或编辑 /etc/yum.repos.d/docker-ce.repo 文件，并添加以下内容：

“`
[docker-ce-stable]
name=Docker CE Stable – $basearch
baseurl=https://mirrors.aliyun.com/docker-ce/linux/centos/$releasever/$basearch/stable
enabled=1
gpgcheck=1
gpgkey=https://mirrors.aliyun.com/docker-ce/linux/centos/gpg

[docker-ce-stable-debuginfo]
name=Docker CE Stable Debuginfo – $basearch
baseurl=https://mirrors.aliyun.com/docker-ce/linux/centos/$releasever/debug/$basearch/stable
enabled=0
gpgcheck=1
gpgkey=https://mirrors.aliyun.com/docker-ce/linux/centos/gpg

[docker-ce-test]
name=Docker CE Test – $basearch
baseurl=https://mirrors.aliyun.com/docker-ce/linux/centos/$releasever/$basearch/test
enabled=0
gpgcheck=1
gpgkey=https://mirrors.aliyun.com/docker-ce/linux/centos/gpg

[docker-ce-test-debuginfo]
name=Docker CE Test Debuginfo – $basearch
baseurl=https://mirrors.aliyun.com/docker-ce/linux/centos/$releasever/debug/$basearch/test
enabled=0
gpgcheck=1
gpgkey=https://mirrors.aliyun.com/docker-ce/linux/centos/gpg

[docker-ce-edge]
name=Docker CE Edge – $basearch
baseurl=https://mirrors.aliyun.com/docker-ce/linux/centos/$releasever/$basearch/edge
enabled=0
gpgcheck=1
gpgkey=https://mirrors.aliyun.com/docker-ce/linux/centos/gpg

[docker-ce-edge-debuginfo]
name=Docker CE Edge Debuginfo – $basearch
baseurl=https://mirrors.aliyun.com/docker-ce/linux/centos/$releasever/debug/$basearch/edge
enabled=0
gpgcheck=1
gpgkey=https://mirrors.aliyun.com/docker-ce/linux/centos/gpg
“`

然后，清除 Yum 缓存并重新生成缓存：

bash
sudo yum clean all
sudo yum makecache fast

二、安装 Docker

完成准备工作后，就可以开始安装 Docker 了。

1. 安装 Docker Engine: 使用 Yum 安装 Docker Engine、CLI、containerd.io 和 Docker Compose。

bash
sudo yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin

这条命令会安装 Docker Engine、CLI (命令行界面)、containerd.io (容器运行时) 和 Docker Compose 插件。

问题 2：安装过程中出现依赖关系错误？

解决方案： 这通常是因为系统缺少某些依赖软件包。可以尝试运行以下命令来解决依赖关系问题：

bash
sudo yum install -y yum-utils
sudo yum deplist docker-ce

yum deplist 命令会列出 docker-ce 包的所有依赖项。然后，使用 yum install 命令手动安装缺少的依赖项。 如果依赖冲突依然存在，尝试更新系统后再执行安装步骤。

1. 启动 Docker 服务: 安装完成后，需要启动 Docker 服务。

bash
sudo systemctl start docker

1. 设置 Docker 开机自启动: 为了避免每次重启系统后都需要手动启动 Docker 服务，可以设置 Docker 开机自启动。

bash
sudo systemctl enable docker

1. 验证 Docker 安装: 运行一个简单的 Docker 镜像来验证 Docker 是否安装成功。

bash
sudo docker run hello-world

这条命令会下载 hello-world 镜像并在容器中运行。如果一切正常，你会看到一条欢迎消息。

三、配置 Docker

安装完成后，我们可以对 Docker 进行一些配置，以优化其性能和安全性。

1. 配置 Docker 用户权限: 默认情况下，只有 root 用户才能运行 Docker 命令。为了方便使用，可以将普通用户添加到 docker 用户组。

bash
sudo usermod -aG docker $USER
newgrp docker

第一条命令将当前用户添加到 docker 用户组。第二条命令更新用户组信息，使更改生效。

问题 3：即使将用户添加到 docker 用户组，仍然需要 sudo 才能运行 Docker 命令？

解决方案： 这通常是因为用户组信息没有正确更新。可以尝试注销并重新登录，或者重启系统，以使更改生效。

1. 配置 Docker 镜像加速器: 为了提高 Docker 镜像的下载速度，可以配置 Docker 镜像加速器。

阿里云镜像加速器配置方法：

登录阿里云控制台，找到容器镜像服务，在镜像加速器页面找到你的专属加速器地址。然后，创建或编辑 /etc/docker/daemon.json 文件，并添加以下内容：

json
{
"registry-mirrors": ["你的阿里云镜像加速器地址"]
}

替换 你的阿里云镜像加速器地址 为你自己的加速器地址。

然后，重启 Docker 服务：

bash
sudo systemctl restart docker

1. 配置 Docker 数据存储目录: 默认情况下，Docker 镜像和容器数据存储在 /var/lib/docker 目录下。如果磁盘空间不足，可以将其移动到其他目录。

2. 停止 Docker 服务：

   bash
sudo systemctl stop docker

3. 复制数据目录：

   bash
sudo cp -r /var/lib/docker /new/path/to/docker/data

   将 /var/lib/docker 目录下的所有内容复制到新的数据存储目录 /new/path/to/docker/data。请确保新的目录具有正确的权限。

4. 修改 Docker 配置文件：

   修改 /etc/docker/daemon.json 文件，添加或修改 data-root 选项：

   json
{
"data-root": "/new/path/to/docker/data"
}

5. 启动 Docker 服务：

   bash
sudo systemctl start docker

注意： 在移动数据目录之前，请务必备份数据，以防数据丢失。

1. 配置 Docker 日志: 默认情况下，Docker 日志存储在 /var/lib/docker/containers 目录下。可以配置 Docker 使用其他日志驱动程序，例如 json-file、syslog 等。

修改 /etc/docker/daemon.json 文件，添加或修改 log-driver 选项：

json
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}

log-driver 指定日志驱动程序，log-opts 指定日志选项，例如最大日志文件大小和最大日志文件数量。

然后，重启 Docker 服务：

bash
sudo systemctl restart docker

四、常见问题及解决方案

除了上述提到的问题之外，在安装和使用 Docker 的过程中，还可能会遇到其他一些常见问题。

1. 问题 4：Docker 容器无法连接到外部网络？

解决方案： 这通常是因为防火墙阻止了容器的网络连接。可以添加防火墙规则，允许容器访问外部网络。

bash
sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
sudo firewall-cmd --zone=public --add-port=443/tcp --permanent
sudo firewall-cmd --reload

这些命令会添加防火墙规则，允许 HTTP 和 HTTPS 流量通过防火墙。你可以根据需要添加其他端口的规则。

1. 问题 5：Docker 容器端口映射不生效？

解决方案： 这可能是因为以下原因：

• 端口已被占用： 确保要映射的端口没有被其他应用程序占用。
• 防火墙阻止了端口映射： 检查防火墙规则，确保允许容器访问外部网络。

• 容器内部应用程序没有监听正确的端口： 确保容器内部的应用程序监听了容器映射的端口。

• 问题 6：Docker 容器无法访问宿主机？

解决方案： Docker 容器可以通过 host.docker.internal 主机名访问宿主机。如果容器无法访问宿主机，可以尝试以下方法：

• 检查 DNS 设置： 确保容器的 DNS 设置正确。

• 添加宿主机 IP 地址到容器的 /etc/hosts 文件： 在容器的 /etc/hosts 文件中添加一行，将 host.docker.internal 主机名映射到宿主机的 IP 地址。

• 问题 7：Docker 镜像构建失败？

解决方案： Docker 镜像构建失败的原因有很多，常见的包括：

• Dockerfile 语法错误： 检查 Dockerfile 文件是否存在语法错误。
• 依赖文件缺失： 确保 Dockerfile 中指定的所有依赖文件都存在。
• 网络连接问题： 如果 Dockerfile 中需要下载文件，确保网络连接正常。
• 权限问题： 确保 Dockerfile 中执行的命令具有足够的权限。

五、总结

本文详细介绍了在 CentOS 系统上安装 Docker 的步骤，并针对安装过程中常见的各种问题提供了相应的解决方案。希望通过本文的介绍，读者能够顺利搭建 Docker 环境，并能够解决在使用过程中遇到的各种问题。 Docker 的安装和配置是一个持续学习的过程，建议读者参考官方文档和社区资源，不断学习和探索，以便更好地利用 Docker 提高软件开发和部署效率。 最后，良好的习惯，例如定期更新系统、备份数据，可以避免很多潜在的问题，让你的 Docker 环境更加稳定可靠。