企业官网建设流程全解析

1. 项目概述：为什么你装不上 Docker Desktop，不是手速问题，而是系统在“装睡”

Docker Desktop 是 Windows 和 macOS 用户接触容器技术最平滑的入口——它把 Linux 内核级的 namespace、cgroup、overlayfs 这些底层黑科技，封装成一个带图形界面的托盘图标。但现实很骨感：超过 65% 的新手第一次安装后卡在“Starting Docker Engine…”、报错virtualization support not detected、或者启动后提示failed to connect to the docker api at npipe://./pipe/dockerdesktoplinuxen。这不是你电脑不行，而是 Docker Desktop 在 Windows 上根本不是“直接运行”，它是一套精密的三层嵌套系统：Windows 主机 → WSL 2 虚拟机 → Linux 容器运行时。任何一层没对齐，整个链路就断了。

我过去三年帮超过 200 位开发、测试、运维同事排查过 Docker Desktop 启动失败问题，发现 92% 的故障根源不在 Docker 本身，而在 WSL 2 的初始化状态、BIOS 中虚拟化开关的物理状态、以及 Windows 功能模块的启用顺序。比如很多人以为开了“Windows Subsystem for Linux”就万事大吉，却不知道 WSL 1 和 WSL 2 是完全不同的内核机制；又比如在 BIOS 里关了 Intel VT-x 或 AMD-V，哪怕 Windows 系统显示“已启用虚拟化”，Docker Desktop 依然会报virtualization support not detected——因为它是直接读取 CPU 的硬件标志位，不是查 Windows 注册表。

这篇教程不讲“点下一步→完成”的流水线操作，而是带你像修车师傅一样，拆开 Docker Desktop 的外壳，看清 WSL 2 如何接管 Linux 内核、镜像如何从远程仓库落到本地磁盘、国内网络下哪些环节会卡住、以及为什么改个镜像存储路径能省下 30GB C 盘空间。你会真正理解：Docker Desktop 不是一个软件，而是一套跨操作系统边界的运行时基础设施。适合所有刚接触容器、被报错劝退、或想搞懂“为什么我的 Redis 容器连不上宿主机 MySQL”的 Windows 开发者。不需要 Linux 基础，但需要你愿意花 20 分钟打开 BIOS 设置界面。

2. 核心设计逻辑：Docker Desktop 在 Windows 上为何必须依赖 WSL 2？

2.1 为什么不能像 Linux 那样直接跑 Docker Engine？

Linux 发行版（如 Ubuntu）上安装 Docker，本质是安装dockerd进程，它直接调用 Linux 内核的容器原语（clone() 系统调用 + cgroup v1/v2 + overlay2 存储驱动）。但 Windows 没有这些内核能力。早期 Docker for Windows 曾用 Hyper-V 虚拟机跑一个轻量 Linux VM（叫 MobyLinuxVM），所有容器都在这个 VM 里运行。这种方式的问题很明显：每次启动要加载完整 Linux 内核、内存占用高（默认 2GB）、文件共享慢（通过 SMB 共享 C 盘目录）、网络调试复杂（容器 IP 是 10.0.75.x 段，和宿主机不在同一网段）。

WSL 2 的出现彻底改变了游戏规则。它不是传统虚拟机，而是微软基于 Hyper-V 技术栈重构的轻量级虚拟化层，核心突破在于：它把 Linux 内核直接编译进一个精简的 initramfs 镜像里，在启动时由 Windows 内核加载并运行，而不是启动一个完整的 Linux 发行版。这意味着：

• 启动时间从秒级降到毫秒级（实测首次启动 WSL 2 Ubuntu 约 800ms，MobyLinuxVM 需 4~6 秒）；
• 内存按需分配（空闲时可压缩到 50MB 以下，不像 VM 固定占 2GB）；
• 文件 I/O 性能接近原生（WSL 2 使用 9P 协议替代 SMB，吞吐提升 3~5 倍）；
• 网络与宿主机共享同一网卡（容器 IP 默认在 172.17.0.x 段，可直接 ping 通宿主机 127.0.0.1）。

Docker Desktop 正是深度集成了 WSL 2：它不再自己维护一个 Linux VM，而是把dockerd进程直接部署在 WSL 2 的 Linux 内核环境中，自身只保留一个 Windows GUI 前端和 API 代理层。所以当你看到 Docker Desktop 托盘图标变绿，实际是 WSL 2 的 Ubuntu 实例已经 running，且dockerd已在其中监听/var/run/docker.sock。

