SpaceTimeDB 安装部署指南

📥 安装 CLI

# macOS/Linux
curl -sSf https://install.spacetimedb.com | sh

# 或使用 Homebrew
brew install clockworklabs/tap/spacetimedb

# 验证安装
spacetime --version

🚀 创建项目

使用模板创建

# Rust 项目
spacetime dev --template basic-rs

# TypeScript 项目
spacetime dev --template basic-ts

# C# 项目
spacetime dev --template basic-cs

项目结构

my-spacetime-app/
├── spacetimedb/          # SpaceTimeDB 模块
│   ├── Cargo.toml
│   └── src/
│       └── lib.rs       # 服务端逻辑
├── src/
│   ├── main.rs          # 客户端应用
│   └── module_bindings/ # 自动生成的类型
└── Cargo.toml

📤 发布模块

# 登录
spacetime login

# 发布到 MainCloud
spacetime publish my-database

# 查看数据库列表
spacetime list

# 查看 SQL
spacetime sql my-database "SELECT * FROM my_table"

🏠 本地开发

# 启动本地服务器
spacetime start

# 发布到本地
spacetime publish --server local my-database

# 调用 Reducer
spacetime call my-database my_reducer arg1 arg2

🔧 自托管

SpaceTimeDB 支持自托管，在自己的服务器运行：

# 拉取镜像
docker pull ghcr.io/clockworklabs/spacetimedb:latest

# 运行
docker run -p 3000:3000 ghcr.io/clockworklabs/spacetimedb