新Publication of @aurabase/aurabase-js v0.7.5 NPM Packages & Rust Crate v0.1.2查看变更日志 →

工程 · 6 最小读取值

将 Supabase 迁移到 Aurabase,保留 RLS

Affane Daylami · Fondateur · 2026年9月20日

返回博客

如果您正在使用 Supabase 并且正在关注 Aurabase (请参阅我们的详细比较),好消息是最难的部分是选择。下表准确列出了迁移中的变化 - 很简短:架构、RLS 策略、SDK、身份验证和存储保持不变。

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

在 Aurabase,我们从设计阶段就给自己施加了强烈的约束:SDK 表面和 RLS 约定必须与 直接兼容 和 Supabase。相同的 createClient()、相同的 .from().select().eq()、相同的 SQL Postgres 策略。我们的想法是:如果你想离开,那就离开——我们让它变得微不足道。这是完整的剧本。

#
事前审核

什么移动,什么留下

在开始之前,列出将要更改的内容和将保留的内容。剧透:大多数人仍然存在。

Postgres 架构相同pg_dump → pg_restore。扩展、触发器、函数、索引——一切顺利。
RLS 政策相同相同的语法。 auth.uid()、auth.role()、auth.jwt() 按原样工作。
JavaScript SDK95% 相同将 @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 · 我们帮助您找到方向。
#
步骤1

创建目标 Aurabase 项目

使用官方 CLI 创建一个新的 Aurabase 项目,然后将此文件夹链接到该项目,以便以下命令自动应用于它。

terminalbash
# 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
#
步骤2

转储 Supabase,恢复 Aurabase

标准 pg_dump / pg_restore: Aurabase 为每个项目公开一个直接 Postgres 连接字符串(Studio → 设置 → 连接),无需中间转换。

terminalbash
# 从仪表板检索 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
#
步骤3

迁移用户

与我们之前所说的相比,有一点需要纠正:Aurabase 使用 Argon2id 对密码进行哈希处理,但 Supabase (GoTrue) 默认使用 bcrypt 对自己的密码进行哈希处理 - 这两种格式不可互换。因此,与大多数迁移一样,您的用户必须重置一次密码。

Aurabase 目前不提供来自 Supabase的批量导入工具。有两种选择:让您的用户重新注册(使用相同的电子邮件地址signUp),或者在触发密码重置之前在管理员端使用 aura auth users create --email <email> 逐一重新创建它们。

信息

Supabase 端的活动会话不会被移植(技术上不可能 - 每个平台都使用自己的密钥签署其 JWT)。用户需要使用新密码再次登录。

#
步骤4

调整客户端代码

搜索/替换足以应对 95% 的情况。

lib/supabase.ts → lib/aurabase.tstypescript
// 之前(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)
#
步骤5

部署 Edge Functions

Aurabase 为 Edge Functions提供了两个路径:Studio 代码编辑器(Deno 运行时,与 Supabase 相同 - 按原样粘贴函数)和 aura functions deployCLI,其目标是为在 Rust 中编写并在 WASM中编译的函数提供单独的路径。要迁移现有 Deno 代码而不重写,请使用 Studio。

functions/hello/index.tstypescript
// 工作原理相同,按原样粘贴到 Studio 编辑器中
Deno.serve(async (req) => {
  const { name } = await req.json()
  return new Response(JSON.stringify({ hello: name }))
})
#
割接

DNS 切换和生产启动

两种可能的策略。对于 99% 的情况,建议使用第一种。

  1. 直接切换 — 更改环境变量中的 NEXT_PUBLIC_AURABASE_URL 和 NEXT_PUBLIC_AURABASE_ANON_KEY,然后重新部署。用户重新连接,一切正常。推荐用于大多数项目。
  2. 临时双写 — 同时写入 Supabase + Aurabase 48 小时,手动检查关键表的一致性(行计数、校验和),然后关闭 Supabase。关键应用程序的首选。
#
帮助

如果遇到困难,我们会在这里

对于大型项目或具有严格合规性限制的项目,我们的团队可以为您提供迁移支持。请联系我们获取适合您项目的报价。

请求支持 →

准备好部署了吗?

五分钟内完成您的后端。

无需信用卡 · 500 MB 免费 · 50,000 MAU