提示：你可以随时验证这一点。打开 PowerShell，执行wsl -l -v，你会看到类似输出：

NAME STATE VERSION * Ubuntu-22.04 Running 2

如果 VERSION 显示为 1，说明你还在用旧版 WSL 1，必须升级，否则 Docker Desktop 无法启动。

2.2 WSL 2 的三个关键组件及其协作关系

Docker Desktop 的稳定运行，依赖 WSL 2 三大组件的精确协同：

1. WSL 2 内核（wsl.exe 加载的 kernel）
   这是微软官方发布的 Linux 内核二进制（wsl2kernel），默认位于C:\Windows\System32\lxss\tools\wsl2kernel。它不是源码编译，而是微软针对 WSL 2 场景定制裁剪的内核（禁用大量硬件驱动，强化 overlayfs 和 cgroup 支持）。Docker Desktop 安装时会自动下载最新版（目前为 5.15.x），但如果你手动更新过内核或使用企业版 Windows，可能因签名验证失败导致启动异常。

2. WSL 2 发行版（如 Ubuntu-22.04）
   这是你从 Microsoft Store 下载的 rootfs 镜像（.appx包），解压后形成/mnt/wsl/instances/Ubuntu-22.04目录。Docker Desktop 并不修改这个发行版，而是通过wsl --import方式创建一个专用实例（默认名docker-desktop-data），专门存放 Docker 镜像、容器层、卷数据。这是关键：你的个人 Ubuntu 环境和 Docker 的运行环境是物理隔离的两个 WSL 2 实例。很多人误以为在 Ubuntu 终端里sudo apt install docker.io就能替代 Docker Desktop，这是错误的——那个docker.io是 Debian 官方包，和 Docker Desktop 的dockerd互不兼容。

3. Docker Desktop 的 Windows 服务层（com.docker.service）
   这是运行在 Windows 用户态的后台进程，负责三件事：

   • 监听npipe:////./pipe/dockerdesktoplinuxen这个命名管道，将 Windows 应用（如 VS Code 的 Dev Containers 插件、Docker CLI）的请求转发给 WSL 2 中的dockerd；
   • 管理 WSL 2 实例的启停（当 Docker Desktop 关闭时，自动wsl --terminate docker-desktop-data）；
   • 提供 GUI 设置界面，将用户配置（如镜像加速地址、资源限制）写入 WSL 2 实例的/etc/docker/daemon.json。

这三层的关系，就像一家餐厅：WSL 2 内核是厨房的地基和排烟系统（硬件支撑），WSL 2 发行版是厨师和灶台（运行环境），Docker Desktop 服务是服务员兼主厨（调度+烹饪），而你敲的docker run hello-world就是顾客点的菜。

2.3 为什么国内用户必须配置镜像加速？原理是什么？

Docker Hub 官方镜像仓库（https://registry-1.docker.io）的服务器位于美国，中国用户直连会遇到两个硬伤：

• DNS 污染与解析延迟：国内运营商对registry-1.docker.io的 DNS 解析常返回错误 IP 或超时，导致docker pull卡在 “Waiting for download”；
• TCP 连接不稳定：即使解析成功，三次握手后 TLS 握手阶段常因中间链路丢包失败，报错net/http: request canceled while waiting for connection。

镜像加速的本质，是让 Docker 客户端把原本发往registry-1.docker.io的请求，重定向到国内镜像站（如阿里云https://<your-id>.mirror.aliyuncs.com）的反向代理服务器。这个代理服务器在国外有高速专线，它先拉取原始镜像，缓存到国内 CDN 节点，再响应你的请求。整个过程对用户透明，只需在 Docker 配置中加一行：

{ "registry-mirrors": ["https://<your-id>.mirror.aliyuncs.com"] }

但要注意：镜像加速只加速pull操作，不加速push。你推送到自己的私有仓库（如 Harbor）或 Docker Hub，依然走原始链路。另外，加速地址必须是 HTTPS 协议，且证书有效——很多用户填错格式（如漏掉https://或写成http://）导致 Docker Desktop 启动失败，日志里会报invalid registry mirror URL。

我实测过主流加速源的平均拉取速度（以nginx:alpine镜像为例，约 5MB）：

阿里云最快，但必须去 阿里云容器镜像服务控制台 免费开通，并复制专属加速地址（形如https://xxxxxx.mirror.aliyuncs.com）。其他源虽免注册，但高峰期可能限速。

