SuperAPI AI 工具集

buzz-self-hosting

通用与其它

查看项目

更新于 10-16 05:47

技能介绍

用途:帮助用户通过 deploy/compose/ 中的 Docker Compose 栈自建 buzz-relay,并在智能体或客户端异常时逐层排查。原则是给用户可直接粘贴的命令,由用户自行执行会改变状态的命令;只做日志、名单、查询等只读验证。

核心模型:一个 relay 即一个社区,relay URL 就是社区,按 BUZZ_DOMAIN 中的精确主机名路由,其他 Host 的 WebSocket 升级返回 404。栈包含 relay、Postgres(事件、搜索、成员)、MinIO(媒体与 git packfile)、Redis(仅 pub/sub,无持久数据)与 git 卷。关闭式 relay(设置 RELAY_OWNER_PUBKEY、BUZZ_REQUIRE_RELAY_MEMBERSHIP=true)下,人和智能体都必须在成员名单中。

主要能力与用法:cd deploy/compose && cp .env.example .env 后编辑 .env;密钥本地生成,用 openssl rand -hex 32 生成 BUZZ_RELAY_PRIVATE_KEY 和 BUZZ_GIT_HOOK_HMAC_SECRET;RELAY_OWNER_PUBKEY 为 64 位十六进制;BUZZ_RELAY_PRIVATE_KEY 只设一次、勿轮换并备份 .env;长生命周期应固定 BUZZ_IMAGE 到发布标签。运行 ./run.sh config 校验后 ./run.sh start,公网 TLS 用 BUZZ_COMPOSE_TLS=true ./run.sh start;存活检查 curl -fsS http://127.0.0.1:3000/_liveness。用 ./run.sh add-member <pubkey> 逐个添加成员并间隔 sleep 1,./run.sh list-members 验证。

限制与注意事项:本地部署勿用 localhost,应统一用 127.0.0.1,否则智能体 harness 会 404;改 BUZZ_DOMAIN 会重建空社区,需在应用中移除并重新添加社区后重建频道:宿主到自托管无导出工具,频道历史、私信、媒体、画布不会迁移;备份需导出 .env、pg_dump 及 MinIO、git 卷,.env 是备份的一部分。Windows 下 ./run.sh 为 bash,需用 Git Bash 或 bash run.sh,并注意 MSYS_NO_PATHCONV=1。其他未提供的事实暂未说明。