Docker入门之安装

Docker Desktop 概述

Docker Desktop 是适用于 Mac、Linux 或 Windows 环境的一键安装应用程序，可让您构建、共享和运行容器化应用程序和微服务。

它提供了一个简单的 GUI（图形用户界面），让您可以直接从机器管理容器、应用程序和图像。

Docker Desktop 减少了花在复杂设置上的时间，因此您可以专注于编写代码。它负责端口映射、文件系统问题和其他默认设置，并定期更新错误修复和安全更新。

Docker Desktop 的主要功能是什么？

• 能够以多种语言和框架在任何云平台上容器化和共享任何应用程序。
• 快速安装和设置完整的 Docker 开发环境。
• 包括最新版本的 Kubernetes。
• 在 Windows 上，可以在 Linux 和 Windows 容器之间切换来构建应用程序。
• 通过原生 Windows Hyper-V 虚拟化实现快速可靠的性能。
• 能够通过 Windows 机器上的 WSL 2 在 Linux 上本地工作。
• 代码和数据的卷安装，包括文件更改通知和轻松访问本地主机网络上运行的容器。

在 Mac 上安装 Docker Desktop

使用 macOs 沙盒安全模型的本机应用程序，可将所有 Docker 工具传送到您的 Mac。

系统要求

搭载 Intel 芯片的 Mac	搭载 Apple 芯片的 Mac
至少 4 GB 的 RAM	至少 4 GB 的 RAM。
:	为了获得最佳体验，建议您安装 Rosetta 2。不再需要安装 Rosetta 2，但在使用 Darwin/AMD64 时，一些可选命令行工具仍然需要 Rosetta 2。请参阅 已知问题。要从命令行手动安装 Rosetta 2，请运行以下命令：

运行此命令安装 Rosetta 2

softwareupdate --install-rosetta

交互式安装

1. 从 发行说明中下载安装程序。

2. 双击Docker.dmg打开安装程序，然后将 Docker 图标拖到应用程序文件夹中。默认情况下，Docker Desktop 安装在/Applications/Docker.app。

3. 双击应用程序Docker.app文件夹以启动 Docker。

4. Docker菜单显示Docker订阅服务协议。

   以下是主要要点的总结：

   • Docker Desktop 可免费供小型企业（员工少于 250 人且年收入少于 1000 万美元）、个人使用、教育和非商业开源项目使用。
   • 否则，专业使用需要付费订阅。
   • 政府实体也需要付费订阅。
   • Docker Pro、Team 和 Business 订阅包括 Docker Desktop 的商业用途。

5. 选择"接受"继续。

   请注意，如果您不同意条款，Docker Desktop 将无法运行。您可以稍后打开 Docker Desktop 来选择接受条款。

   更多详细信息请参见 Docker Desktop 订阅服务协议。建议您同时阅读常见 问题解答。

6. 在安装窗口中，选择：

   • 使用推荐设置（需要密码）。这会让 Docker Desktop 自动设置必要的配置设置。
   • 使用高级设置 。然后，您可以在系统或用户目录中设置 Docker CLI 工具的位置，启用默认 Docker 套接字，并启用特权端口映射。 有关更多信息以及如何设置 Docker CLI 工具的位置，请参阅设置。

7. 选择"完成"。如果您已在步骤 6 中应用任何需要密码的先前配置，请输入密码以确认您的选择。

从命令行安装

Docker.dmg或发行说明下载后，在终端中运行以下命令在应用程序文件夹中安装 Docker Desktop：

sudo hdiutil attach Docker.dmg
sudo /Volumes/Docker/Docker.app/Contents/MacOS/install
sudo hdiutil detach /Volumes/Docker

默认情况下，Docker Desktop 安装在/Applications/Docker.app。由于 macOS 通常在第一次使用应用程序时执行安全检查，因此该install命令可能需要几分钟才能运行。

该install命令接受以下标志：

• --accept-license：立即接受 Docker订阅服务协议，而不是要求在应用程序首次运行时接受。
• --allowed-org=：运行应用程序时要求用户登录并成为指定 Docker Hub 组织的一部分
• --user=：在安装过程中执行一次特权配置。这样用户就无需在首次运行时授予 root 权限。有关更多信息，请参阅 特权助手权限要求。要查找用户名，请ls /Users在 CLI 中输入。
• --admin-settings：自动创建一个admin-settings.json文件，供管理员用来控制其组织内客户端计算机上的某些 Docker Desktop 设置。有关更多信息，请参阅 设置管理。
  • 必须和org一起使用--allowed-org=。
  • 例如：
  • --allowed-org= --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"
• --proxy-http-mode=：设置 HTTP 代理模式。两种模式为system（默认） 或manual。
• --override-proxy-http=：设置传出 HTTP 请求必须使用的 HTTP 代理的 URL。它必须--proxy-http-mode是manual。
• --override-proxy-https=：设置传出 HTTPS 请求必须使用的 HTTP 代理的 URL，--proxy-http-mode需要manual
• --override-proxy-exclude=<hosts/domains>：绕过主机和域的代理设置。这是一个以逗号分隔的列表。

