一、安裝 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 環境。