跳到内容
光环标志
光环基地

建筑

请求如何从您的客户端传输到 Postgres、组织和项目如何隔离以及服务如何扩展。

说明7分钟 读取级别 中间修改于 2026年11月4日

该页面已自动翻译。英文版具有权威性。

一个后端,八个服务#

Aurabase 是一个 Rust monorepo,它构建了八个 Axum 服务。每个服务都有自己的端口和自己的 /v1/<service>/… 路由,并且服务通过 NATS 请求/回复相互通信。来自应用程序的所有流量都经过一个网关。

服务可以重新启动、崩溃或自行部署。网关使用断路器跟踪每个服务的运行状况:在 60 秒内发生 5 次故障后,它会为该服务应答 503 30 秒,然后重试。

服务与责任#

每个服务都拥有一个域、自己的 SQL 迁移和自己的数据。您的应用程序只能通过网关到达它们。

服务域名职责
aura-gatewayAPI网关代理、认证中间件、速率限制、断路器
aura-auth认证注册、登录、OAuth 2.1、TOTP MFA 和 WebAuthn、会话、JWKS
aura-db数据库CRUD over PostgREST、版本化迁移、类型生成、模式管理
aura-realtime实时WebSocket、SSE、事件中继、存在、Postgres 更改数据捕获
aura-storage存储S3- 兼容对象存储、分段上传、签名 URL、图像转换
aura-functionsEdge FunctionsWASM 和 Deno 运行时、cron、异步作业队列、死信队列
aura-notifications通知事务性电子邮件 (SMTP)、SMS、移动推送、HMAC签名的 Webhooks
aura-ai人工智能网关通过一个端点、嵌入、带有 pgvector 的 RAG 进行 LLM 推理

按组织和项目隔离#

每个组织都有自己的 PostgreSQL 集群,并在为其保留的 Kubernetes 命名空间中使用 CloudNativePG (CNPG) 进行配置。两个组织之间不共享任何集群、命名空间或连接池。集群的容量(vCPU、内存、副本)遵循组织的计划。

在该集群内,每个项目都有自己的 Postgres 数据库,分为四个模式。每个项目都有自己的连接角色,该角色仅是其自己角色的成员。项目架构的权限被授予这些角色,而不是 PUBLIC。网关在客户端的 JWT中设置来自项目的连接 search_path ,并且应用程序表受到行级安全性 (RLS) 的保护。

在企业版中,项目还可以在其自己的命名空间中获得专用的 CNPG 集群。除了权限之外,隔离还来自集群的物理分离。

模式业主内容
project_{uuid}你您的申请表
project_{uuid}_authaura-authusers、 sessions、 oauth_accounts、 mfa
project_{uuid}_storageaura-storagebuckets、 objects、 rls_policies
project_{uuid}_platform平台functions、 jobs、 cron、 api_keys、 webhooks

三个后果如下:

  • 没有跨租户访问。 两个组织从不共享集群、命名空间或连接池。
  • 独立迁移。 每个项目都会自行迁移和回滚。
  • 普通导出。 pg_dump --schema='project_*' 转储项目的数据、扩展和策略。
共享模式

aura_console 架构是共享的。它保存 projects 表和 Studio 会话。没有应用程序数据经过它。

从curl到Postgres#

网关在路由之前检查每个请求。这是来自 REST 客户端的 GET /v1/db/{projectId}/devices 路径:

请求路径text
1. TLS termination        client → aura-gateway
2. Request ID and tracing request_id and trace_id are attached to the request
3. Rate limit             token bucket, answers 429 when the limit is reached
4. Authentication         JWT decoded and claims checked: sub, project_id, role
5. Circuit breaker        the target service is HEALTHY, so the request goes through
6. Execution              search_path set to the project's schemas, then the query runs under RLS

每个步骤都使用 tracing写入结构化日志,并通过 request_id关联。

缩放#

服务是无状态的。要添加容量,请启动二进制文件的另一个副本并将其连接到 NATS。它会加入集群并在准备就绪时处理请求。没有领导者选举,也没有分布式协调。

为了走得更远#