在 Windows 上安装 Docker Desktop

系统要求

WSL 2 后端，x86_64

• WSL 版本 1.1.3.0 或更高版本。
• Windows 11 64 位：家庭版或专业版 21H2 或更高版本，或企业版或教育版 21H2 或更高版本。
• Windows 10 64 位：
  • 推荐使用 Home 或 Pro 22H2（内部版本 19045）或更高版本，或者 Enterprise 或 Education 22H2（内部版本 19045）或更高版本。
  • 最低要求是 Home 或 Pro 21H2（内部版本 19044）或更高版本，或者 Enterprise 或 Education 21H2（内部版本 19044）或更高版本。
• 在 Windows 上开启 WSL 2 功能。详细说明请参考 微软文档。
• 要在 Windows 10 或 Windows 11 上成功运行 WSL 2，需要满足以下硬件前提条件：
  • 具有二级地址转换 (SLAT) 的64 位处理器
  • 4GB 系统 RAM
  • 在 BIOS 中启用硬件虚拟化。有关更多信息，请参阅 虚拟化。

有关使用 Docker Desktop 设置 WSL 2 的更多信息，请参阅 WSL。

Hyper-V 后端，x86_64

• Windows 11 64 位：家庭版或专业版 21H2 或更高版本，或企业版或教育版 21H2 或更高版本。

• Windows 10 64 位：

  • 建议使用 Home 或 Pro 22H2（build 19045）或更高版本，或者 Enterprise 或 Education 22H2（build 19045）或更高版本。
  • 最低要求是 Home 或 Pro 21H2（内部版本 19044）或更高版本，或者 Enterprise 或 Education 21H2（内部版本 19044）或更高版本。
    打开 Hyper-V 和容器 Windows 功能。

• 要在 Windows 10 上成功运行客户端 Hyper-V，需要满足以下硬件先决条件：

  • 具有二级地址转换 (SLAT) 的64 位处理器
  • 4GB 系统 RAM
  • 在 BIOS 中启用硬件虚拟化。有关更多信息，请参阅 虚拟化。

WSL 2 后端，Arm（测试版）

• WSL 版本 1.1.3.0 或更高版本。
• Windows 11 64 位：家庭版或专业版 21H2 或更高版本，或企业版或教育版 21H2 或更高版本。
• Windows 10 64 位：
  • 建议使用 Home 或 Pro 22H2（build 19045）或更高版本，或者 Enterprise 或 Education 22H2（build 19045）或更高版本。
  • 最低要求是 Home 或 Pro 21H2（内部版本 19044）或更高版本，或者 Enterprise 或 Education 21H2（内部版本 19044）或更高版本。
• 在 Windows 上开启 WSL 2 功能。详细说明请参考 微软文档。
• 要在 Windows 10 或 Windows 11 上成功运行 WSL 2，需要满足以下硬件前提条件：
  • 具有二级地址转换 (SLAT) 的64 位处理器
  • 4GB 系统 RAM
  • 在 BIOS 中启用硬件虚拟化。有关更多信息，请参阅 虚拟化。

安装 Docker Desktop

交互式安装

1. 从 发行说明中下载安装程序。

2. 双击Docker Desktop Installer.exe运行安装程序。默认情况下，Docker Desktop 安装在C:\Program Files\Docker\Docker。

3. 出现提示时，请确保根据您选择的后端，在配置页面上选择使用 WSL 2 而不是 Hyper-V选项。

4. 如果您的系统仅支持两个选项中的一个，您将无法选择使用哪个后端。

5. 按照安装向导上的说明授权安装程序并继续安装。

6. 安装成功后，选择关闭，完成安装过程。

7. 启动 Docker Desktop。

如果您的管理员帐户与您的用户帐户不同，则必须将用户添加到docker-users组：

1. 以管理员 身份运行计算机管理。
2. 导航到本地用户和组 >组 > docker-users。
3. 右键单击以将用户添加到组。
4. 退出并重新登录以使更改生效。

从命令行安装

下载后Docker Desktop Installer.exe，在终端中运行以下命令安装 Docker Desktop：

"Docker Desktop Installer.exe" install

如果您使用 PowerShell，则应按以下方式运行它：

Start-Process 'Docker Desktop Installer.exe' -Wait install

如果使用 Windows 命令提示符：

start /w "" "Docker Desktop Installer.exe" install

默认情况下，Docker Desktop 安装在C:\Program Files\Docker\Docker。

该install命令接受以下标志：

• --quiet：运行安装程序时抑制信息输出

• --accept-license：立即接受 Docker 订阅服务协议，而不是在应用程序首次运行时要求接受

• --no-windows-containers：禁用 Windows 容器集成

• --allowed-org=：运行应用程序时要求用户登录并成为指定 Docker Hub 组织的一部分

