一、安装 Docker Desktop（必备环境）

1. Windows 系统 （windows安装包 有两个版本）

   • 架构版本查看
     1. Win + R‌ 输入 ‌cmd‌ 打开命令提示符；
     2. ‌输入命令‌：
     bash echo %PROCESSOR_ARCHITECTURE%
     3. ‌结果判断‌：
     AMD64‌ → x64 架构；
     ARM64‌ → ARM 架构。‌
   • 要求 Windows 10 2004 版本或更高（通过 winver 命令查看），并开启 WSL 2 功能
   • 下载 Docker Desktop 安装包：官网下载地址
   • 安装时勾选 “使用 WSL 2 而不是 Hyper-V”（若系统支持）
   • 报错/注意：
     • wsl --update 是安全的子系统级更新‌，‌不会升级 Windows 操作系统版本或修改核心系统文件‌‌。
     • 更新后可通过 wsl --version 验证 WSL 组件版本，如：

       # 输出示例（仅显示 WSL 相关版本）
       WSL version: 2.0.9
       Linux kernel version: 5.15.133.1
       

2. macOS 系统

   • 支持 Intel 芯片和 Apple Silicon（M1/M2），需 macOS 10.12 (Sierra) 或更新版本
   • 根据芯片类型选择对应安装包（Intel 或 Apple Silicon 版本）
   • 安装后跳过登录，直接进入配置

3. Linux 系统

   • 需安装 docker-ce 和 docker-compose-plugin（以 Ubuntu 为例）：

     sudo apt update && sudo apt install docker-ce docker-compose-plugin
     

---

二、关键配置与验证

1. 配置国内镜像加速（解决拉取镜像慢）
   修改 Docker 配置文件 daemon.json，添加以下镜像源（任选其一）：

   {"registry-mirrors": ["https://hub-mirror.c.163.com","https://mirror.baidubce.com","https://docker.nju.edu.cn"]
   }
   

   完成后重启 Docker 。

2. 验证安装是否成功
   执行命令检查版本：

   docker --version          # 输出 Docker 版本
   docker compose version    # 输出 Docker Compose 版本
   

   #powershell命令运行实例
   PS E:\yume工作文件\Aaaa-t> wsl --version
   WSL 版本: 2.5.9.0
   内核版本: 6.6.87.2-1
   WSLg 版本: 1.0.66
   MSRDC 版本: 1.2.6074
   Direct3D 版本: 1.611.1-81528511
   DXCore 版本: 10.0.26100.1-240331-1435.ge-release
   Windows: 10.0.26100.4349
   PS E:\yume工作文件\Aaaa-t> docker --version
   Docker version 28.2.2, build e6534b4
   PS E:\yume工作文件\Aaaa-t> docker compose version
   Docker Compose version v2.37.1-desktop.1
   PS E:\yume工作文件\Aaaa-t>
   

---

三、Laravel Sail 的适配要求

• PHP 版本：Sail 默认使用 PHP 8.x，可通过修改项目中的 docker-compose.yml 切换版本（例如将 context: ./docker/8.2 改为所需版本目录）。
• 数据库与扩展：MySQL、Redis 等容器已预配置，如需额外 PHP 扩展（如 Imagick），需修改 Sail 的 Dockerfile 并重建镜像。

---

四、常见问题解决

• 权限错误：在 Linux/macOS 中执行：

  sudo chown -R www-data:www-data storage bootstrap/cache
  

• 端口冲突：启动时指定端口 ./vendor/bin/sail up --port=8080 。
• 镜像拉取失败：检查镜像加速配置或切换镜像源 。

💡 提示：Windows 用户需确保 WSL 2 已启用（控制面板 → 程序 → 启用“适用于 Linux 的 Windows 子系统”和“虚拟机平台”）。

通过以上步骤完成 Docker Desktop 安装和基础配置后，即可通过 ./vendor/bin/sail up 启动 Sail 环境。