在 Aurabase,我们从设计阶段就给自己施加了强烈的约束:SDK 表面和 RLS 约定必须与 直接兼容 和 Supabase。相同的 createClient()、相同的 .from().select().eq()、相同的 SQL Postgres 策略。我们的想法是:如果你想离开,那就离开——我们让它变得微不足道。这是完整的剧本。
什么移动,什么留下
在开始之前,列出将要更改的内容和将保留的内容。剧透:大多数人仍然存在。
| Postgres 架构 | 相同 | pg_dump → pg_restore。扩展、触发器、函数、索引——一切顺利。 |
|---|---|---|
| RLS 政策 | 相同 | 相同的语法。 auth.uid()、auth.role()、auth.jwt() 按原样工作。 |
| JavaScript SDK | 95% 相同 | 将 @supabase/supabase-js 替换为 @aurabase/aurabase-js。相同的可链接 API。 |
| 身份验证流程 | 相同 | signUp、signInWithPassword、signInWithOAuth、mfa — 相同的名称、相同的签名。 |
| 存储API | 相同 | aura.storage.from(bucket).upload(...) · 兼容 S3 · 可转移 RLS 策略。 |
| 实时 | 相同 | Channel().on("postgres_changes", ...) 不变。存在+广播同样如此。 |
| Edge Functions | 相同 | Deno.serve() 按原样粘贴到 Studio 编辑器中。 CLI 将针对单独的路径部署函数(Rust 编译为 WASM)。 |
| 仪表板 | 不同 | Studio Aurabase · 我们帮助您找到方向。 |
创建目标 Aurabase 项目
使用官方 CLI 创建一个新的 Aurabase 项目,然后将此文件夹链接到该项目,以便以下命令自动应用于它。
# Aurabase 帐户 + CLI
npm i -g @aurabase/cli
aura login
# 创建项目(Postgres 引擎)
aura projects create my-app --engine postgres
# 将此文件夹链接到创建的项目
aura link --project-id <uuid-du-projet>
# 检索链接项目的 API 密钥
aura projects api-keys
转储 Supabase,恢复 Aurabase
标准 pg_dump / pg_restore: Aurabase 为每个项目公开一个直接 Postgres 连接字符串(Studio → 设置 → 连接),无需中间转换。
# 从仪表板检索 Supabase 连接字符串
export SUPABASE_DB_URL="postgresql://postgres:...@db.xxx.supabase.co:5432/postgres"
# 公共模式转储(没有 Supabase 系统模式)
pg_dump "$SUPABASE_DB_URL" \
--schema=public \
--no-owner --no-acl \
--format=custom \
-f supabase-dump.pgdump
# 检索 Aurabase 连接字符串(Studio → 设置 → 连接)
# ?search_path= 参数是强制性的:它路由到项目的模式
export AURA_DB_URL="postgresql://aura:...@<host>:5432/aura_db_master?search_path=project_<id>"
# 使用标准 pg_restore 恢复
pg_restore --no-owner --no-acl -d "$AURA_DB_URL" supabase-dump.pgdump
# 重新生成 TypeScript 类型
aura db generate > src/aurabase.types.ts
迁移用户
与我们之前所说的相比,有一点需要纠正:Aurabase 使用 Argon2id 对密码进行哈希处理,但 Supabase (GoTrue) 默认使用 bcrypt 对自己的密码进行哈希处理 - 这两种格式不可互换。因此,与大多数迁移一样,您的用户必须重置一次密码。
Aurabase 目前不提供来自 Supabase的批量导入工具。有两种选择:让您的用户重新注册(使用相同的电子邮件地址signUp),或者在触发密码重置之前在管理员端使用 aura auth users create --email <email> 逐一重新创建它们。
Supabase 端的活动会话不会被移植(技术上不可能 - 每个平台都使用自己的密钥签署其 JWT)。用户需要使用新密码再次登录。
调整客户端代码
搜索/替换足以应对 95% 的情况。
// 之前(Supabase)
import { createClient } from '@supabase/supabase-js'
export const supabase = createClient(url, key)
// 之后(Aurabase)
import { createClient } from '@aurabase/aurabase-js'
export const aura = createClient(url, key)
// 其余代码不变:
await aura.from('posts').select('*').eq('author_id', userId)
部署 Edge Functions
Aurabase 为 Edge Functions提供了两个路径:Studio 代码编辑器(Deno 运行时,与 Supabase 相同 - 按原样粘贴函数)和 aura functions deployCLI,其目标是为在 Rust 中编写并在 WASM中编译的函数提供单独的路径。要迁移现有 Deno 代码而不重写,请使用 Studio。
// 工作原理相同,按原样粘贴到 Studio 编辑器中
Deno.serve(async (req) => {
const { name } = await req.json()
return new Response(JSON.stringify({ hello: name }))
})
DNS 切换和生产启动
两种可能的策略。对于 99% 的情况,建议使用第一种。
- 直接切换 — 更改环境变量中的
NEXT_PUBLIC_AURABASE_URL和NEXT_PUBLIC_AURABASE_ANON_KEY,然后重新部署。用户重新连接,一切正常。推荐用于大多数项目。 - 临时双写 — 同时写入 Supabase + Aurabase 48 小时,手动检查关键表的一致性(行计数、校验和),然后关闭 Supabase。关键应用程序的首选。
如果遇到困难,我们会在这里
对于大型项目或具有严格合规性限制的项目,我们的团队可以为您提供迁移支持。请联系我们获取适合您项目的报价。