部署爬山虎
爬山虎(BostonIvy)是可以自行託管的開源任務管理工具:Agent 幫你起草任務和專案計畫,人來檢視、修改,始終由人做主。這些指南帶你從一台空機器走到一個執行中的伺服器。
要部署什麼
一套部署由三個部分組成:
| 組成 | 作用 |
|---|---|
| PostgreSQL | 儲存所有資料:帳號、專案、任務、留言 |
| 爬山虎伺服器 | API 和背景工作在同一個程序裡。啟動時會自動遷移資料庫 |
| BostonIvy Web | 網頁版。內建的 Caddy 提供頁面,並把 /api、/mcp、/llms.txt、OAuth 端點和健康檢查轉送給伺服器,所以瀏覽器只需要連到一個網址 |
選擇部署方式
| 方式 | 適合 | 指南 |
|---|---|---|
| Docker Compose | 一台機器:試用、家庭、小團隊 | 用 Docker Compose 部署 |
| Kubernetes 和 Helm | 叢集、多副本、託管資料庫 | 用 Helm 部署到 Kubernetes |
需要準備什麼
- 一台裝了 Docker 和 Docker Compose v2 的機器,或一個裝好 Helm 的 Kubernetes 叢集。
- 一個能讀取爬山虎套件的 GitHub 帳號。映像檔是 GitHub Container Registry(
ghcr.io)上的私有套件。 - 正式使用時:一個指向這台機器的網域,才能透過 HTTPS 提供服務。
更多指南
用 OpenID Connect 帳號登入、透過 CalDAV 同步行事曆、郵件,以及連接網頁版、macOS 和 Android 應用程式,之後都會在這裡各有一篇指南。