spacetimedb-deploy

将此技能用于部署、运维和生产环境诊断。

核心部署模式

• 发布到 Maincloud：

spacetime publish my-database --server maincloud

• Maincloud 客户端使用 https://maincloud.spacetimedb.com 作为 URI，并将数据库名称或身份用作 withDatabaseName/WithDatabaseName。
• 更新现有数据库会热切换模块并运行迁移检查；更改架构的部署前，请先加载数据库迁移指南。
• 可自托管的生产环境应以专用用户运行 SpacetimeDB，并置于反向代理之后。除非有意开放主机，否则应限制发布和管理路由。
• 独立模式适用于本地开发；独立模式不直接支持 SSL。
• 可通过 spacetime logs <database> --follow --level info 或面向所有者的 HTTP 日志端点查看日志。
• PGWire 使用 SpacetimeDB 身份验证令牌作为 PostgreSQL 密码；请将其视为机密，避免记录到日志中。

生产环境注意事项

• 如果没有规划好身份连续性，密钥轮换可能会使令牌失效或导致 401/403 行为。
• 除非有意允许公开创建和管理数据库，否则不要为 / 配置范围过宽的 Nginx 代理规则。
• 对于可自托管的 WebSocket，反向代理必须为 /v1/database/<db>/subscribe 支持 Upgrade 和 Connection: Upgrade 标头。

参考索引

需求	打开
Maincloud 部署	references/how-to-deploy-maincloud.md
自托管	references/how-to-deploy-self-hosting.md
密钥轮换	references/how-to-self-hosted-key-rotation.md
日志记录	references/how-to-logging.md
PGWire	references/how-to-pg-wire.md

指南

• 明确说明目标是 Maincloud、本地独立模式，还是可自托管的生产环境。
• 除非用户两者都需要，否则不要混合 CLI 发布说明和服务器安装步骤。
• 将密钥轮换和身份验证材料视为敏感信息；优先说明所需配置，而不要公开具体值。