3. 完整安装与配置实操：从 BIOS 设置到第一个容器运行

3.1 前置检查：四步确认硬件与系统基础

别急着下载安装包，先做这四件事，能避开 80% 的后续故障：

第一步：确认 CPU 虚拟化已物理开启
这是最常被忽略的环节。Windows 系统信息里显示的“虚拟化已启用”只是软件层反馈，实际需进入 BIOS/UEFI 设置。不同品牌进入方式不同：

• Dell：开机按 F2
• HP：开机按 F10
• Lenovo：开机按 F1 或 F2
• ASUS：开机按 Del

进入后，找到Advanced → CPU Configuration（或Security → Virtualization），确保以下选项为Enabled：

• Intel VT-x（Intel CPU） 或 AMD-V（AMD CPU）
• Intel VT-d（Intel） 或 AMD IOMMU（AMD）——此项非必须，但开启后 WSL 2 USB 设备支持更好

注意：某些笔记本（如部分 ThinkPad）的 BIOS 里，虚拟化选项被藏在Security → Security Chip下，需先禁用 TPM 2.0 才能解锁。实测过一台 T14 Gen 2，关掉 TPM 后 VT-x 选项才出现。

第二步：启用 Windows 功能模块
以管理员身份运行 PowerShell，逐条执行（每条执行完会提示重启，不要跳过）：

# 启用 WSL 2 功能（自动包含虚拟机平台） dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

执行完后，必须重启电脑。重启后，再执行：

# 将 WSL 2 设为默认版本（关键！） wsl --set-default-version 2

如果报错Invalid argument，说明未重启或 BIOS 虚拟化未开，回退第一步。

第三步：安装 WSL 2 内核更新包
访问 Microsoft WSL 2 内核更新页面 ，下载wsl_update_x64.msi并安装。这是独立于 Windows Update 的内核补丁，新版 Docker Desktop 强制要求内核版本 ≥ 5.10.60.1。安装后无需重启，但需关闭所有 WSL 终端窗口。

第四步：检查 Windows 版本与更新
Docker Desktop 要求 Windows 10 2004（Build 19041）或 Windows 11。在 PowerShell 中运行：

winver

如果版本过低（如 Win10 1809），必须升级系统。注意：某些企业版 Windows 被策略禁用了 Windows Update，需联系 IT 部门解除。

完成这四步后，你的系统才真正准备好迎接 Docker Desktop。此时wsl -l -v应显示VERSION 2，且无报错。

3.2 下载与安装 Docker Desktop：选对版本，少踩三天坑

Docker Desktop 官网（https://www.docker.com/products/docker-desktop）提供 Windows 和 macOS 版本。Windows 用户务必注意：

• 只下载.exe安装包，不要下载.zip
.zip是便携版，需手动配置环境变量和注册服务，新手极易出错。.exe是标准安装程序，自动处理服务注册、快捷方式、系统托盘集成。

• 版本选择：优先选 Stable，慎用 Edge
  Stable 版经过充分测试，适配主流 Windows 补丁；Edge 版虽新（如 4.20.1），但常有 WSL 2 兼容性问题（如 4.19.0 在 Win11 22H2 上偶发dockerd崩溃）。截至 2023 年底，推荐 Stable 版本为4.18.0（发布于 2023-03-21）。

• 安装路径：强烈建议保持默认C:\Program Files\Docker\Docker
  自定义路径可能导致 WSL 2 实例权限异常（尤其路径含中文或空格）。曾有用户装到D:\Docker Desktop，结果docker run报permission denied on /var/run/docker.sock，重装后恢复默认路径即解决。

安装过程实测步骤：

1. 双击.exe，等待“Preparing Docker Desktop”进度条（约 15 秒）；
2. 出现许可协议，勾选“I accept...”，点击 Next；
3. 选择组件：务必勾选 “Install required Windows components for WSL 2”（此选项会自动运行wsl --install，安装 Ubuntu 发行版）；
4. 点击 Install，等待 2~3 分钟（期间会自动重启 WSL 2 服务）；
5. 安装完成，勾选 “Start Docker Desktop when you log in”，点击 Close。

安装后，系统托盘会出现鲸鱼图标，右下角弹出“Docker Desktop is starting...”。此时不要操作，等待图标变绿（通常需 40~90 秒）。如果超过 2 分钟仍是灰色，进入下一节排查。

3.3 首次启动配置：镜像加速、存储路径、资源限制三件套

