SpacetimeDB

<p align="center"> <a href="https://spacetimedb.com#gh-dark-mode-only" target="_blank"> <img width="320" src="https://yellow-cdn.veclightyear.com/b77ea3a9/e363273d-0cb3-4d17-b9e5-50a9a9b03f53.svg" alt="SpacetimeDB 标志"> </a> <a href="https://spacetimedb.com#gh-light-mode-only" target="_blank"> <img width="320" src="https://yellow-cdn.veclightyear.com/b77ea3a9/c5f5500b-f569-4ef8-9951-b91a09021744.svg" alt="SpacetimeDB 标志"> </a> </p> <p align="center"> <a href="https://spacetimedb.com#gh-dark-mode-only" target="_blank"> <img width="250" src="https://yellow-cdn.veclightyear.com/b77ea3a9/5b02b5e2-477b-4585-83ce-9b29d7986b45.svg" alt="SpacetimeDB"> </a> <a href="https://spacetimedb.com#gh-light-mode-only" target="_blank"> <img width="250" src="https://yellow-cdn.veclightyear.com/b77ea3a9/accc4d69-05c5-4517-9504-c88b7d24ff2c.svg" alt="SpacetimeDB"> </a> <h3 align="center"> 以光速实现多人游戏。 </h3> </p> <p align="center"> <a href="https://github.com/clockworklabs/spacetimedb"><img src="https://img.shields.io/github/v/release/clockworklabs/spacetimedb?color=%23ff00a0&include_prereleases&label=version&sort=semver&style=flat-square"></a> &nbsp; <a href="https://github.com/clockworklabs/spacetimedb"><img src="https://yellow-cdn.veclightyear.com/b77ea3a9/20a968a6-453f-40b6-a39f-64580247c1c1.svg?style=flat-square"></a> &nbsp; <a href="https://github.com/clockworklabs/spacetimedb/actions"><img src="https://img.shields.io/github/actions/workflow/status/clockworklabs/spacetimedb/ci.yml?style=flat-square&branch=main"></a> &nbsp; <a href="https://status.spacetimedb.com"><img src="https://img.shields.io/uptimerobot/ratio/7/m784409192-e472ca350bb615372ededed7?label=cloud%20uptime&style=flat-square"></a> &nbsp; <a href="https://hub.docker.com/r/clockworklabs/spacetimedb"><img src="https://img.shields.io/docker/pulls/clockworklabs/spacetimedb?style=flat-square"></a> &nbsp; <a href="https://github.com/clockworklabs/spacetimedb/blob/master/LICENSE.txt"><img src="https://yellow-cdn.veclightyear.com/b77ea3a9/973acc1c-d96c-4d64-9de2-1ae8d2414152.svg?style=flat-square"></a> </p> <p align="center"> <a href="https://discord.gg/spacetimedb"><img src="https://img.shields.io/discord/1037340874172014652?label=discord&style=flat-square&color=5a66f6"></a> &nbsp; <a href="https://twitter.com/spacetime_db"><img src="https://yellow-cdn.veclightyear.com/b77ea3a9/c5aebe3c-79cf-448b-bc2c-1d45ba51b5a3.svg?style=flat-square"></a> &nbsp; <a href="https://clockworklabs.io/join"><img src="https://yellow-cdn.veclightyear.com/b77ea3a9/028cc657-4ee9-4856-a301-eef429f79a11.svg?style=flat-square"></a> &nbsp; <a href="https://www.linkedin.com/company/clockworklabs/"><img src="https://yellow-cdn.veclightyear.com/b77ea3a9/fd0cd27b-d48b-484c-99da-c3a36ef2191b.svg?style=flat-square"></a> </p> <p align="center"> <a href="https://discord.gg/spacetimedb"><img height="25" src="https://yellow-cdn.veclightyear.com/b77ea3a9/47278525-6b42-4577-afb4-87cc57150966.svg" alt="Discord"></a> &nbsp; <a href="https://twitter.com/spacetime_db"><img height="25" src="https://yellow-cdn.veclightyear.com/b77ea3a9/d0034a11-e764-43f7-a4e4-c592341dd958.svg" alt="Twitter"></a> &nbsp; <a href="https://github.com/clockworklabs/spacetimedb"><img height="25" src="https://yellow-cdn.veclightyear.com/b77ea3a9/600a6595-df08-4b4e-bde3-66b86b60d7d8.svg" alt="Github"></a> &nbsp; <a href="https://twitch.tv/SpacetimeDB"><img height="25" src="https://yellow-cdn.veclightyear.com/b77ea3a9/730773f3-16d5-4099-aa4b-014c590db2b0.svg" alt="Twitch"></a> &nbsp; <a href="https://youtube.com/@SpacetimeDB"><img height="25" src="https://yellow-cdn.veclightyear.com/b77ea3a9/a30bedc8-5dbe-4db2-9fdd-fd8baf5b2272.svg" alt="YouTube"></a> &nbsp; <a href="https://www.linkedin.com/company/clockwork-labs/"><img height="25" src="https://yellow-cdn.veclightyear.com/b77ea3a9/6d10a859-efbf-4f19-86b5-f54e37775cca.svg" alt="LinkedIn"></a> &nbsp; <a href="https://stackoverflow.com/questions/tagged/spacetimedb"><img height="25" src="https://yellow-cdn.veclightyear.com/b77ea3a9/8deff20c-11ac-4f92-a650-e987afbf364f.svg" alt="StackOverflow"></a> </p> <br>

什么是 SpacetimeDB？

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

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

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

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

<figure> <img src="https://yellow-cdn.veclightyear.com/b77ea3a9/643bc3a6-df3e-4f2b-adc0-095be5962700.png" alt="SpacetimeDB 架构" style="width:100%"> <figcaption align="center"> <p align="center"><b>SpacetimeDB 应用架构</b><br />^{_{（白色部分由 SpacetimeDB 提供）}}</p> </figcaption> </figure>

这实际上类似于智能合约的概念，不同之处在于 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 个步骤。

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

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

语言支持

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

服务器端库

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

客户端库

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

许可证

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

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