简介SpacetimeDB 是由 Clockwork Labs 开发的一款开源关系型数据库系统它彻底颠覆了传统的“客户端-服务器-数据库”三层架构。它将数据库与服务器功能合二为一允许开发者将应用程序逻辑称为“模块”直接上传并运行在数据库引擎内部。客户端可以直接连接到数据库调用模块中的函数Reducer并实时订阅数据变更。这种架构消除了中间层旨在为多人游戏、实时协作工具等场景提供极致的低延迟和高吞吐量。主要功能一体化架构将业务逻辑与数据存储融合无需部署独立的 Web 服务器或游戏服务器客户端直连数据库。实时数据同步内置发布/订阅机制当数据库中的数据发生变更时变更事件会立即推送给所有订阅该数据的客户端无需轮询。多语言模块支持支持使用 Rust、C# 和 TypeScript 编写服务器端模块业务逻辑编译为 WebAssembly 在引擎中执行。ACID 事务与持久化提供完整的关系型数据库事务特性数据在内存中处理以保证速度同时通过预写日志WAL持久化到磁盘。内置身份认证集成 GitHub OAuth 等机制进行用户身份管理模块中可以基于身份进行细粒度的权限控制。热重载开发通过spacetime dev命令提供交互式开发环境支持代码修改后自动重建、重发布模块。安装与配置安装 CLI 工具通过官方脚本安装命令行工具这是管理 SpacetimeDB 实例和模块的主要方式。macOS / Linux:curl -sSf https://install.spacetimedb.com | shWindows (PowerShell):iwr https://windows.spacetimedb.com -useb | iex启动本地服务器安装后启动一个本地 SpacetimeDB 实例默认监听 3000 端口spacetime start身份认证用于发布如需将模块发布到云端Maincloud或管理身份需登录spacetime login该命令会打开浏览器引导你通过 GitHub 账号完成 OAuth 认证。如何使用SpacetimeDB 的开发流程围绕“模块Module”展开一个模块定义了数据表Table和业务函数Reducer。创建项目使用模板快速初始化。例如创建一个 TypeScript 聊天应用模板spacetime dev --template chat-react-ts my-chat-app定义 Schema在模块代码中定义数据表结构。例如定义一个Message表包含发送者、文本和发送时间。编写 Reducer编写处理客户端请求的函数。例如send_messageReducer 接收文本参数验证权限后插入一条新消息到Message表。发布模块将编写好的模块编译并发布到运行的 SpacetimeDB 实例中spacetime publish客户端连接在客户端应用如 React、Unity中使用 SpacetimeDB SDK 连接到数据库地址调用 Reducer 发送数据并订阅表的变化以更新 UI。应用场景实例实例 1大型多人在线游戏MMORPG后端场景开发像《BitCraft Online》这样的沙盒 MMORPG需要处理数千名玩家的位置同步、物品交易、世界状态变更。SpacetimeDB 方案将整个游戏世界状态存储在 SpacetimeDB 的表中如Player、Item、Terrain。玩家移动时客户端调用move_toReducer数据库更新玩家坐标并立即将新坐标广播给周围的所有玩家客户端。由于逻辑在数据库内执行避免了传统架构中游戏服务器与数据库之间的网络往返延迟实现了毫秒级的同步。实例 2实时协作文档编辑器场景构建类似 Google Docs 的实时协作工具多个用户同时编辑一份文档。SpacetimeDB 方案定义Document表和Operation表。当用户输入字符时客户端调用insert_textReducerSpacetimeDB 在事务中处理冲突合并然后将合并后的文档状态实时推送给所有正在浏览该文档的用户。利用其强一致性保证所有用户看到的内容最终都是一致的。实例 3物联网IoT数据看板场景监控数百个传感器的实时数据并在仪表盘上展示。SpacetimeDB 方案传感器设备作为客户端直接连接 SpacetimeDB调用report_metricReducer 上报数据。前端仪表盘订阅SensorData表任何传感器数据更新都会瞬间触发看板 UI 的刷新实现真正的实时监控。GitHub 地址项目仓库https://github.com/clockworklabs/SpacetimeDB