> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 1. 下載 Toolkit

> 在 WSL 2 的 Ubuntu 中安裝命令列相依套件，並複製 Ayakaleaf Toolkit。

**1. 安裝命令列工具**

在 **Ubuntu** 中執行，並使用您在步驟 0 建立的 Linux 密碼：

```bash theme={null}
sudo apt update
sudo apt install -y git ca-certificates curl perl gawk openssl
```

Ubuntu 本身已提供 Bash、GNU sed 與 coreutils。與 macOS 不同，它不需要 Homebrew 或另外安裝 GNU sed。

**2. 複製 Ayakaleaf Toolkit 儲存庫**

請將 Toolkit 及其資料保存在 Ubuntu 的 Linux 檔案系統中，放在您的家目錄底下：

```bash theme={null}
cd "$HOME"
git clone https://github.com/ayaka-notes/toolkit.git "$HOME/ayakaleaf-toolkit"
cd "$HOME/ayakaleaf-toolkit"
```

對於線上資料庫與專案資料，請避免使用 `/mnt/c`、`/mnt/d`、OneDrive 與暫存目錄。Linux 檔案系統路徑可提供容器所預期的權限與檔案系統行為，並避免跨檔案系統的額外負擔；請參閱 [Microsoft 的檔案系統指引](https://learn.microsoft.com/en-us/windows/wsl/filesystems)。

> [!WARNING]
>
> 若該目錄中已有安裝，請直接使用它，或為新執行個體選擇另一個目錄。請勿取代既有部署的設定或資料。

### 下一步

請繼續進行 [2. 熟悉 Toolkit](https://ayakaleaf-pro.mintlify.site/zh-TW/on-premises/installation/using-docker-compose/windows/2.-familiarize-yourself-with-the-toolkit.md)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.