用途:提供自托管 Block Buzz 中继(基于 Nostr 的人机协作工作区)及可选 Hermes Agent 原生网关集成的可重复流程,示例统一使用占位符。
主要能力:单个 Rust 服务,包含 WebSocket 中继、REST 与 Web UI;生产依赖 Postgres、Redis、MinIO(S3)和 git 数据卷;官方生产打包在 repo 的 deploy/compose/(非根目录开发用 docker-compose.yml),镜像为 ghcr.io/block/buzz。
使用方式:将中继部署在独立工具型客户机(VM/LXC),仅向边缘代理发布中继 HTTP 端口(默认 3000),不公开 Postgres/Redis/MinIO 端口。建议使用非 root 运维账号并加入 docker 组。启动时需设置 RELAY_URL(即社区身份,须与客户端 URL 逐字节一致)、BUZZ_RELAY_PRIVATE_KEY、RELAY_OWNER_PUBKEY,并指定 BUZZ_DOMAIN、BUZZ_MEDIA_BASE_URL、BUZZ_CORS_ORIGINS 等公共 URL 变量。生成密钥:docker run --rm --entrypoint /usr/local/bin/buzz-admin ghcr.io/block/buzz:main generate-key。启动流程:git clone --depth 1 https://github.com/block/buzz.git;cd buzz/deploy/compose;cp .env.example .env;替换所有 CHANGE_ME_RANDOM;./run.sh start;curl -fsS http://127.0.0.1:3000/_liveness(期望 ok);./run.sh status。健康启动后固定镜像摘要。
成员管理与运维:默认关闭成员制,使用 ./run.sh add-member <npub-or-hex> --role member|admin、./run.sh list-members;备份参考 ./run.sh backup-hint 及 .env、owner 密钥、Postgres、MinIO、git 数据卷。
适用场景与限制:适用于自托管 Nostr 社区中继、移动端配对(需 buzz-pair-relay 边车并设置 BUZZ_PAIRING_RELAY_URL)、常驻 ACP 智能体(buzz-acp)与 Hermes 网关模式③集成。限制包括:外部边缘已终止 TLS 时勿再叠加 compose 的 Caddy;勿在边缘对中继启用 SSO(会破坏 NIP-42 认证);移动端配对 QR 仅由 Buzz Desktop 生成;buzz CLI 输出 JSON 帮助属正常,不是 GUI;不同 RELAY_URL 即视为不同社区。资料未提供具体收费、价格或性能指标。