您现在的位置是: 网站首页> 精品案例 安装 Docker 和 Docker Compose 的步骤及问题解决

安装 Docker 和 Docker Compose 的步骤及问题解决

若谷 若谷 2025-10-22 635 人已围观 【演示URL:】

简介安装 Docker 和 Docker Compose 的步骤及问题解决;Linux 是 Docker 最常用的环境,推荐使用官方仓库安装,确保版本最新且稳定。

1. 卸载旧版本(如有)

首先清理可能存在的旧版本 Docker,避免冲突:



# Ubuntu/Debian sudo apt-get remove docker docker-engine docker.io containerd runc # CentOS/RHEL sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine

2. 安装 Docker Engine(核心组件)

方法:通过官方仓库安装(推荐)
Ubuntu 系统:

# 1. 更新 apt 包索引,并安装依赖 sudo apt-get update sudo apt-get install ca-certificates curl gnupg lsb-release

# 2. 添加 Docker 官方 GPG 密钥 curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# 3. 设置 Docker 稳定版仓库 echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null # 4. 安装 Docker Engine sudo apt-get update sudo apt-get install docker-ce docker-ce-cli containerd.io

CentOS 系统:

# 1. 安装依赖            sudo yum install -y yum-utils device-mapper-persistent-data lvm2

# 2. 设置 Docker 仓库            sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

# 3. 安装 Docker Engine            sudo yum install docker-ce docker-ce-cli containerd.io

3. 启动 Docker 并设置开机自启

# 启动 Docker 服务 sudo systemctl start docker

# 设置开机自启 sudo systemctl enable docker

# 验证 Docker 是否启动成功(显示 active (running) 即为正常) sudo systemctl status docker

4. 配置非 root 用户使用 Docker(可选,推荐)

默认情况下,只有 root 或 sudo 用户能使用 Docker 命令。为避免每次输入sudo,可将当前用户加入docker组:

# 创建 docker 组(若已存在则忽略) sudo groupadd docker

# 将当前用户加入 docker 组 sudo usermod -aG docker $USER # 重启会话(或注销再登录),使配置生效生效后,直接输入docker --version测试是否无需 sudo 即可运行。

5. 安装 Docker Compose

Docker Compose 用于管理多容器应用(通过docker-compose.yml配置)。Docker 20.10.3+ 版本已集成 Compose 为内置命令(docker compose),若你的 Docker 版本较新,可跳过单独安装;若未集成,按以下步骤安装:
方法 1:安装 Compose 插件(推荐)

# Ubuntu/Debian 

sudo apt-get update sudo apt-get install docker-compose-plugin

# CentOS/RHEL

 sudo yum install docker-compose-plugin

方法 2:手动下载二进制文件(适用于所有 Linux)

# 下载最新版 Compose(查看最新版本:https://github.com/docker/compose/releases) sudo curl -L "https://github.com/docker/compose/releases/download/v2.23.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 赋予执行权限 sudo chmod +x /usr/local/bin/docker-compose

# 创建软链接到系统 PATH sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

二、Windows 系统

Windows 推荐使用Docker Desktop(集成 Docker Engine、Compose、图形界面等),需满足以下条件:
  • Windows 10 64 位:专业版、企业版或教育版(支持 Hyper-V),或家庭版(需启用 WSL 2)。
  • Windows 11:所有版本均支持 WSL 2。

安装步骤:

  1. 启用 WSL 2(Windows 家庭版必须,专业版推荐):以管理员身份打开 PowerShell,运行:
wsl --install
  1. 完成后重启电脑(会自动安装 Ubuntu 子系统和 WSL 2 内核)。
  2. 下载 Docker Desktop:访问Docker 官网下载 Windows 版本安装包。
  3. 安装 Docker Desktop:双击安装包,勾选「Use WSL 2 instead of Hyper-V」(推荐),按提示完成安装,重启电脑。
  4. 启动 Docker:从开始菜单打开 Docker Desktop,首次启动可能需要几分钟(初始化环境)。状态栏显示鲸鱼图标且无错误,即为启动成功。

