不想用我们的服务器?一条命令自己起

客户端默认连接 us.yihee.ai。不想用它,可以自己起一个服务端,然后在建团队或加入时填你的地址。服务端以 MIT 协议开源。

怎么用

  1. 1

    起服务

    git clone 仓库,复制 .env.example 为 .env,运行 docker compose up -d --build --wait。访问 /healthz 返回 ok 就是起来了。

  2. 2

    接上 HTTPS

    服务只监听本机地址。对外的 HTTPS 交给 Caddy 或 Nginx,代理要支持 WebSocket,请求体上限至少 95 MiB(交接包)。

  3. 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。