Docker Desktop 启动后，右键托盘图标 → Settings，进入设置界面。重点配置三项：

① 镜像加速（Registry Mirrors）
路径：Docker Engine → Daemon → Registry mirrors
点击+号，粘贴你申请的阿里云加速地址（如https://xxxxxx.mirror.aliyuncs.com）。切勿添加多个地址——Docker 客户端会按顺序尝试，第一个失败就卡住，导致启动超时。填完后点击Apply & Restart，Docker Desktop 会自动重启dockerd。

提示：如何验证加速生效？启动后打开 PowerShell，执行：

docker info | findstr "Registry Mirrors"

应输出Registry Mirrors: https://xxxxxx.mirror.aliyuncs.com。如果为空，说明配置未生效，检查 JSON 格式是否多逗号或引号不匹配。

② 镜像与容器存储路径（关键！释放 C 盘空间）
默认情况下，Docker Desktop 将所有镜像、容器层、卷数据存放在C:\Users\<user>\AppData\Local\Docker\wsl\data\ext4.vhdx。这是一个动态扩展的虚拟硬盘文件，初始 1GB，但随着你拉取mysql:8.0（1.2GB）、redis:7-alpine（45MB）、node:18（1.1GB）等镜像，它会暴涨到 20GB+，严重挤压 C 盘。

修改方法（必须在 Docker Desktop 关闭状态下操作）：

1. 关闭 Docker Desktop（右键托盘 → Quit Docker Desktop）；
2. 打开 PowerShell，执行：

   # 导出当前 docker-desktop-data 实例 wsl --export docker-desktop-data "D:\docker-desktop-data.tar" # 注销原实例（此操作删除 C 盘 ext4.vhdx） wsl --unregister docker-desktop-data # 创建新实例，指定 D 盘路径 wsl --import docker-desktop-data "D:\docker-desktop-data" "D:\docker-desktop-data.tar" --version 2 # 清理临时 tar 文件 Remove-Item "D:\docker-desktop-data.tar"

3. 重新启动 Docker Desktop，它会自动识别新路径。

实测效果：某台 512GB SSD 笔记本，C 盘原剩 12GB，迁移后释放出 18.3GB。注意：目标盘（如 D 盘）必须是 NTFS 格式，且有足够剩余空间（建议预留 50GB 以上）。

③ 资源限制（CPU、内存、磁盘镜像）
路径：Resources → WSL Integration

• CPU：默认 2 核，建议设为物理核心数的 50%（如 8 核 CPU 设 4 核），避免抢夺前台应用资源；
• Memory：默认 2GB，但运行mysql+redis+nginx三容器时明显不足，建议调至4GB；
• Disk image size：默认 60GB，但这是虚拟硬盘上限，实际占用由镜像决定。建议设为120GB，防止后续拉取大型镜像（如tensorflow/tensorflow:latest4.2GB）时写满。

注意：修改后需点击右下角Apply & Restart，否则不生效。重启后可在 WSL 2 终端中验证：

# 进入 docker-desktop-data 实例 wsl -d docker-desktop-data # 查看内存限制 cat /sys/fs/cgroup/memory.max # 查看磁盘空间 df -h /

3.4 验证与首个容器：从 hello-world 到真实项目

配置完成后，打开 PowerShell 或 Git Bash，执行：

docker --version # 输出应为 Docker version 24.0.x, build xxxxx docker run hello-world

如果看到绿色文字输出Hello from Docker!，说明 Docker Engine 已正常工作。

但真正的验证，是运行一个有实际意义的容器。我们以 Redis 为例，演示从拉取、运行、连接到验证的全流程：

步骤 1：拉取 Redis 镜像（验证镜像加速）

# 观察下载速度，应远快于直连 Docker Hub docker pull redis:7-alpine

步骤 2：运行 Redis 容器（验证网络与端口映射）

# -d 后台运行，--name 指定容器名，-p 6379:6379 映射宿主机 6379 端口到容器 docker run -d --name my-redis -p 6379:6379 redis:7-alpine

步骤 3：验证容器状态与日志

# 查看运行中容器 docker ps # 应显示 CONTAINER ID、IMAGE、STATUS（Up X seconds）、PORTS（0.0.0.0:6379->6379/tcp） # 查看 Redis 启动日志 docker logs my-redis # 应看到 "Ready to accept connections" 字样

步骤 4：从宿主机连接 Redis（验证网络互通）
在 Windows 上安装 Redis CLI（如 Redis Desktop Manager 或命令行工具）：

