用途:面向 SpacetimeDB 的部署、运维与生产诊断,适用 Maincloud 与自托管基础设施。
主要能力与用法: Maincloud 发布:spacetime publish my-database --server maincloud。客户端 URI 为 https://maincloud.spacetimeb.com,使用数据库名或 identity 作为 withDatabaseName/WithDatabaseName。更新已有数据库会热替换模块并执行迁移检查;涉及模式变更的部署应先阅读迁移相关文档。
自托管生产:建议以专用用户运行 SpacetimeDB,并置于反向代理之后;除非确实需要开放,否则限制 publish/admin 路由。Standalone 模式适合本地开发,但不直接支持 SSL。
日志:可用 spacetime logs <database> --follow --level info 查看,或通过面向所有者的 HTTP 日志端点获取。
PGWire:使用 SpacetimeDB auth token 作为 PostgreSQL 密码,应视为机密,避免记录到日志。
生产注意:密钥轮换若未规划身份连续性,可能使令牌失效或导致 401/403。不要为 / 配置宽泛的 Nginx 代理规则,除非确实希望公开数据库创建与管理。自托管 WebSocket 时,反向代理需为 /v1/database/<db>/subscribe 支持 Upgrade 与 Connection: Upgrade 头。
说明:应明确目标是 Maincloud、本地 standalone 还是自托管生产;除确有需要,避免混用 CLI 发布与服务器安装步骤;密钥与认证材料按敏感信息处理。参考文档涵盖 Maincloud 部署、自托管、密钥轮换、日志与 PGWire。