> ## 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.

# 5. 個人化您的執行個體

> 設定連接埠、網站 URL 與 TeX Live 映像檔，啟用沙箱編譯，並在 WSL 2 上啟動 Ayakaleaf Pro。

請在 **Ubuntu** 中，從 `~/ayakaleaf-toolkit` 執行指令並編輯檔案。

**1. 容器設定**

編輯 `config/overleaf.rc` 中的既有項目：

```bash title="config/overleaf.rc" theme={null}
PROJECT_NAME=ayakaleaf-wsl
SERVER_PRO=true
OVERLEAF_LISTEN_IP=127.0.0.1
OVERLEAF_PORT=8080
SIBLING_CONTAINERS_ENABLED=true
DOCKER_SOCKET_PATH=/var/run/docker.sock
```

請保留預設的資料路徑，以及內建的 MongoDB 與 Redis 服務。連接埠 `8080` 供本機的 Windows 瀏覽器使用；綁定至 `127.0.0.1` 可讓它只限本機存取。沙箱編譯會為每次編譯使用一個獨立的 Linux 容器，而不是在應用程式容器內執行 TeX。Docker socket 讓應用程式能建立這些容器，而 Toolkit 會提供 `data/overleaf/data/compiles` 底下編譯資料的主機路徑。

**2. 應用程式設定**

在 `config/variables.env` 中設定以下值，並取代任何同名的已啟用項目：

```dotenv title="config/variables.env" theme={null}
OVERLEAF_SITE_URL=http://localhost:8080
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-full:2026.1
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-full:2026.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES="TeX Live 2026"
```

full 映像檔包含各類專案所需的套件與字型。請為它與應用程式預留至少 40 GB 的可用儲存空間，另外再加上專案資料與未來更新所需的空間。

若要快速進行部署測試，請改用較小的 **basic** 映像檔。它足以應付步驟 6 中的簡單 article 測試，但不包含完整的套件與字型集合：

```dotenv theme={null}
TEX_LIVE_DOCKER_IMAGE=ghcr.io/ayaka-notes/texlive-basic:2026.1
ALL_TEX_LIVE_DOCKER_IMAGES=ghcr.io/ayaka-notes/texlive-basic:2026.1
ALL_TEX_LIVE_DOCKER_IMAGE_NAMES="TeX Live 2026 Basic"
```

請從這兩組中擇一使用，不要有重複的已啟用鍵值。basic 映像檔的 [Dockerfile](https://github.com/ayaka-notes/texlive-full/blob/main/texlive/2026/Dockerfile.basic) 包含 `latexmk`、XeTeX 與 `fontspec`，但不包含 `ctex` 或完整的字型集合。在 basic 中缺少某個 LaTeX 套件，本身並不代表沙箱有問題。

產生一個 session 機密：

```bash theme={null}
openssl rand -hex 32
```

將結果以 `OVERLEAF_SESSION_SECRET` 加入 `config/variables.env`。也請保留產生的邀請權杖機密。對於不使用電子郵件的本機執行個體，請保持 SMTP 設定與 `OVERLEAF_EMAIL_FROM_ADDRESS` 未設定。

**3. 啟動您的執行個體**

```bash theme={null}
bin/up -d
```

Toolkit 會啟動 MongoDB、初始化其複本集、下載所選的 TeX Live 映像檔，然後啟動 Redis 與應用程式。下載大型映像檔時，看起來可能會暫停一段時間。在第一個 `bin/up` 仍在執行時，請勿執行第二個 `bin/up`。

在另一個 Ubuntu 終端機中檢查：

```bash theme={null}
cd "$HOME/ayakaleaf-toolkit"
bin/docker-compose ps
bin/docker-compose logs --tail=100 mongo
bin/docker-compose logs --tail=100 -f sharelatex
```

按下 `Ctrl+C` 即可停止追蹤記錄；以分離模式執行的容器會繼續執行。若啟動在 MongoDB 處失敗，請在重試之前依照 [MongoDB 無法啟動](https://ayakaleaf-pro.mintlify.site/zh-TW/on-premises/installation/using-docker-compose/windows/troubleshooting.md#mongodb-fails-to-start)操作。請勿為了重設既有安裝而刪除其資料目錄。

檢查連接埠與首次執行頁面：

```bash theme={null}
bin/docker-compose port sharelatex 80
curl -I http://localhost:8080/launchpad
```

連接埠應為 `127.0.0.1:8080`。若 HTTP 請求一開始失敗，請等待應用程式初始化完成。

**4. 從 Windows 開啟執行個體**

在您的 **Windows 瀏覽器**中開啟 [http://localhost:8080/launchpad](http://localhost:8080/launchpad)。在 Windows 中也請使用這個位址，而不是暫時性的 WSL IP 位址。

若要在瀏覽器之外另行檢查 Windows 的 HTTP 存取，請在 **PowerShell** 中執行：

```powershell theme={null}
curl.exe -I http://localhost:8080/launchpad
```

若 Ubuntu 可以連上頁面但 Windows 不行，請參閱 [Windows 無法開啟 localhost](https://ayakaleaf-pro.mintlify.site/zh-TW/on-premises/installation/using-docker-compose/windows/troubleshooting.md#windows-cannot-open-localhost)。

### 下一步

請繼續進行 [6. 安裝後工作](https://ayakaleaf-pro.mintlify.site/zh-TW/on-premises/installation/using-docker-compose/windows/6.-post-installation-tasks.md)，以建立管理員並驗證沙箱編譯與資料持久性。


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