0. 設定 Docker Desktop

在 Mac 上安裝 Docker Desktop，並檢查引擎、資源、檔案共用與 Docker socket。

Ayakaleaf Pro 在 Docker 上執行。在 Mac 上您會使用 Docker Desktop，它會在 Linux 虛擬機器中執行 Docker 引擎。

1. 安裝並啟動 Docker Desktop

   安裝適用於您 Mac（Apple silicon 或 Intel）的 Docker Desktop 版本，開啟它，並等待引擎啟動完成。您也可以從終端機啟動它：

   open -a Docker
   
2. 檢查 Docker 引擎

   在終端機中執行以下指令：

   docker context show
   docker info
   docker compose version
   

   context 應指向您本機的 Docker Desktop 引擎，通常是 desktop-linux。若選取的是其他 context，請先切換到 Docker Desktop 再繼續：

   docker context use desktop-linux
   

   docker info 必須印出 Server 區段。單獨執行 docker --version 只能顯示用戶端已安裝。

3. 檢查資源與檔案共用

   在 Docker Desktop 的 Settings 中，對照開始之前檢查 CPU、記憶體與磁碟限制，並檢查檔案共用設定，請參閱 Docker Desktop 設定。

   本指南將 Toolkit 放在 /Users 底下，Docker Desktop 預設會共用此目錄。若您使用其他位置，且 bin/up 失敗並顯示 Mounts denied，請將該目錄加入檔案共用。

4. 檢查沙箱編譯所需的 Docker socket

   Toolkit 會將 /var/run/docker.sock 掛載到應用程式中，讓它能為每次編譯啟動一個獨立的 TeX Live 容器。請在 config/overleaf.rc 中保留 DOCKER_SOCKET_PATH=/var/run/docker.sock。

   macOS 上的 Docker CLI 可能會透過 ~/.docker/run/docker.sock 連線。那是 Mac 上的用戶端端點，並不是變更 Toolkit 掛載來源的理由：編譯器需要的是 Linux 容器所看到的引擎 socket。

   若 Mac 上沒有 /var/run/docker.sock，請在 Settings → Advanced 中開啟 Allow the default Docker socket to be used，請參閱 Docker 的權限需求。

   請勿對 socket 執行 chmod 777 來規避錯誤。存取 Docker socket 等同於擁有 Docker VM 的 root 權限。

​

下一步

docker info 能正常運作後，請繼續進行 1. 下載 Toolkit。