系列文章

《FastAPI零基础入门与进阶实战》https://blog.csdn.net/sen_shan/category_12950843.html

第25篇:部署https://blog.csdn.net/sen_shan/article/details/153831810

文章目录

目录

系列文章

文章目录

前言

环境检查与准备

系统版本要求

确认计算机架构

BIOS 启用虚拟化

安装 WSL 2（推荐后端）

一键安装 WSL 及 Linux 发行版

设定预设版本为 WSL 2

验证安装

Ubuntu安装

下载与安装 Docker Desktop

下载安装档

执行安装

重启后验证

---

前言

        Windows系统下Docker的安装与配置流程。文章首先强调环境检查要点：确认系统版本、计算机架构（AMD64/ARM64）并启用BIOS虚拟化功能。重点讲解了WSL2的安装方法，包括一键安装命令、版本设置及Ubuntu发行版的配置。在Docker安装部分，提供了两种方案：标准安装和自定义路径安装（推荐），后者可避免C盘空间不足问题。最后通过运行hello-world镜像验证安装成功。全文为FastAPI项目部署提供了清晰的Docker环境搭建指南。

环境检查与准备

安装前请确保系统符合以下要求，避免后续执行错误：

系统版本要求

1. Windows 10：版本 22H2（Build 19045）或更新版本。
2. Windows 11：所有版本均支援。
3. 存储器：至少 4GB（建议 8GB 以上）。

确认计算机架构

• Docker 安装档分为 AMD64（主流）与 ARM64（少见）。大多数计算机皆为 AMD64。
• 检查方式：按 Win + R，输入 msinfo32。
• 查看「系统类型」：
• x64-based PC → 下载 AMD64 版本。
• ARM64-based PC → 下载 ARM64 版本。

BIOS 启用虚拟化

• 重开机进入 BIOS/UEFI 设定，找到 Virtualization Technology、Intel VT-x 或 AMD-V 选项，设定为 Enabled。若未开启，Docker 无法运作。

• 安装 WSL 2（推荐后端）

• Docker Desktop 在 Windows 上效能最好的后端是 WSL 2（Windows Subsystem for Linux）。请以「系统管理员身分」开启 PowerShell 执行以下指令：

  一键安装 WSL 及 Linux 发行版

  输入以下指令并按下 Enter，系统会自动安装 WSL、Linux 核心更新套件，并预设安装 Ubuntu。x 或 AMD-V 选项，设定为 Enabled。若未开启，Docker 无法运作。

• wsl --install

  设定预设版本为 WSL 2

• 安装完成后，重开机。再次开启「系统管理员 PowerShell」，执行：选项，设定为 Enabled。若未开启，Docker 无法运作。

• wsl --set-default-version 2

  验证安装

  输入 wsl -l -v，确认你的 Linux 发行版（如 Ubuntu）版本显示为 2

•   NAME      STATE           VERSION
  * Ubuntu    Running         2

• 若出现如下信息，请安装Ubuntu

• 适用于 Linux 的 Windows 子系统没有已安装的分发。
  可通过安装包含以下说明的分发来解决此问题：

  使用“wsl.exe --list --online' ”列出可用的分发
  和 “wsl.exe --install <Distro>” 进行安装。

• 这个提示说明：WSL 2 的核心组件（内核）你已经安装成功了，但是Linux 发行版（比如 Ubuntu）还没有安装。

  现在只需要一步操作即可解决：

Ubuntu安装

请在当前的 PowerShell 窗口中，直接输入以下命令并回车：

wsl --install -d Ubuntu

解释：

• -d 代表 distribution（发行版）。
• Ubuntu 是最常用且兼容性最好的版本。

🔄 接下来的流程

1. 等待下载：系统会自动从微软应用商店后台下载 Ubuntu 镜像。
2. 自动启动：下载完成后，它会自动弹出一个黑色窗口进行初始化设置。
3. 设置账号密码：
   • 它会提示你输入 Enter new UNIX username: -> 输入一个用户名（你的名字，不要用中文与第一个字符非数字），回车。
   • 提示 Enter new UNIX password: -> 输入密码。注意：输入密码时屏幕上不会显示任何字符（星星也没有），这是正常的 Linux 安全机制，输完直接回车。
   • 再次确认密码，回车。
4. 安装成功：看到 Installation successful! 字样，就代表 WSL 完全装好了。

🏁 最后验证

安装完成后，回到 PowerShell，再次输入你刚才的命令：

wsl -l -v

能看到类似这样的输出，且 VERSION 列显示为 2：

  NAME      STATE           VERSION
* Ubuntu    Running         2

(注：* 号表示这是默认发行版)

一旦看到这个结果，可以去安装 Docker Desktop 了，它会自动检测到这个 WSL 2 环境。

下载与安装 Docker Desktop

下载安装档

官方管道（推荐）：前往 Docker 官网https://www.docker.com/，点击 "Download for Windows"。

微软商店：也可直接在 Microsoft Store 搜寻 "Docker Desktop" 进行安装。

执行安装

方案1：直接安装【建议使用方案2】

• 双击下载好的 Docker Desktop Installer.exe。
• 在安装精灵中，勾选「Use WSL 2 instead of Hyper-V」（预设通常已勾选）。
• 完成安装后，系统会提示重开机，请点击「Restart Now」。

方案2：指定路径安装

• 把Docker Desktop Installer.exe拷贝到根目录，例如：E:\Docker Desktop Installer.exe
• 以管理员身份打开 PowerShell

• & "E:\Docker Desktop Installer.exe" install -accept-license --installation-dir="D:\Program Files\Docker" --wsl-default-data-root="D:\DockerData\wsl"

  命令参数解释：

• & "E:\..."：指定你安装包的具体位置。
• install：执行安装模式。
• -accept-license：自动同意许可协议，无需手动点击。
• --installation-dir="D:\Program Files\Docker"：将 程序文件 安装到 D 盘。
  • 注意：如果 D:\Program Files 文件夹不存在，安装程序通常会自动创建，或者你可以先手动新建这个文件夹。
• --wsl-default-data-root="D:\DockerData\wsl"：将 镜像、容器数据 (WSL 后端) 存储到 D 盘。
  • 这步非常重要，因为 Docker 的镜像非常占空间，默认在 C 盘，移到 D 盘可以防止 C 盘爆满。

重启后验证

• 重启电脑后，打开 Docker Desktop。

• 进入 Settings (设置) -> Resources (资源) -> WSL Integration。

• 进入 Settings (设置) ->Docker Engine (引擎) ->Apply

  {
    "builder": {
      "gc": {
        "defaultKeepStorage": "20GB",
        "enabled": true
      }
    },
    "experimental": false,
    "registry-mirrors": [
      "https://docker.m.daocloud.io",
      "https://huecker.io",
      "https://dockerhub.timeweb.cloud",
      "https://noohub.ru"
    ]
  }

• 使用wsl -l -v查看，确保你的 Ubuntu 开关是开启的。
• 打开终端输入 docker run hello-world 测试。