# 使用 redis-cli 连接（假设已安装） redis-cli -h 127.0.0.1 -p 6379 # 进入后执行 127.0.0.1:6379> set test "hello docker" OK 127.0.0.1:6379> get test "hello docker"

如果成功，恭喜你，Docker Desktop 已成为你开发环境的可靠基石。此时你可以安全地进行下一步：部署青龙面板（whyour/qinglong）、运行 MySQL 8.0（mysql:8.0）、或用docker-compose.yml编排多容器应用。

4. 常见故障排查与避坑指南：那些官方文档不会告诉你的细节

4.1 启动失败：virtualization support not detected的七种真实原因

这个报错看似简单，实则覆盖从硬件到软件的七层故障面。我整理了真实案例中的高频原因及对应解法：

最隐蔽的案例：一台戴尔 Precision 5860 工作站，BIOS 中 VT-x 明确 Enabled，systeminfo显示 Hyper-V 已启用，但 Docker Desktop 仍报此错。最终发现是 BIOS 中Trusted Platform Module (TPM)设置为Enabled，而 TPM 2.0 与 VT-x 存在硬件级冲突。将其改为Disabled后，问题解决。

4.2 连接失败：failed to connect to the docker api at npipe://./pipe/dockerdesktoplinuxen

这个错误表明 Docker Desktop 的 Windows 服务层（com.docker.service）未正常运行，或与 WSL 2 的通信管道中断。常见场景：

• 场景一：Docker Desktop 进程僵死
  托盘图标灰色，但任务管理器中Docker Desktop.exe进程存在。
  解法：任务管理器 → 结束Docker Desktop.exe进程 → 右键托盘图标 → Restart Docker Desktop。

• 场景二：WSL 2 实例损坏
  wsl -l -v显示docker-desktop-data状态为Stopped，但wsl -d docker-desktop-data无法进入，报错The parameter is incorrect。
  解法：这是 ext4.vhdx 文件系统损坏。执行：

  # 备份原数据（可选） wsl --export docker-desktop-data "C:\backup\docker-data.tar" # 彻底注销并重建 wsl --unregister docker-desktop-data # 重启 Docker Desktop，它会自动创建新实例

• 场景三：命名管道被占用
  其他程序（如旧版 Docker Toolbox）占用了npipe:////./pipe/dockerdesktoplinuxen。
  解法：执行netstat -abno \| findstr "dockerdesktop"，找到 PID，用任务管理器结束对应进程。

提示：Docker Desktop 日志是终极排查工具。日志路径为%LOCALAPPDATA%\Docker\log\dockerd.log。用 VS Code 打开，搜索关键词error、panic、failed，通常能定位到具体失败模块（如wslstore、vmcompute）。

4.3 网络不通：容器无法访问宿主机服务（如 MySQL、Redis）

这是新手最困惑的问题：我在宿主机127.0.0.1:3306运行着 MySQL，但容器内ping 127.0.0.1能通，telnet 127.0.0.1 3306却拒绝连接。

根本原因：Docker 容器的127.0.0.1指向容器自身，不是宿主机。WSL 2 为宿主机分配了一个固定 IP192.168.49.1（可通过cat /etc/resolv.conf在 WSL 2 终端中查看 nameserver 得知），但这个 IP 在容器内不可达，因为容器网络是独立的 bridge 网络。

正确解法有三种：

1. 使用宿主机网关 IP（推荐）
   在容器内，宿主机的 IP 是host.docker.internal（Docker Desktop 自动注入的 DNS 名）。连接 MySQL 时，用：

   mysql -h host.docker.internal -P 3306 -u root -p

2. 绑定宿主机 IP 到特定端口
   启动容器时，用--add-host参数手动添加宿主机 IP：

   # 先查宿主机在 WSL 2 中的 IP（在 PowerShell 中执行） ipconfig \| findstr "vEthernet (WSL)" # 输出类似：IPv4 Address. . . . . . . . . . . : 172.28.128.1 # 启动容器时添加 docker run --add-host=host.docker.internal:172.28.128.1 ...

3. 改用 host 网络模式（仅限 Linux 容器）
   docker run --network host ...，此时容器共享宿主机网络命名空间，127.0.0.1即宿主机。但 Windows 容器不支持此模式。

注意：MySQL 默认绑定127.0.0.1，需修改my.cnf中bind-address = 0.0.0.0并重启，否则外部无法连接。

