surrealdb

一个数据库搞定实时应用的后端,查询同步权限全内置

SurrealDB 是一个用 Rust 编写的可扩展、分布式、协作式的文档-图数据库,专为实时 Web 应用设计。它解决了传统数据库在实时应用中的痛点,如数据同步复杂、查询语言不统一、扩展性受限等问题。SurrealDB 将文档数据库的灵活性和图数据库的关系查询能力融合在一起,支持 SQL 风格的查询语言,并内置了实时订阅、权限控制、数据校验和备份等功能。其核心能力包括:支持多种数据模型(文档、图、关系)、强大的查询语法、内置的实时协作支持(类似 Live Query)、以及可通过 REST、GraphQL 或 WebSocket 直接访问,降低了后端开发的复杂度。它旨在作为一个后端即服务(BaaS)的数据库,让开发者可以快速构建实时应用,而无需自己搭建复杂的后端基础设施。

开源 freemium 基础设施
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 33052
维护状态 较活跃
是否开源 是
定价模式 freemium

项目数据

分类基础设施
开发团队surrealdb
所属国家
定价模式freemium
价格说明提供免费云服务层,含有限免费额度;另有付费企业版与按量计费选项,具体价格需官网查询。
访问状态
是否开源是
开源协议NOASSERTION
主要语言Rust
技术栈/模型backend-as-a-service,cloud-database,database,database-as-a-service,developer-tools,devtools,distributed,distributed-database,document-database,graph-database,iot-database,nosql,realtime-database,serverless,sql,surreal,surrealdb,web
GitHub 星标★ 33052
30天Star增速
HF 下载量
上线时间2021-12-09 00:00:00
最近更新2026-09-22 00:00:00
维护状态较活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-08-10
浏览次数4

使用教程

难度:入门 约 10 分钟 部署方式:Docker 4 步

⚠ 该项目 README 未提供完整安装说明,以下步骤为通用流程,请以官方文档为准。

环境要求

  • Docker 环境(使用官方容器镜像时)
  • Rust 工具链(以库形式嵌入或从源码构建时)
  • README 未列出具体操作系统、CPU、内存版本要求,仅说明资源占用低

安装与启动步骤

  1. 1确认部署形态

    按 README 说明,SurrealDB 既可作为嵌入式数据库库,也可作为分布式服务器运行;先确定自己要用哪一种。

  2. 2拉取官方镜像

    镜像名取自 README 中 Docker Hub 徽章指向的仓库 surrealdb/surrealdb;README 未给出启动参数。

    docker pull surrealdb/surrealdb
  3. 3查官方启动文档

    README 正文没有 server 启动命令、端口或数据目录说明,需到官网 surrealdb.com 的文档获取后再启动。

  4. 4选择语言 SDK

    README 徽章显示官方提供 Rust crate surrealdb、npm 包 surrealdb.js、PyPI 包 surrealdb;安装方式以官方文档为准。

如何确认成功

README 未提供启动成功验证方法,请以官网文档中的连接测试步骤为准。

常见问题

Q:README 里没有安装和启动命令怎么办?

A:节选内容确实未包含安装说明,只有 Docker Hub、crates.io、npm、PyPI 的徽章入口。请以官网 surrealdb.com 的官方文档为准执行安装与启动。

Q:应该用嵌入式库还是数据库服务器?

A:README 明确说明两种都支持:可作为带高级查询能力的嵌入式数据库库,也可作为可分布式集群运行的数据库服务器,按业务场景选择即可。

Q:官方提供哪些语言的 SDK?

A:从 README 徽章可见至少有 Rust(crates.io 的 surrealdb)、JavaScript(npm 的 surrealdb.js)和 Python(PyPI 的 surrealdb),其余请查看官网。

Q:商用授权有什么限制?

A:本仓库核心数据库代码采用 Business Source License 1.1;各 SDK 与部分核心组件分别采用 Apache 2.0 或 MIT,具体见官方 license 页面。

注意事项

  • 本 README 节选不含安装、启动、配置和端口信息,所有具体命令请以官网文档为准。
  • 核心数据库代码为 BSL 1.1 许可,商用前请阅读 https://github.com/surrealdb/license。
  • 安全漏洞请勿公开提 issue,按 README 指引发邮件至 security@surrealdb.com。
  • 遇到问题可加入官方 Discord、Reddit、Stack Overflow 的 #surrealdb 标签等社区渠道求助。

核心亮点

  • 融合文档和图模型,查询关系数据无需复杂 JOIN,语法直观
  • 内置实时订阅(Live Queries),数据变更自动推送,省去 WebSocket 后端开发
  • 支持 REST、GraphQL、WebSocket 多种接口,可直接暴露给前端,简化 BaaS 架构

不足之处

  • 项目较新,生态和第三方工具不如 PostgreSQL 等成熟数据库丰富
  • 文档和社区资源仍在完善中,部分高级用法需参考源码或讨论

适用场景

  • 实时协作应用(如在线文档、白板)的数据层,需要同步和权限控制
  • 快速搭建 MVP 或全栈应用,希望减少后端编码工作量
  • 需要灵活数据模型且涉及复杂关系查询的 Web 或移动应用

替代项目

Firebase、Supabase、MongoDB

项目介绍

surrealdb 是基础设施领域的开源项目,由 surrealdb 开发,2021 年首次发布。

在全站 13,109 个收录项目中,它的 GitHub 星标数(33,052)位列前 2%,在基础设施分类的 1,133 个项目里位列前 3%。

近 41 天,它的 GitHub 星标从 32,882 增加到 33,052,净增 170。

项目保持着较活跃的维护节奏,最近一次代码更新于 2026-09-22。提供免费云服务层,含有限免费额度;另有付费企业版与按量计费选项,具体价格需官网查询。从国内网络环境看,可直接访问。

它主要面向的使用场景是:实时协作应用(如在线文档、白板)的数据层,需要同步和权限控制。同类可对比的替代方案包括 Firebase、Supabase、MongoDB。

上一篇:krsh

下一篇:foundry-local

同类项目推荐

freebuff-proxy 开源

聚合多账号,一键接入 OpenAI 兼容 API,轻松管理会话。

[DEPRECATED / UNMAINTAINED] Multi-account gateway. No longer maintained; fork it and···

★ 303 2026-08-20
microduck 开源

用 Rust 造一只会走路的桌面小鸭,快速上手双足机器人。

A Tiny biped duck robot

★ 8684 2026-09-10
soperator 开源

用 Kubernetes 原生方式运行 Slurm,简化 HPC 集群管理。

Run Slurm in Kubernetes

★ 439 2026-08-10
ollama 开源

一条命令本地跑起大模型,免费、私密、不卡顿

Get up and running with Kimi, GLM, MiniMax, DeepSeek, gpt-oss, Qwen, Gemma and other···

★ 181484 2026-08-09