Bu dosya, bu mimariyi kodda gerçekte var olduğu şekliyle belgeliyor ve 23 Ağustos 2026 itibarıyla dosya bazında doğrulanıyor; diyagramlar, şekiller ve alıntılar dahil. Bu, “Rust Mühendislik” kümesinin temel sayfasıdır: genel bakışı verir ve yayınlanmış veya yayınlanma sürecinde olan ayrıntılı teknik analizlere (Axum, Cargo çalışma alanı, ağ geçidi, PostgREST, pg_graphql ve dosyanın geri kalanı) bağlantılar verir. Rakip bir BaaS ile tam ürün karşılaştırması için karşılaştırmamıza bakın Aurabase ve Supabase.
Temeller
- Tek Çalışma Alanı Kargosu: Tek bir
cargo build --workspacetarafından bir araya derlenen 18 kasa (11 iş hizmeti,auraCLI, 5 paylaşılan kitaplık, Rust SDK). - İşletme kodu, bu 18 kasaya dağıtılmış yaklaşık 274.000 satırlık Rust (
find+wc -l, 23 Ağustos 2026 ile ölçülmüştür) ağırlığındadır. - Ağ geçidi (
aura-gateway), her biri kendi ara yazılım yığınına ve kimlik doğrulamasına sahip olan veri (SDK, bağlantı noktası 8080) ve yönetim (Studio, bağlantı noktası 8090) olmak üzere iki düzlemi ayırır. - Aurabase, PostgREST'yi yeniden yazmaz: kiracı başına gerçek yukarı akış ikili dosyası (16,5), Rust hizmetleri tarafından düzenlenir; katma değer bunun yerine onun çevresindedir, değil.
- Saf Rust'den dikkate değer tek farklılık: Edge Functions'nin (
denomodu) varsayılan çalışma zamanı, V8 İzolatlarını temel alan özel bir TypeScript hizmetidir;wasmmodu için yerel ve Wasmtime aracılığıyla Rust içinde ikinci bir yol mevcuttur.
Aurabase hizmetini, hizmete göre birleştirilmiş BaaS hizmetinden ayıran şey nedir?
Çoğu açık kaynak Postgres BaaS hizmetlerini birden çok dilde paketler. Bu bir değer yargısı değil, somut sonuçları olan mimari bir gerçektir: Oyunda olan diller kadar çok sayıda derleme zinciri, hata kuralı ve senkronizasyonda tutulması gereken kimlik doğrulama mantığı.
Aurabase'de kendi yazdığımız ve bakımını yaptığımız ürün katmanı (ağ geçidi, kimlik doğrulama, veritabanı, gerçek zamanlı, depolama, bildirimler, yapay zeka, provizyon, hesap yönetimi) tek bir Cargo çalışma alanı, tek bir dil, tek bir yapı zinciridir. Bu dosyanın belgelediği seçim budur.
"Birleşik çekirdek", üretimde çalışan her şeyin Rust olduğu anlamına gelmez. Herhangi bir Postgres BaaS gibi, Aurabase de yazmadığı açık kaynaklı yapı taşlarına dayanır: PostgreSQL kendisi, PostgREST, NATS. Heterojen bir yığının yapısal farkı, bu paylaşılan yapı taşlarıyla ilgili değildir; onları düzenleyen ürün katmanıyla ilgilidir. Aşağıdaki bölümlerde, kodu denetlerken bulduğumuz tek gerçek istisna (Edge Functions, bölüm 09) da dahil olmak üzere, bu sınırın tam olarak nereden geçtiği ayrıntıları verilmektedir.
18 kasa, bir derleme zinciri
Kök Cargo.toml, çözümleyici v2'de 18 üyeli bir Kargo çalışma alanı bildirir: 11 iş hizmeti, aura-cliCLI, 5 paylaşılan kitaplık ve aurabase-rsSDK. İşte depoda göründüğü şekliyle gerçek liste.
[workspace]
resolver = "2"
members = [
# Hizmetler (11)
"services/aura-gateway", "services/aura-auth", "services/aura-db",
"services/aura-provisioner", "services/aura-realtime", "services/aura-storage",
"services/aura-functions", "services/aura-notifications", "services/aura-ai",
"services/aura-migrator", "services/aura-control",
# Araçlar
"aura-cli",
# Kitaplar (5)
"libs/aura-core", "libs/aura-crypto", "libs/aura-db-adapters",
"libs/aura-migrations", "libs/aura-telemetry",
"aurabase-rs",
]
Paylaşılan bağımlılıklar [workspace.dependencies]'de bulunur: Axum 0.8 (WebSockets, çok parçalı, makrolarla), Tokio, Tower/Tower-HTTP, SQLx 0.8 (ikincil NoSQL motoru için Postgres + MongoDB, mongodb aracılığıyla), async-nats 0.47, sqlparser 0.53 (SQL doğrulaması NL2SQL), oauth2 5, jsonwebtoken 10 ve neredeyse her hizmette iki performans kütüphanesi bulunur: genel ayırıcı olarak mimalloc ve bellek içi önbellek için moka/dashmap.
Sürüm profili varsayılan bir seçimi belgeliyor: "abort" yerine panic = "unwind" . Dosya yorumu kendi kendini açıklamaktadır - Axum/Tokio işleyicisindeki panik, tüm süreci çökertmek ve rakip istekleri kesmek yerine çalışma zamanı tarafından izole edilir (etkilenen istek 500 döndürür). Aynı nota göre,abort performans kazancı (RPS'nin yaklaşık %1 ila 2'si) yalıtım kaybına değmez. Bu, bir pazarlama iddiası değil, kodda belgelenen güvenilirlik-hız dengesidir.
Tek bir cargo build --workspace her şeyi derler. Tek bir cargo test --workspace tüm test paketini çalıştırır. Tek bir cargo clippy --workspace --all-targets -- -D warnings ürünün tamamını aynı kurallara göre sıralar. Bu yapının ayrıntıları - bağımlılıkların kalıtımı, kütüphaneler ve hizmetler arasındaki dahili grafik, onu büyütürken karşılaştığımız tuzaklar - özel bir makalenin konusudur: Kargo çalışma alanı mimarisi, çoklu hizmetin nasıl yapılandırılacağı Rust arka uç.
Hizmete göre Rust satırlar (hizmetleri bulun -name '*.rs' | xargs wc -l, 23 Ağustos 2026):
aura kontrolü
36 024
aura-db
30 255
aura-auth
28 431
aura sağlayıcı
28 271
aura bildirimleri
18 498
sahip olacak
18 305
aura ağ geçidi
16 938
aura-gerçek zamanlı
16 799
aura depolama
13 747
aura fonksiyonları
11 619
aura göçmeni
538
Paylaşılan kütüphaneler (aura-db-adapters: 24.725 satır, aura-core: 7.259, aura-migrations: 3.641, aura-crypto: 2.718, aura-telemetry: 201), CLI (aura-cli: 9.845) ve Rust SDK (aurabase-rs:) hariçtir 6,363). Tek kullanımlık bir geçiş işi olan ve uzun ömürlü bir HTTP sunucusu olmayan aura-migrator, kasıtlı olarak çalışma alanındaki en küçük hizmet olmaya devam ediyor.
Her biri bağımsız bir Axum sunucusu olan 11 iş hizmeti
Her hizmet, kendi konfigürasyonu ve bağlantı noktasıyla bağımsız bir Axum/Tokio ikilisidir. On birinden on tanesi /health ve /metrics'yi ortaya çıkarır ve mimalloc'yi genel ayırıcı olarak bildirir; tek istisna olan aura-migrator, sürekli çalışan bir sunucu yerine tek amaçlı bir iştir.
| aura ağ geçidi | Çift düzlemli ağ geçidi (veri:8080, yönetim:8090): diğer tüm hizmetlerin proxy'si. |
|---|---|
| aura-auth | Kimlik doğrulama: JWT, 15 adlı OAuth sağlayıcı + proje, oturum başına genel OIDC, MFA. |
| aura-db | Veritabanı API'si: PostgREST kiracı başına yönetim/yeniden yükleme, Postgres ve MongoDB bağdaştırıcıları, CDC. |
| aura sağlayıcı | Proje yaşam döngüsü: ayrılmış veya paylaşılan CNPG kümeler, roller, kiracı başına PostgREST. |
| aura-gerçek zamanlı | WebSocket ve SSE, CDC yayını, NATS JetStream KV aracılığıyla örnekler arası varlık. |
| aura depolama | S3 uyumlu nesneler (SeaweedFS), RLS ilkeleri Postgres öğesinden aktarılabilir. |
| aura fonksiyonları | Edge Functions: dağıtım, işler, cron, yerel Wasmtime çalışma zamanı (bkz. bölüm 09). |
| aura bildirimleri | E-posta, push, giden web kancaları. |
| sahip olacak | NL2SQL, RAG ve LLM ağ geçidi (yerel OpenAI, Anthropic, Gemini + herhangi bir OpenAI uyumlu uç nokta). |
| aura göçmeni | Geçiş motoru: her sağlamada yeniden oynatılan tutma şemasının tek kaynağı. |
| aura kontrolü | Yönetim planı: geliştirici hesapları, kuruluşlar, faturalandırma, Studio API. |
aura CLI (≈ 9.800 satır), SDK'larla aynı API'lerle konuşur; ayrıcalıklı bir yolu yoktur. Her hizmetin tam referansı mimari belgelerinde ve CLI referansında bulunur.
Servisler arası kaymayı önleyen 5 kasa
Çok dilli bir yığında, bir güvenlik kuralının (hata formatı, SSRF koruması, hız sınırlama) her dilde yeniden uygulanması gerekir ve neredeyse her zaman aylar boyunca değişiklik gösterir. Aurabase bunu bir çalışma alanı kitaplığında, ilgili tüm hizmetler tarafından tüketilen bir kez kodlar.
| aura çekirdeği | 7 259 l. | Paylaşılan temel öğeler: hatalar, API yanıt zarfı, JWT talepleri, dahili hizmetten hizmete kimlik doğrulama, NATS yardımcıları, hız sınırlama, SSRF korumalı HTTP istemcisi, devre kesici, kiracı çözümü, ölçüm. |
|---|---|---|
| aura-db-adaptörler | 24 725 l. | Aura-db tarafından kullanılan birleşik veritabanı, Postgres ve MongoDB uygulamalarını uyarlama özelliği. |
| aura-kripto | 2 718 l. | Parola karma, belirteç oluşturma, JWT imzalama/doğrulama, alan düzeyinde şifreleme. |
| aura göçleri | 3 641 l. | Geçiş motoru — sağlayıcı tarafından yeniden oynatılan kiracı şemasının tek kaynağı (her hizmet için geçişler/belirli klasörler değil). |
| aura telemetrisi | 201 l. | 11 hizmet tarafından paylaşılan OpenTelemetry + izleme yapılandırması. |
Doğrudan sonuç: aura-core içindeki bir güvenlik yaması - örneğin SSRF koruması - beş dilde beş ayrı yama yoluyla değil, sonraki cargo build içindeki her tüketici hizmetine yayılır.
İkili plan: SDK trafiği ve Studio trafiği
aura-gateway, aynı istemcilere veya aynı kimlik doğrulama modeline sahip olmayan iki yüzeyi ayırır. Veri düzlemi (bağlantı noktası 8080, değişken GATEWAY_PORT), API anahtarı (apikey, X-API-Key veya ?apikey=) tarafından kimliği doğrulanan SDK/uygulama trafiğini alır. Yönetim düzlemi (bağlantı noktası 8090, MANAGEMENT_PORT), kimliği bir JWT konsolu (Authorization: Bearer) tarafından doğrulanan Studio/yönetici trafiğini alır.
// Veri düzlemi — API anahtarı
.route("/v1/auth/{*path}", any(auth_proxy))
.route("/v1/db/{*path}", any(db_proxy))
.route("/v1/realtime/ws", get(realtime_ws_proxy))
.route("/v1/realtime/sse", get(realtime_sse_proxy))
.route("/v1/storage/{*path}", any(storage_proxy))
.route("/v1/notifications/{*path}", any(notifications_proxy))
.route("/v1/ai/{*path}", any(ai_dispatcher))
.route("/v1/functions/{*path}", any(functions_proxy))
// Yönetim planı — JWT konsolu
.route("/v1/control/{*path}", any(control_proxy))
Her düzlem, birbirine aynı şekilde güvenmemesi gereken iki yüzey arasında yanlışlıkla paylaşılan tek bir zincir yerine, ayrı modüllerde (middleware/rate_limit.rs, middleware/circuit_breaker.rs, middleware/auth_data_plane.rs, middleware/auth_management_plane.rs) uygulanan sorgu tanımlama, erişim günlüğü, hız sınırı, kimlik doğrulama (düzlece özgü), devre kesici ve ardından proxy gibi kendi ara yazılım yığınını taşır. yol.
Ara yazılımların tam sırası, hedef başına hız sınırlaması ve NATS/HTTP proxy'si özel bir makalenin konusudur: çift düzlemli ağ geçidi, Rust içinde bir veri düzlemi/yönetim düzlemi API ağ geçidi tasarlayın.
Aurabase neden PostgREST'yi Rust'de yeniden uygulamıyor?
SDK'nın kullandığı, kendi kendine oluşturulan REST API, şirket içi bir Rust modülü değildir: tahsis edilmiş proje başına 2 kopya halinde dağıtılan (deploy/cnpg/tenant-postgrest.yaml), kiracınınkiyle aynı konumda bulunan gerçek yukarı akış ikili dosyasıdır PostgREST (postgrest/postgrest:v16.5) CNPG örneği. aura-provisioner bu dağıtımı oluşturur ve aura-db, her şema yeniden yüklemesinden sonra PostgREST'nin DDL değişikliğini hesaba kattığını doğrulamak için OPTIONS uç noktasını araştırır.
Bu, bir kısayol değil, varsayılan bir mimari seçimdir: PostgREST, Rust'de parça parça yeniden yazılması hiçbir şey getirmeyecek, olgun, yaygın olarak benimsenmiş bir projedir. Aurabase'nin Rust çalışması, sorgu motorunun içine değil, çok kiracılı yönlendirme, provizyon, NetworkPolicy tarafından ağ izolasyonu, ağ geçidiyle paylaşılan kimlik doğrulama, düzenlenmiş şema yeniden yükleme konularına odaklanır. Bu uyumluluğun gerçekte neyi kapsadığı ve nerede bittiği ayrı bir makalenin konusudur: PostgREST, gerçek uyumluluk vealternatifleri.
GraphQL tarafında da aynı mantık: Postgres uzantısı pg_graphql (önceden derlenmiş .deb paketi, v1.6.1), özel CNPG görüntüsüne yüklenir ve talep üzerine proje başına POST /v1/control/projects/{project_id}/graphql/enable uç noktası aracılığıyla etkinleştirilir; yeniden yazılmış bir GraphQL motoru da değildir. Hasura ve PostGraphile ile ayrıntılar ve dürüst karşılaştırma: Postgres üzerinde pg_graphql ile Yerel GraphQL API.
RLS ve kimlik doğrulayıcı rolü, uygulama katmanı değil
Çok kiracılı yalıtım, bir uygulama ORM'si tarafından eklenen bir WHERE tenant_id = ? filtresine dayanmaz: her istek, isteği yürütmeden önce SET LOCAL ROLE tenant_<uuid> işlem kapsamlı bir işlemi yürüten aura_authenticatorrolünden geçer - tam olarak PostgREST'nin beklediği model. Satır Düzeyinde Güvenlik, gerisini iş kodu düzeyinde değil, motor düzeyinde yapar.
Tüm projeler aynı Postgres topolojisini paylaşmaz. aura-provisioner kodu, en az iki gerçek değişkene sahip bir ProjectInstanceKind türünü ortaya çıkarır: FullyDedicated (tamamen projeye ayrılmış CNPG örneği) ve SharedClusterDedicated (paylaşılan bir CNPG kümesinde RLS tarafından yalıtılmış şema). Abone olunan plan topolojiyi belirler; bu, "herkes için özel bir taban" şeklinde tek tip bir vaat değildir.
"Neden tamamen uygulama izolasyonu yerine proje başına özel bir taban" açısı özel bir makalenin konusudur: RLS ve proje başına özel taban. Satır Düzeyinde Güvenlik belgeleri pratik uygulamayı kapsar.
NATS çekirdek, JetStream değil: hizmetler arasında eşzamansız mesajlaşma
On bir iş hizmetinden on tanesi async-nats'yi Cargo.toml'ye doğrudan bağımlılık olarak bildirir; yalnızca aura-migrator bu olmadan yapar. Bu kasa adının söylemediği şey: Bu hizmetler hemen hemen her yerde NATS'çekirdek pub/sub API (Client::publish / publish_with_headers, kalıcılık veya tekrar oynatma olmadan en fazla bir kez teslimat), değil kullanır JetStream. Bu, en önemli üç kullanım için kodda doğrulanan durumdur: PostgreSQL CDC - aura-realtime dağıtımı, Edge Functions işlerinin aura-functions içinde bildirilmesi (DLQ'nun kendisi Postgres içinde yaşıyor, NATS içinde değil) ve arasındaki sağlama olayları aura-provisioner ve filonun geri kalanı.
JetStream — NATS' kalıcılık ve adlandırılmış akışlar modu — monorepo'da yalnızca doğrulanmış bir konumda görünür: aura-realtime içindeki çapraz örnek varlığı KV Mağazası (kova aura_presence, bellek deposu, 60 saniyelik max_age), birden fazla ws-front örneğinde kimin hangi kanala bağlı olduğunu senkronize eder — a tekrarlanacak bir olay akışı değil, çapraz örnekler paylaşılan durum. Çalışma alanının başka bir yerinde kalıcı JetStream akışı bulunamadı. CDC hattının ayrıntıları - wal2json, Lease Kubernetes tarafından benzersiz bir cdc-worker seçimi, ws-frontkopyalarına çekirdek NATS dağıtımı, abone tarafından RLS yeniden doğrulama - özel bir makalenin konusudur: , PostgreSQL yayını CDC ile NATS. Gerçek zamanlı belgeler, SDK tarafındaki kullanımı kapsar.
Edge Functions: iki ihtiyaç için iki çalışma zamanı
Bu, bu dosyanın en önemli nüansıdır ve Aurabase ürün kodundaki saf Rust'den tek gerçek sapmadır. Her işlev, "wasm" veya "deno" değerinde bir runtime alanı taşır. Çağırma işleyicisi yürütme yolunu buna göre seçer - kodun kendisinde yorumlanan gerçek kod parçası:
// Çalışma zamanına göre gönderim: WASM (wasmtime) veya Deno (V8 Edge-runtime aracılığıyla izole edilir)
let resp = if func.runtime == "wasm" {
state.runtime.invoke(&wasm_bytes, &func.code_hash, req).await?
} else {
// Aura-edge-runtime proxy'si — V8 İzolatları (supabase/edge-runtime, MIT)
proxy_to_edge_runtime(&state.config.edge_runtime_url, …).await?
};
wasm modu yereldir: aura-functions doğrudan Wasmtime (sürüm 43, async ve cranelift özelliklerine sahiptir) öğesine bağlıdır ve modülü aynı Rust işleminde, yakıt sayımı, çağa göre kesinti ve bellek sınırlaması ile çalıştırır. StoreLimits. deno modu - mevcut Supabase koduyla neredeyse doğrudan Deno.serve() uyumluluğu için Studio düzenleyicisinde varsayılan olarak kullanılan mod - yürütmeyi yaklaşık 550 satırlık ayrı bir TypeScript hizmeti olan aura-edge-runtime'ye devreder, açıkça modellenmiştir - kaynak dosya başlığı yorumunun kendisi bundan alıntı yapar - üzerinde supabase/edge-runtime (MIT lisansı), her çağrıyı kendi V8 İzolasyonuna izole eder.
Kontrol - dağıtım, izinler, işler, cron, kotalar - tamamen Rust içinde aura-functions içinde kalır. Kullanıcı kodunun yalnızca deno modunda çalıştırılması Rust ikili dosyasından çıkar. Bu, savunulabilir bir mühendislik uzlaşmasıdır (V8 İzolatları, Deno'nin bu seviyedeki sanal alan oluşturma için doğal olarak sağladığı şeydir), sessiz kalmayı tercih ettiğimiz bir ihmal değildir. Yakında bu dosyada yer alacak olan Wasmtime ve Wasmer karşılaştırması ve WebAssembly soğuk başlatma analizi bu konuda daha da ileri gidecektir.
Her iki dağıtım yolunun nasıl yapılır belgesi için bkz. Edge Functions. Supabase'den Deno geçiş çalışma kitabı için bkz. Bir Supabase projesini Aurabase'ye geçirme, bu dosyadan önce bu ayrımı zaten belgelemiştir.
Bu birleşik kalp sizin için somut olarak neyi değiştiriyor?
API'yi yalnızca bir SDK aracılığıyla çağırırsanız bu mimari görünmez; amaç da budur. Temel olarak üç hedef kitle için önemlidir: üretim verilerini buna taşımadan önce çok kiracılı bir arka ucun operasyonel güvenilirliğini değerlendirenler, depoya katkıda bulunmayı planlayanlar (MIT, tek monorepo) ve Aurabase tarafındaki bir güvenlik yamasının neden yavaş yerine hızlı bir şekilde yayıldığını anlamak isteyenler.
Somut olarak: tek bir IC (cargo build --workspace, cargo test --workspace, cargo clippy --workspace --all-targets -- -D warnings) ürün yüzeyinin %90 veya daha fazlasını kaplar. aura-core ile ilgili bir kod incelemesi potansiyel olarak aynı anda on hizmeti etkileyebilir; hem daha iyi (bir düzeltme yol boyunca kaybolmaz) hem de daha kötü (kötü izole edilmiş bir değişiklik aynı hızla yayılır). Bu, sihirli bir çözüm değil, bir uzlaşmadır ve tam da bu nedenle, bir pazarlama özeti yerine gerçek mimariyi belgeliyoruz.
Rust Mühendislik dosyasının geri kalanı
Bu sütun sayfası, yayınlandıkça kümenin teknik analizlerine bağlantı verir. Bu sayfanın yayınlandığı andaki gerçek durum - ilgili makale çevrimiçi olur olmaz bağlantılar aktif hale gelir.
Küme A — Çerçeve ve mimari
Axum ve Actix-web: üretimde Rust arka ucu için hangi çerçeve?Yayınlandı
Kargo çalışma alanı mimarisi: çoklu hizmet Rust arka ucunun nasıl yapılandırılacağıYayınlandı
Çift düzlemli ağ geçidi: Rust'de bir veri düzlemi/yönetim düzlemi API ağ geçidi tasarlamaYayınlandı
Küme B — Postgres üzerinde kendi kendine oluşturulan API
PostgREST: uyumluluk gerçekte neleri kapsar ve hangi alternatifler mevcutturYayınlandı
Postgres üzerinde pg_graphql ile Yerel GraphQL API'si: Hasura ve PostGraphile aynı şeyi yapmazYayınlandı
RLS ve proje başına ayrılmış taban: Aurabasearasından çok kiracılı yalıtım seçimi Yayınlandı
C Grubu — Gerçek zamanlı ve mesajlaşma
PostgreSQL CDC'yi NATS ile dağıtın: gerçek zamanlı mimariYayınlandı
Küme D — Edge Functions WebAssembly
| Wasmtime vs Wasmer: üretimde Edge Functions için hangi WebAssembly çalışma zamanı | Yakında |
|---|---|
| Edge Functions, Rust/WASM ile Cloudflare Workers ve Vercel Edge arasında | Yakında |
| Soğuk Başlangıç WebAssembly: Kriterlerin gerçekte söyledikleri (ve henüz söyleyemediklerimiz) | Yakında |
Küme E — Geçiş ve alternatifler
Bir Supabase projesini, RLS politikalarınızı yeniden yazmadan Aurabase'ye geçirinYayınlandı
Egemen kendi kendine barındırma: Aurabase'yi Rust'ye karşı konumlandırma -yerel BaaSÇok yakında