http://localhost:8080,將資料保存在 Ubuntu 的家目錄中,並啟用沙箱編譯。
應用程式、MongoDB、Redis 與 TeX Live 都在由 Docker Desktop 管理的 Linux 容器中執行。請在 Ubuntu 中執行 Toolkit 指令;在 Windows 瀏覽器中開啟應用程式。步驟 0 會說明 Windows 與 Linux 兩部分如何搭配運作,並從安裝 WSL 開始。
您可以將 Windows 用於本機執行個體,或透過步驟 6 中的可用性設定讓它持續執行。對於共用與正式環境的伺服器,我們建議使用 Linux 指南,並搭配 HTTPS、備份與存取控制。Windows 睡眠、Docker Desktop 關閉以及 WSL 關閉都會中斷此本機執行個體;請參閱保持執行個體可用。
開始之前
您需要:- Docker Desktop for Windows 所支援的 Windows 版本與處理器,並已啟用硬體虛擬化。本指南使用 x86-64 上的 Windows 11。
- 啟用 WSL 與安裝軟體的權限。WSL 必須為 2.1.5 或更新版本,且 Ubuntu 以 WSL 2 模式執行。
- 足以同時供 Windows 與容器使用的記憶體。對於小型的本機執行個體,提供給 Docker 4 個 CPU 與 8 GB 記憶體是建議的起始值,而非實際量測的最低需求。
- 存放 WSL 與 Docker 資料的 Windows 磁碟上需有可用儲存空間。完整的 TeX Live 設定加上專案資料,請預留至少 40 GB;步驟 5 中的 basic 映像檔較小,適合用於初次部署測試。額外的映像檔版本需要額外的空間。
- 可存取 GitHub、GitHub Container Registry(
ghcr.io)與 Docker Hub 的網路,以便複製 Toolkit 並下載映像檔。
bin/ 指令都在 Ubuntu 中執行。請勿在 PowerShell 或 Windows Git Bash 中執行 Toolkit 指令碼。

