怎么用
- 1
起服务
git clone 仓库,复制 .env.example 为 .env,运行 docker compose up -d --build --wait。访问 /healthz 返回 ok 就是起来了。
- 2
接上 HTTPS
服务只监听本机地址。对外的 HTTPS 交给 Caddy 或 Nginx,代理要支持 WebSocket,请求体上限至少 95 MiB(交接包)。
- 3
在客户端填你的地址
建团队或加入时,把「中心服务地址」填成你的服务器。
细节
三种数据库
默认 SQLite。也支持 MySQL 和 PostgreSQL,各有一份 compose 文件。换数据库不会迁移已有数据。
只能单实例
长连接的状态在进程内,不能起多个实例做负载均衡。
备份两样东西
数据库,和 yihee-data 卷里的文件(交接包存在那里)。
经过服务器的只有这些
团队的项目和 Skill 清单、成员列表、邀请码、队友和 Pal 的对话、团队定时任务的描述、记忆和简报、交接包。Git 操作和 agent 的执行不经过它。
限流
不需要登录的两个接口按来源 IP 限流:建团队默认每小时 5 次,凭邀请码加入默认每小时 30 次。
git clone https://github.com/liao-techs/yihee.git && cd yihee
cp .env.example .env
docker compose up -d --build --wait
curl -fsS http://127.0.0.1:8787/healthz
# {"ok":true}
用 MySQL 或 PostgreSQL 时,在 docker compose 后面加 -f compose.mysql.yaml 或 -f compose.postgres.yaml。反向代理、备份和限流的细节见部署文档。
常被问到的
- 没有桌面环境的机器能加入团队吗?
- 能。用 yihee 命令行:yihee onboard --code <邀请码>。它能加入团队、同步项目和 Skill。