6. 安裝後工作

​

建立您的第一個管理員帳號

開啟 OVERLEAF_SITE_URL 加上 /launchpad，例如 http://192.0.2.10:30080/launchpad，並依照 Toolkit 的安裝後工作註冊管理員帳號。接著建立一個範例專案並編譯。

您也可以從命令列建立使用者：

kubectl -n overleaf exec deploy/overleaf -- bash -c \
  'cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user.mjs --admin --email=[e-mail]'

它會輸出一個用於設定密碼的連結。

​

確認編譯已在沙箱中執行

編譯一個專案，然後查看執行該 Pod 的節點：

kubectl -n overleaf get pod -l app=overleaf -o wide   # NODE column
# on that node:
sudo docker ps -a --filter ancestor=ghcr.io/ayaka-notes/texlive-full:2026.1
ls -ln /srv/overleaf/compiles                          # owned by uid 33 (www-data)

每次編譯都會顯示為一個名為 project-<project id>-<user id>-... 的短期容器。

​

日誌與 Shell

Toolkit	Kubernetes
bin/logs web	kubectl -n overleaf exec deploy/overleaf -- tail -f /var/log/overleaf/web.log
bin/shell	kubectl -n overleaf exec -it deploy/overleaf -- bash
bin/up	kubectl apply -f . 然後執行 kubectl -n overleaf rollout restart deployment/overleaf

容器會在 /var/log/overleaf/ 中為每個服務寫入一個日誌檔案（web.log、clsi.log、real-time.log、document-updater.log……）；kubectl logs 則顯示啟動輸出。

​

Q&A

編譯失敗或一直無法完成。

回答：請在執行該 Pod 的節點上確認 Docker 正在執行，且擁有 TEX_LIVE_DOCKER_IMAGE 中指定的映像檔，並確認 SANDBOXED_COMPILES_HOST_DIR_* 與 hostPath 路徑相符。Pod 中的 /var/log/overleaf/clsi.log 會指出失敗的步驟。

每次重新啟動 Pod 後，使用者都會被登出。

回答：Secret overleaf-secrets 中缺少 OVERLEAF_SESSION_SECRET，請參閱步驟 2。