部署爬山虎
爬山虎(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 应用,之后都会在这里各有一篇指南。