文档首页> 常见问题> 如何在 Linux 系统上安装和配置 Docker?

如何在 Linux 系统上安装和配置 Docker?

发布时间:2025-11-26 08:01       

如何在 Linux 系统上安装和配置 Docker:详细指南

Docker 是一种流行的容器化平台,允许开发者打包、分发和运行应用程序。在 Linux 系统上安装和配置 Docker 是一个常见需求,因为它能简化部署过程,提高效率。本文将提供一个全面的分步指南,帮助您在常见的 Linux 发行版上安装和配置 Docker,包括 Ubuntu、CentOS 和 Debian。我们将覆盖安装前的准备工作、安装步骤、基本配置以及常见问题解决。无论您是初学者还是经验丰富的系统管理员,这篇文章都将提供实用信息,确保您能顺利上手。

安装前的准备工作

在开始安装 Docker 之前,确保您的 Linux 系统满足基本要求。首先,检查您的系统版本:对于 Ubuntu,推荐使用 18.04 或更高版本;CentOS 需要 7 或 8 版本;Debian 则建议使用 10 或更新版本。其次,确保您的系统已安装并更新到最新软件包。使用以下命令更新系统包管理器:

  • 对于 Ubuntu/Debian:sudo apt update && sudo apt upgrade
  • 对于 CentOS:sudo yum updatesudo dnf update(取决于版本)

此外,确认您的用户账户拥有 sudo 权限,以便执行管理员命令。如果需要,您可以添加用户到 sudo 组:sudo usermod -aG sudo username(替换 username 为您的用户名)。最后,卸载任何旧版本的 Docker(如果存在),以避免冲突。使用命令 sudo apt remove docker docker-engine docker.io(Ubuntu/Debian)或 sudo yum remove docker(CentOS)。

安装 Docker

Docker 的安装过程因 Linux 发行版而异。以下是针对常见发行版的详细步骤。

在 Ubuntu 上安装 Docker

Ubuntu 是最常见的 Linux 发行版之一,安装 Docker 相对简单。首先,添加 Docker 的官方 GPG 密钥和仓库:

  1. 更新包索引:sudo apt update
  2. 安装依赖包:sudo apt install apt-transport-https ca-certificates curl software-properties-common
  3. 添加 Docker 的 GPG 密钥:curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
  4. 添加 Docker 仓库:sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

然后,安装 Docker 引擎:

  1. 更新包列表:sudo apt update
  2. 安装 Docker:sudo apt install docker-ce
  3. 启动 Docker 服务:sudo systemctl start docker
  4. 启用 Docker 开机自启:sudo systemctl enable docker

验证安装:运行 sudo docker --version,如果显示版本号,则安装成功。

在 CentOS 上安装 Docker

CentOS 用户可以使用 yum 或 dnf 包管理器安装 Docker。首先,确保系统已更新:sudo yum update。然后,添加 Docker 仓库:

  1. 安装 yum-utils:sudo yum install -y yum-utils
  2. 添加 Docker 仓库:sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

接下来,安装 Docker:

  1. 安装 Docker 引擎:sudo yum install docker-ce docker-ce-cli containerd.io
  2. 启动并启用 Docker:sudo systemctl start dockersudo systemctl enable docker

验证安装:运行 sudo docker --version 检查版本。

在 Debian 上安装 Docker

Debian 的安装过程类似于 Ubuntu。首先,更新系统:sudo apt update && sudo apt upgrade。然后,添加 Docker 仓库:

  1. 安装依赖:sudo apt install apt-transport-https ca-certificates curl gnupg lsb-release
  2. 添加 GPG 密钥:curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
  3. 添加仓库:echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

安装 Docker:

  1. 更新包列表:sudo apt update
  2. 安装 Docker:sudo apt install docker-ce docker-ce-cli containerd.io
  3. 启动并启用服务:sudo systemctl start dockersudo systemctl enable docker

验证:运行 sudo docker --version

配置 Docker

安装完成后,配置 Docker 以提高安全性和易用性。首先,将用户添加到 docker 组,以避免每次使用 sudo:

  1. 创建 docker 组(如果不存在):sudo groupadd docker
  2. 添加用户到组:sudo usermod -aG docker $USER
  3. 重新登录或运行 newgrp docker 以应用更改

然后,配置 Docker 守护进程。编辑配置文件 /etc/docker/daemon.json(如果不存在,则创建它):

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

这设置了日志轮转,防止日志文件过大。重新启动 Docker 服务:sudo systemctl restart docker

此外,考虑配置 Docker 以使用代理(如果需要)。在 /etc/systemd/system/docker.service.d/http-proxy.conf 中添加:

[Service]
Environment="HTTP_PROXY=http://proxy.example.com:8080"
Environment="HTTPS_PROXY=https://proxy.example.com:8080"

重新加载并重启:sudo systemctl daemon-reload && sudo systemctl restart docker

测试 Docker 安装

为了确保 Docker 正常工作,运行一个测试容器。例如,拉取并运行一个 Hello World 镜像:

  1. 拉取镜像:docker pull hello-world
  2. 运行容器:docker run hello-world

如果输出显示 "Hello from Docker!",则表示安装和配置成功。您还可以尝试运行其他镜像,如 Nginx:docker run -d -p 80:80 nginx,然后在浏览器中访问 http://localhost 查看结果。

常见问题和故障排除

在安装和配置过程中,可能会遇到一些问题。以下是一些常见问题及其解决方案:

  • 权限错误:如果运行 Docker 命令时出现权限被拒绝,确保用户已添加到 docker 组,并重新登录。
  • 服务启动失败:检查 Docker 服务状态:sudo systemctl status docker。如果失败,查看日志:sudo journalctl -u docker
  • 网络问题:如果无法拉取镜像,检查网络连接或配置代理。
  • 存储空间不足:Docker 镜像和容器可能占用大量空间。使用 docker system prune 清理未使用的资源。

如果问题持续,参考 Docker 官方文档或社区论坛获取更多帮助。

总结

通过本指南,您应该能够在 Linux 系统上成功安装和配置 Docker。我们从准备工作开始,覆盖了 Ubuntu、CentOS 和 Debian 的安装步骤,并提供了配置建议和故障排除技巧。Docker 的强大功能可以帮助您简化应用程序的部署和管理。如果您是新手,建议多练习基本命令,如 docker psdocker imagesdocker rm。随着经验的积累,您将能更高效地利用 Docker 容器化技术。记住,定期更新 Docker 和系统,以保持安全性和稳定性。希望这篇文章对您有所帮助,祝您在 Linux 上使用 Docker 顺利!