4.4 汉化与增强：ASXEZ/dockerdesktop-cn 的安全使用指南

社区项目ASXEZ/dockerdesktop-cn提供了 Docker Desktop 中文界面，但需谨慎使用：

• 安全性：该项目是 GitHub 开源，代码可审计，但安装脚本会修改 Docker Desktop 的 Electron 应用资源文件（resources/app.asar）。若从非官方渠道下载，存在注入恶意代码风险。
• 兼容性：仅适配特定版本（如 4.18.0），升级 Docker Desktop 后汉化失效，需等待作者更新。
• 安装方式（安全做法）：
  1. 从 ASXEZ/dockerdesktop-cn Release 页面 下载对应版本的.zip；
  2. 解压后，用asar工具（npm install -g asar）解包resources/app.asar；
  3. 替换locales/zh-CN.pak文件；
  4. 重新打包asar pack app app.asar；
  5. 备份原app.asar，替换新文件。

更稳妥的替代方案：使用浏览器访问http://localhost:9000（Docker Desktop 内置的 Portainer 替代品），它原生支持中文，且无需修改核心文件。

5. 进阶技巧与生产就绪建议：让 Docker Desktop 成为你开发流的核心引擎

5.1 用 Docker Compose 管理多容器应用：从单点到编排

docker run适合单容器测试，但真实项目常需 MySQL + Redis + Nginx + 应用服务四者联动。Docker Compose 用 YAML 文件定义服务依赖，一键启停。

以部署青龙面板（whyour/qinglong）为例，创建docker-compose.yml：

version: '3.8' services: qinglong: image: whyour/qinglong:latest container_name: qinglong restart: unless-stopped environment: - PUID=1000 - PGID=1000 - TZ=Asia/Shanghai volumes: - ./qinglong/config:/ql/config - ./qinglong/log:/ql/log - ./qinglong/db:/ql/db - ./qinglong/scripts:/ql/scripts - ./qinglong/jobs:/ql/jobs ports: - "5700:5700" # 关键：让青龙能访问宿主机的 Docker API（用于拉取镜像） volumes: - /var/run/docker.sock:/var/run/docker.sock

执行docker-compose up -d，Docker Desktop 会自动创建网络、拉取镜像、启动容器。相比手动docker run，优势在于：

• 依赖自动解析：depends_on可定义启动顺序（如 MySQL 先于应用启动）；
• 配置集中管理：环境变量、卷挂载、端口映射全部声明式定义，杜绝docker run命令过长难以维护；
• 资源隔离：每个docker-compose.yml创建独立网络，服务间用服务名通信（如qinglong容器内curl http://mysql:3306即可访问 MySQL 容器）。

提示：Docker Desktop 内置 Compose v2，无需额外安装。在设置中General → Use the new Docker Compose V2必须勾选，否则docker-compose命令不可用。

5.2 持久化数据：为什么docker volume比-v绑定挂载更可靠？

新手常用-v /path/on/host:/path/in/container挂载宿主机目录，但这有两大隐患：

• 权限冲突：宿主机目录属主为Administrator，容器内进程（如 MySQL）以mysql用户运行，写入失败；
• 路径依赖：/path/on/host是绝对路径，换一台电脑路径不存在，docker-compose up报错。

docker volume是 Docker 管理的抽象存储，由 WSL 2 内部维护，完全解耦宿主机路径：

# 创建命名卷 docker volume create qinglong-db # 在 compose 中引用 volumes: qinglong-db: driver: local

Docker Desktop 会自动将卷数据存放在\\wsl$\docker-desktop-data\version-pack-data\community\docker\volumes\下，你无需关心具体路径。更重要的是，docker volume支持备份：

# 备份卷到 tar 文件 docker run --rm -v qinglong-db:/volume -v $(pwd):/backup alpine tar cvf /backup/qinglong-db.tar -C /volume . # 恢复 docker run --rm -v qinglong-db:/volume -v $(pwd):/backup alpine tar xvf /backup/qinglong-db.tar -C /volume

5.3 性能调优：让 Docker Desktop 在 8GB 内存笔记本上流畅运行

很多开发者抱怨 Docker Desktop 卡顿，其实 8GB 内存完全够用，关键在调优：

• 关闭未用功能：Settings → General → 取消勾选 “Start Docker Desktop when you log in”，改为需要时手动启动；
• 限制 WSL 2 内存：在C:\Users\<user>\.wslconfig