SpacetimeDB - 融合数据库与服务器的实时多人应用开发平台

以光速实现多人游戏。

什么是 SpacetimeDB？

您可以将 SpacetimeDB 视为数据库和服务器的结合体。

它是一个关系数据库系统，允许您通过称为"模块"的高级存储过程直接将应用程序逻辑上传到数据库中。

不需要部署一个位于客户端和数据库之间的网络或游戏服务器，您的客户端可以直接连接到数据库并在数据库内执行应用程序逻辑。您可以像在普通服务器中一样，直接在模块内编写所有权限和授权逻辑。

这意味着您可以使用单一语言 Rust 编写整个应用程序，并将其部署为单个二进制文件。不再需要微服务、容器、Kubernetes、Docker、虚拟机、DevOps、基础设施、运维和服务器。

SpacetimeDB 架构 — **SpacetimeDB 应用架构**
^{_{（白色部分由 SpacetimeDB 提供）}}

这实际上类似于智能合约的概念，不同之处在于 SpacetimeDB 是一个数据库，与区块链无关，并且比任何智能合约系统都快几个数量级。

事实上，它如此之快，以至于我们的大型多人在线角色扮演游戏 BitCraft Online 的整个后端仅仅是一个 SpacetimeDB 模块。我们没有运行任何其他服务器或服务，这意味着游戏中的所有内容，包括所有聊天消息、物品、资源、地形，甚至玩家的位置都由数据库存储和处理，然后实时同步到所有客户端。

SpacetimeDB 针对最高速度和最低延迟进行了优化，而不是批处理或 OLAP 工作负载。它专为游戏、聊天和协作工具等实时应用程序而设计。

这种速度和低延迟是通过将所有应用程序状态保存在内存中实现的，同时将数据持久化到预写日志（WAL）中，用于恢复应用程序状态。

安装

SpacetimeDB 是一个嵌入式数据库库，您可以用它来扩展自己的应用程序。您还可以通过 spacetime CLI 工具将 SpacetimeDB 作为独立的数据库服务器运行。

您可以通过 Cargo、Homebrew、Docker 或直接从我们的网站下载二进制文件来安装和运行 spacetime CLI 工具。

在 macOS 上安装

您可以使用 Homebrew 在 macOS 上安装 SpacetimeDB。这将安装 spacetime CLI 工具和 SpacetimeDB 独立服务器作为单个可执行文件。您也可以使用下面的 Linux 安装说明在 macOS 上安装。

brew install clockworklabs/tap/spacetime

在 Linux 上安装

在 Linux（或其他 Unix 操作系统）上安装 SpacetimeDB 非常简单，只需下载二进制文件并运行即可。您也可以使用下面的 Docker 安装说明在 Linux 上安装。

curl --proto '=https' --tlsv1.2 -sSf https://install.spacetimedb.com | sh

在 Windows 上安装

在终端中运行以下命令，并按照屏幕上的说明安装 spacetime CLI 工具和 SpacetimeDB 独立服务器作为单个可执行文件。

iwr https://windows.spacetimedb.com -useb | iex

使用 Cargo 安装

如果您想从源代码构建 spacetime CLI 工具，可以使用 Cargo 安装。

cargo install spacetimedb-cli

从源代码安装

对于 MacOS 和 Linux，这很简单。只需在终端中运行以下命令：

# 安装 rustup，如果您已经安装了 cargo 和 wasm32-unknown-unknown 目标，可以跳过这一步。
curl https://sh.rustup.rs -sSf | sh
# 克隆 SpacetimeDB
git clone https://github.com/clockworklabs/SpacetimeDB
# 构建并安装 CLI
cd SpacetimeDB
cargo install --path ./crates/cli --locked

Windows 可能需要安装一些额外的依赖项，包括 openssl 和特定版本的 perl。相关指南将很快提供。

使用 Docker 运行

您可以使用 Docker 运行 SpacetimeDB 独立服务器，而无需安装任何命令行工具或其他依赖项来执行 spacetime CLI 工具。

docker run --rm --pull always --name spacetimedb -p 3000:80 clockworklabs/spacetimedb:latest start

文档

有关 SpacetimeDB 的更多信息、入门指南、游戏开发指南和参考资料，请查看我们的文档。

入门

我们为每种支持的语言准备了几个入门指南，以帮助您尽快开始使用 SpacetimeDB。您可以在我们的文档页面上找到它们。

简而言之，使用 SpacetimeDB 只需 4 个步骤。

安装 spacetime CLI 工具。
使用 spacetime start 启动 SpacetimeDB 独立节点。
用我们支持的模块语言之一编写并上传模块。
使用我们的客户端库之一连接到数据库。

您可以在下面看到支持的语言摘要，以及每种语言的入门指南链接。

语言支持

您可以使用多种流行语言编写 SpacetimeDB 模块，未来还会支持更多语言！

服务器端库

Rust
C#（实验性）
Typescript（计划中）
Python（计划中）
C++（计划中）
Lua（计划中）

客户端库

Rust
C#
Typescript
Python（计划中）
C++（计划中）
Lua（计划中）

许可证

SpacetimeDB 采用 BSL 1.1 许可证。这不是开源或自由软件许可证，但在几年后会转换为带有链接例外的 AGPL v3.0 许可证。

请注意，AGPL v3.0 通常不包含链接例外。我们为 SpacetimeDB 的