三、macOS 系统

macOS 同样推荐Docker Desktop,支持 Intel 芯片和 Apple Silicon(M 系列芯片)。

安装步骤:

  1. 下载 Docker Desktop:访问Docker 官网,根据芯片类型(Intel 或 Apple Silicon)下载对应安装包(.dmg 文件)。
  2. 安装 Docker Desktop:打开 .dmg 文件,将 Docker 拖入 Applications 文件夹,然后从启动台打开 Docker。
  3. 验证启动:首次启动会提示权限申请,输入密码确认。状态栏显示鲸鱼图标,即为启动成功。

四、验证安装是否成功

安装完成后,通过以下命令验证 Docker 和 Docker Compose 是否正常工作:
  1. 验证 Docker 版本:
docker --version # 输出示例:Docker version 24.0.6, build ed223bc2.验证 Docker Compose 版本:
# 若为内置命令(Docker 20.10.3+) docker compose version # 若为单独安装的 docker-compose docker-compose --version # 输出示例:Docker Compose version v2.23.33.运行测试容器(验证 Docker 功能):
docker run hello-world若输出「Hello from Docker!」等信息,说明 Docker 正常工作。

常见问题解决

  • Linux 权限错误:若提示「permission denied」,确保用户已加入docker组并重启会话。
  • Windows 启动失败:检查 WSL 2 是否启用(wsl --status确认),或尝试重置 Docker Desktop(设置 → Reset)。
  • macOS 芯片兼容:Apple Silicon 需下载对应版本,若启动崩溃,检查系统版本是否符合要求(macOS 11+)。
安装完成后,即可通过docker和docker compose命令管理容器和多容器应用了。


相关文章

  • 初始化Linux数据盘(parted),开机自动挂载磁盘分区 初始化Linux数据盘(parted),开机自动挂载磁盘分区 MBR支持的磁盘最大容量为2 TB,GPT最大支持的磁盘容量为18 EB,因此当您初始化容量大于2 TB的磁盘时,分区形式请采用GPT。对于Linux操作系统而言,当磁盘分区形式选用GPT时,fdisk分区工具将无法使用,需要采用parted工具。 文章阅读
  • Linux常用的shell命令汇总 Linux常用的shell命令汇总 Linux系统下常用的系统级命令,包括软硬件查看、修改命令,有CPU、内存、硬盘、网络、系统管理等命令。 文章阅读
  • Linux系统通过ssh访问另一台内网服务器 Linux系统通过ssh访问另一台内网服务器 Linux系统通过ssh访问另一台内网服务器 文章阅读
  • 系统内存不足(out of memory),导致程序初始化失败、资源分配异常,进而引发一系列连锁错误(如连接中断) 系统内存不足(out of memory),导致程序初始化失败、资源分配异常,进而引发一系列连锁错误(如连接中断) 系统内存不足(out of memory),导致程序初始化失败、资源分配异常,进而引发一系列连锁错误(如连接中断)。问题剖析及解决方案(不同的Linux系统有差异,大家谨慎操作。) 文章阅读
  • 初始化容量大于2TB的Linux数据盘,开机自动挂载磁盘分区 初始化容量大于2TB的Linux数据盘,开机自动挂载磁盘分区 初始化容量大于2TB的Linux数据盘,开机自动挂载磁盘分区;介绍了初始化容量大于2TB的Linux数据盘(parted)的操作场景、前提条件、划分分区并挂载磁盘、设置开机自动挂载磁盘分区。 文章阅读
  • 初始化Linux数据盘(fdisk)并 设置开机自动挂载磁盘分区 初始化Linux数据盘(fdisk)并 设置开机自动挂载磁盘分区 初始化Linux数据盘(fdisk)并 设置开机自动挂载磁盘分区 文章阅读

站点信息

程序员(若谷)的博客 微信公众号

售前客服:

售前客服微信

微信

售前客服微信
售前客服微信

微信

售前客服微信

售后客服:

售后客服微信

微信

售后客服微信