• --backend=：选择用于 Docker Desktop 的默认后端，hyper-v或windows（wsl-2默认）

• --installation-dir= ：更改默认安装位置（C:\Program Files\Docker\Docker）

• --admin-settings：自动创建一个admin-settings.json文件，供管理员用来控制其组织内客户端计算机上的某些 Docker Desktop 设置。有关更多信息，请参阅 设置管理。

  • 必须和org一起使用--allowed-org=。
  • 例如：--allowed-org= --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"

• --proxy-http-mode=：设置 HTTP 代理模式system（默认）或manual

• --override-proxy-http=：设置传出 HTTP 请求必须使用的 HTTP 代理的 URL，--proxy-http-mode需要manual

• --override-proxy-https=：设置传出 HTTPS 请求必须使用的 HTTP 代理的 URL，--proxy-http-mode需要manual

• --override-proxy-exclude=<hosts/domains>：绕过主机和域的代理设置。使用逗号分隔的列表。

• --proxy-enable-kerberosntlm：启用 Kerberos 和 NTLM 代理身份验证。如果启用此功能，请确保您的代理服务器已正确配置为 Kerberos/NTLM 身份验证。适用于 Docker Desktop 4.32 及更高版本。

• --hyper-v-default-data-root= ：指定 Hyper-V VM 磁盘的默认位置。

• --windows-containers-default-data-root= ：指定 Windows 容器的默认位置。

• --wsl-default-data-root= ：指定 WSL 分发磁盘的默认位置。

• --always-run-service：安装完成后，启动com.docker.service并将服务启动类型设置为自动。这样就无需管理员权限，否则启动时需要管理员权限com.docker.service。com.docker.service这是 Windows 容器和 Hyper-V 后端所必需的。

如果您的管理员帐户与您的用户帐户不同，则必须将用户添加到docker-users组：

 net localgroup docker-users <user> /add

启动Docker Desktop

安装后，Docker Desktop 不会自动启动。要启动 Docker Desktop，请执行以下操作：

1. 搜索 Docker，然后在搜索结果中选择Docker Desktop 。

2. Docker 菜单（

   ）显示 Docker 订阅服务协议。

    以下是主要要点的总结：

   • Docker Desktop 可免费供小型企业（员工少于 250 人且年收入少于 1000 万美元）、个人使用、教育和非商业开源 项目使用。

   • 否则，专业使用需要付费订阅。

   • 政府实体也需要付费订阅。

   • Docker Pro、Team 和 Business 订阅包括 Docker Desktop 的商业用途。

3. 选择"接受"以继续。接受条款后，Docker Desktop 将启动。

   请注意，如果您不同意条款，Docker Desktop 将无法运行。您可以稍后打开 Docker Desktop 来选择接受条款。

   更多详细信息请参见 Docker Desktop 订阅服务协议。建议您阅读常见 问题解答。

在 Linux 上安装 Docker Desktop

支持的平台

Docker 提供.deb和.rpm以下 Linux 发行版和架构的软件包：

平台	x86_64 / amd64
Ubuntu	✅
Debian	✅
红帽企业 Linux（RHEL）	✅
Fedora	✅

一般系统要求

要成功安装 Docker Desktop，您的 Linux 主机必须满足以下常规要求：

• 64 位内核和 CPU 支持虚拟化。
• KVM 虚拟化支持。按照 KVM 虚拟化支持说明检查 KVM 内核模块是否已启用以及如何提供对 KVM 设备的访问。
• QEMU 必须是 5.2 或更高版本。我们建议升级到最新版本。
• systemd 初始化系统。
• Gnome、KDE 或 MATE 桌面环境。
  • 对于许多 Linux 发行版，Gnome 环境不支持托盘图标。要添加对托盘图标的支持，您需要安装 Gnome 扩展。例如， AppIndicator。
• 至少 4 GB 的 RAM。
• 启用在用户命名空间中配置 ID 映射，请参阅 文件共享。
• 建议： 初始化pass凭证管理。

KVM 虚拟化支持

Docker Desktop 运行需要KVM 支持的 VM 。

kvm如果主机支持虚拟化，模块将自动加载。要手动加载模块，请运行：

 modprobe kvm

根据主机的处理器，必须加载相应的模块：

 modprobe kvm_intel  # Intel processors

 modprobe kvm_amd    # AMD processors

如果上述命令失败，您可以通过运行以下命令查看诊断：

 kvm-ok

要检查 KVM 模块是否已启用，请运行：

lsmod | grep kvm
kvm_amd               167936  0
ccp                   126976  1 kvm_amd
kvm                  1089536  1 kvm_amd
irqbypass              16384  1 kvm

设置KVM设备用户权限

要检查的所有权/dev/kvm，请运行：

 ls -al /dev/kvm

将您的用户添加到 kvm 组以访问 kvm 设备：

 sudo usermod -aG kvm $USER

注销并重新登录，以便重新评估您的群组成员身份。