Supabase 开源技术全景解析Postgres 开发平台的核心架构与生态组件【免费下载链接】supabaseThe Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.项目地址: https://gitcode.com/GitHub_Trending/supa/supabase本篇文章基于本仓库中的瑞典语版项目 READMEi18n/README.sv.md其内容与根目录 README.md 保持同源同步展开系统梳理 Supabase 作为 Postgres 开发平台 的产品定位、开箱即用的功能矩阵、底层开源组件架构并结合当前仓库的源码、容器编排与本地配置给出可验证的实现细节。读完本文你可以完整理解 Supabase 用哪些企业级开源组件拼装出 Firebase 级开发体验、官方与社区客户端库的模块化生态以及托管、自托管与本地开发三种形态下如何落地。Supabase 是什么用开源工具重建 Firebase 开发体验Supabase 的自我定位是 Firebase 的开源替代品alternativ till Firebase med öppen källkod其核心理念是用企业级företagsklass的开源产品组合复刻并延伸 Firebase 的开发者体验。与许多人对它 又一个后端即服务 的印象不同README 明确澄清了两点关键事实并非 Firebase 的一比一映射inte en 1-till-1-mappning av FirebaseSupabase 不是去逐项模拟 Firebase 的闭源接口而是围绕 PostgreSQL 这个业界积累深厚的数据库把验证过的开源组件重新组织为一个统一开发平台。组件优先策略如果某项能力已有采用 MIT、Apache 2 或同等宽松许可的开源工具Supabase 直接采用并支持它如果不存在合适的工具Supabase 就自己构建并开源。这套策略直接决定了整个仓库由大量独立可替换的开源子系统构成。从仓库结构也能印证这一理念这是一个包含appsdesign-system、docs、studio、www 等前端应用、docker自托管编排、packages共享包和examples各语言示例的 pnpm monorepo其中studio即官方控制面板、docs承载官方文档站共同构成 README 所述的 托管平台 控制面板 生态。开箱即用的功能矩阵README瑞典语版以功能清单的形式给出了 Supabase 现阶段的完整能力集合每一项都对应官方文档中的独立指南章节功能领域说明托管 Postgres 数据库每个项目获得专属的 Postgres 数据库数据即产品的核心资产认证与授权Auth Authorization用户注册、登录与会话管理对应 GoTrue 组件自动生成的 API三种接口由数据库结构自动派生REST、GraphQL、实时订阅Realtime subscriptions函数Functions分为数据库函数Database Functions与 Edge Functions 两类文件存储Storage基于 S3 的文件管理权限由 Postgres 控制AI 与向量/嵌入工具面向 AI 应用的向量检索与嵌入能力控制面板Dashboard官方提供的 Web 管理界面这套功能矩阵在该仓库中均有对应的真实落点官方控制面板源码位于 apps/studioVite/React 应用含pages、routes、components等目录官方文档站点位于 apps/docs其中含 800 余篇 mdx 内容、覆盖数据库、认证、API、函数、存储与 AI 各主题。README 中引用的 Dashboard 截图在仓库内实际存在于 apps/www/public/images/github/supabase-dashboard.png它展示的是托管平台中项目管理界面的形态。此外README 建议关注该仓库的 releases发布以获得重大更新通知——这是开源项目跟进版本演进的标准做法。底层架构开源组件的组合艺术它如何工作Hur det fungerar一节是整个 README 的技术核心Supabase 本质上是多个成熟开源系统的组合。README 分别描述了每个组件在整体中的职责PostgreSQL对象关系型数据库系统经过三十余年持续开发在可靠性、功能健壮性与性能方面积累深厚口碑是整个平台的基石。Realtime一个 Elixir 服务器通过 WebSocket 让客户端监听 PostgreSQL 的插入、更新与删除。其原理是轮询 Postgres 内置的复制功能replication获取数据库变更将变更转换为 JSON 后经 WebSocket 广播给已授权客户端。PostgREST把 PostgreSQL 数据库直接转换为 RESTful API 的 Web 服务器。pg_graphql一个 PostgreSQL 扩展对外暴露 GraphQL API。Storage提供管理存储于 S3 中文件并以 Postgres 处理权限的 RESTful 接口。postgres-meta管理 Postgres 的 RESTful API可获取表、添加角色、执行查询等。GoTrue基于 SWT 的用户管理与令牌签发 API根目录英文版 README 的表述为 JWT-based authentication API负责简化应用中的用户注册、登录与会话管理。Kong云原生 API 网关README 瑞典语版所列英文版与当前仓库编排默认采用的网关为 Envoy见下文。架构图的仓库级验证README 引用的架构图在仓库内对应 apps/docs/public/img/supabase-architecture.svg它直观呈现了 Studio/Dashboard → API 网关 → 各后端组件 → Postgres 的请求路径与 docker-compose 的服务编排一一对应。如果你希望从文档描述落到可运行的实现最直接的方式是查看自托管编排文件 docker/docker-compose.yml。该文件清晰地定义了一组与上述架构组件对应的服务studio官方控制面板容器通过STUDIO_PG_META_URL: http://meta:8080与 pg-meta 通信api-gw默认 API 网关。值得注意的是当前编排默认使用Envoyimage: envoyproxy/envoy:v1.39.0并在容器网络中以envoy、kong双别名暴露使内部引用任一主机名的配置都能解析到当前生效的网关auth认证服务restREST 层PostgRESTrealtime实时订阅服务storage存储服务metapg-meta 管理服务functionsEdge Functions 运行环境dbPostgres 主库supavisor连接池化组件辅助服务imgproxy图片处理与db-config客户端库模块化设计哲学README 特别阐述了客户端库的组织哲学——模块化modulärt每个子库都是针对单一外部系统的独立实现这是其支持既有工具策略在 SDK 层面的延伸。因此每个语言的生态都遵循同一套划分一个聚合的Supabase客户端内部分别对应 PostgREST、GoTrue、Realtime、Storage、Functions 五个 Feature-Client。该表还以来源区分两类实现官方支持⚡️ Official语言客户端JavaScript / TypeScriptsupabase-js聚合客户端内部拆分为 postgrest-js、auth-js、realtime-js、storage-js、functions-jsFlutter / Dartsupabase-flutter 及 postgrest-dart、gotrue-dart、realtime-dart、storage-dart、functions-dart社区支持 Community语言可用模块情况C#supabase-csharp postgrest/gotrue/realtime/storage/functions 全模块Go无聚合客户端提供 postgrest-go、gotrue-go、storage-go、functions-goJava无聚合客户端提供 gotrue-java、storage-javaKotlinsupabase-kt 各 feature 模块Pythonsupabase-py postgrest-py、gotrue-py、realtime-py、storage-py、functions-pyRubysupabase-rb postgrest-rbgotrue/realtime/storage/functions 未提供Rust仅 postgrest-rsSwiftsupabase-swift 及其 Sources 下的 PostgREST/Auth/Realtime/Storage/Functions 模块在 examples 目录中可以看到大量基于这些客户端库的真实示例例如user-management下按框架与语言组织的 Angular、Expo、Flutter、React、Swift、Vue、Svelte 等项目以及realtime、storage等专项示例可作为 SDK 用法的直接参考。三种使用形态托管、自托管与本地开发README 指出 Supabase 首先是一个托管平台värdplattform——注册后无需安装任何东西即可开始使用同时也支持自托管självhosta与本地开发utveckla lokalt。对自托管与本地开发形态仓库给出了两套互补的实现自托管容器编排docker/docker-compose.yml 顶部注释给出了核心操作命令启动全部服务docker compose up -d停止docker compose down开发模式docker compose -f docker-compose.yml -f ./dev/docker-compose.dev.yml up -d叠加 docker/dev/docker-compose.dev.yml一键重置sh reset.sh此外 docker/README.md 与 docker/CONFIG.md 提供了使用与配置说明docker/volumes/api 下存放网关配置模板.env由 docker/.env.example经 docker/setup.sh、docker/run.sh 引导生成驱动。本地开发配置supabase/config.toml 是本地/自托管形态下 CLI 的配置文件。从其中的节区section能反推出本地运行时会拉起哪些能力[api]、[db]、[studio]、[inbucket]本地邮件测试、[storage]含[storage.buckets.fonts]示例 bucket、[auth]含[auth.email]、[auth.external.apple]等 OAuth 外部登录配置、[functions]本地 Edge Functions以及[remotes.prod]关联远端项目。该仓库还配套了完整的数据库迁移示例见 supabase/migrations覆盖从文档向量检索到错误码表等一系列真实演进。为项目添加 Made with Supabase 徽章README 面向使用 Supabase 构建产品的开发者给出了两枚项目徽章的资源与用法浅色版 apps/www/public/badge-made-with-supabase.svg 与深色版 apps/www/public/badge-made-with-supabase-dark.svg。在 i18n/README.sv.md 中可以看到完整的 Markdown 与 HTML 两种引入写法部署后按徽章资源实际 URL 引用HTML 写法可自定义width与height尺寸。将自己的作品标注为基于 Supabase 构建是开源生态中表达技术栈的常见做法。多语言生态i18n 目录的角色值得特别说明的是本篇文章所依据的 i18n/README.sv.md 属于该仓库的国际化文件体系根目录 README 被翻译为数十种语言统一存放在 i18n 目录并以 i18n/languages.md 作为翻译文件总索引README 中还留有一条维护性注释翻译时只保留指向语言总索引的链接避免在多份文件中维护容易过期的清单。翻译文件末尾还链接到本仓库的开发者入门指南 DEVELOPERS.md其中包含本地环境搭建、贡献流程等说明。这也解释了该仓库能够长期维护如此庞大且与主 README 同步的翻译体系的原因i18n 文件并非静态孤本而是与根 README、AGENTS.md、CLAUDE.md 等协作文档共同维护的开放协作产物。小结透过 i18n/README.sv.md 这份瑞典语版 README我们可以提炼出理解 Supabase 的三条主线定位Firebase 的开源替代但以 Postgres 为核心不是功能的一比一复刻架构用 Postgres Realtime PostgREST pg_graphql Storage postgres-meta GoTrue 网关等开源组件拼装出数据库、认证、API、实时、存储、AI 一体的开发平台——这套架构在 docker/docker-compose.yml 与 supabase/config.toml 中都有可运行、可验证的实现生态模块化客户端库、托管/自托管/本地开发三种形态、i18n 多语言文档共同支撑了其面向全球开发者的开源协作模式。无论你是想在 Supabase 上快速搭建应用、研究其自托管方案还是希望借鉴这套组件化开源平台的架构设计本文梳理的文档脉络与仓库落点都可以作为入门的索引地图。【免费下载链接】supabaseThe Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.项目地址: https://gitcode.com/GitHub_Trending/supa/supabase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Supabase 开源技术全景解析：Postgres 开发平台的核心架构与生态组件
Supabase 开源技术全景解析Postgres 开发平台的核心架构与生态组件【免费下载链接】supabaseThe Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.项目地址: https://gitcode.com/GitHub_Trending/supa/supabase本篇文章基于本仓库中的瑞典语版项目 READMEi18n/README.sv.md其内容与根目录 README.md 保持同源同步展开系统梳理 Supabase 作为 Postgres 开发平台 的产品定位、开箱即用的功能矩阵、底层开源组件架构并结合当前仓库的源码、容器编排与本地配置给出可验证的实现细节。读完本文你可以完整理解 Supabase 用哪些企业级开源组件拼装出 Firebase 级开发体验、官方与社区客户端库的模块化生态以及托管、自托管与本地开发三种形态下如何落地。Supabase 是什么用开源工具重建 Firebase 开发体验Supabase 的自我定位是 Firebase 的开源替代品alternativ till Firebase med öppen källkod其核心理念是用企业级företagsklass的开源产品组合复刻并延伸 Firebase 的开发者体验。与许多人对它 又一个后端即服务 的印象不同README 明确澄清了两点关键事实并非 Firebase 的一比一映射inte en 1-till-1-mappning av FirebaseSupabase 不是去逐项模拟 Firebase 的闭源接口而是围绕 PostgreSQL 这个业界积累深厚的数据库把验证过的开源组件重新组织为一个统一开发平台。组件优先策略如果某项能力已有采用 MIT、Apache 2 或同等宽松许可的开源工具Supabase 直接采用并支持它如果不存在合适的工具Supabase 就自己构建并开源。这套策略直接决定了整个仓库由大量独立可替换的开源子系统构成。从仓库结构也能印证这一理念这是一个包含appsdesign-system、docs、studio、www 等前端应用、docker自托管编排、packages共享包和examples各语言示例的 pnpm monorepo其中studio即官方控制面板、docs承载官方文档站共同构成 README 所述的 托管平台 控制面板 生态。开箱即用的功能矩阵README瑞典语版以功能清单的形式给出了 Supabase 现阶段的完整能力集合每一项都对应官方文档中的独立指南章节功能领域说明托管 Postgres 数据库每个项目获得专属的 Postgres 数据库数据即产品的核心资产认证与授权Auth Authorization用户注册、登录与会话管理对应 GoTrue 组件自动生成的 API三种接口由数据库结构自动派生REST、GraphQL、实时订阅Realtime subscriptions函数Functions分为数据库函数Database Functions与 Edge Functions 两类文件存储Storage基于 S3 的文件管理权限由 Postgres 控制AI 与向量/嵌入工具面向 AI 应用的向量检索与嵌入能力控制面板Dashboard官方提供的 Web 管理界面这套功能矩阵在该仓库中均有对应的真实落点官方控制面板源码位于 apps/studioVite/React 应用含pages、routes、components等目录官方文档站点位于 apps/docs其中含 800 余篇 mdx 内容、覆盖数据库、认证、API、函数、存储与 AI 各主题。README 中引用的 Dashboard 截图在仓库内实际存在于 apps/www/public/images/github/supabase-dashboard.png它展示的是托管平台中项目管理界面的形态。此外README 建议关注该仓库的 releases发布以获得重大更新通知——这是开源项目跟进版本演进的标准做法。底层架构开源组件的组合艺术它如何工作Hur det fungerar一节是整个 README 的技术核心Supabase 本质上是多个成熟开源系统的组合。README 分别描述了每个组件在整体中的职责PostgreSQL对象关系型数据库系统经过三十余年持续开发在可靠性、功能健壮性与性能方面积累深厚口碑是整个平台的基石。Realtime一个 Elixir 服务器通过 WebSocket 让客户端监听 PostgreSQL 的插入、更新与删除。其原理是轮询 Postgres 内置的复制功能replication获取数据库变更将变更转换为 JSON 后经 WebSocket 广播给已授权客户端。PostgREST把 PostgreSQL 数据库直接转换为 RESTful API 的 Web 服务器。pg_graphql一个 PostgreSQL 扩展对外暴露 GraphQL API。Storage提供管理存储于 S3 中文件并以 Postgres 处理权限的 RESTful 接口。postgres-meta管理 Postgres 的 RESTful API可获取表、添加角色、执行查询等。GoTrue基于 SWT 的用户管理与令牌签发 API根目录英文版 README 的表述为 JWT-based authentication API负责简化应用中的用户注册、登录与会话管理。Kong云原生 API 网关README 瑞典语版所列英文版与当前仓库编排默认采用的网关为 Envoy见下文。架构图的仓库级验证README 引用的架构图在仓库内对应 apps/docs/public/img/supabase-architecture.svg它直观呈现了 Studio/Dashboard → API 网关 → 各后端组件 → Postgres 的请求路径与 docker-compose 的服务编排一一对应。如果你希望从文档描述落到可运行的实现最直接的方式是查看自托管编排文件 docker/docker-compose.yml。该文件清晰地定义了一组与上述架构组件对应的服务studio官方控制面板容器通过STUDIO_PG_META_URL: http://meta:8080与 pg-meta 通信api-gw默认 API 网关。值得注意的是当前编排默认使用Envoyimage: envoyproxy/envoy:v1.39.0并在容器网络中以envoy、kong双别名暴露使内部引用任一主机名的配置都能解析到当前生效的网关auth认证服务restREST 层PostgRESTrealtime实时订阅服务storage存储服务metapg-meta 管理服务functionsEdge Functions 运行环境dbPostgres 主库supavisor连接池化组件辅助服务imgproxy图片处理与db-config客户端库模块化设计哲学README 特别阐述了客户端库的组织哲学——模块化modulärt每个子库都是针对单一外部系统的独立实现这是其支持既有工具策略在 SDK 层面的延伸。因此每个语言的生态都遵循同一套划分一个聚合的Supabase客户端内部分别对应 PostgREST、GoTrue、Realtime、Storage、Functions 五个 Feature-Client。该表还以来源区分两类实现官方支持⚡️ Official语言客户端JavaScript / TypeScriptsupabase-js聚合客户端内部拆分为 postgrest-js、auth-js、realtime-js、storage-js、functions-jsFlutter / Dartsupabase-flutter 及 postgrest-dart、gotrue-dart、realtime-dart、storage-dart、functions-dart社区支持 Community语言可用模块情况C#supabase-csharp postgrest/gotrue/realtime/storage/functions 全模块Go无聚合客户端提供 postgrest-go、gotrue-go、storage-go、functions-goJava无聚合客户端提供 gotrue-java、storage-javaKotlinsupabase-kt 各 feature 模块Pythonsupabase-py postgrest-py、gotrue-py、realtime-py、storage-py、functions-pyRubysupabase-rb postgrest-rbgotrue/realtime/storage/functions 未提供Rust仅 postgrest-rsSwiftsupabase-swift 及其 Sources 下的 PostgREST/Auth/Realtime/Storage/Functions 模块在 examples 目录中可以看到大量基于这些客户端库的真实示例例如user-management下按框架与语言组织的 Angular、Expo、Flutter、React、Swift、Vue、Svelte 等项目以及realtime、storage等专项示例可作为 SDK 用法的直接参考。三种使用形态托管、自托管与本地开发README 指出 Supabase 首先是一个托管平台värdplattform——注册后无需安装任何东西即可开始使用同时也支持自托管självhosta与本地开发utveckla lokalt。对自托管与本地开发形态仓库给出了两套互补的实现自托管容器编排docker/docker-compose.yml 顶部注释给出了核心操作命令启动全部服务docker compose up -d停止docker compose down开发模式docker compose -f docker-compose.yml -f ./dev/docker-compose.dev.yml up -d叠加 docker/dev/docker-compose.dev.yml一键重置sh reset.sh此外 docker/README.md 与 docker/CONFIG.md 提供了使用与配置说明docker/volumes/api 下存放网关配置模板.env由 docker/.env.example经 docker/setup.sh、docker/run.sh 引导生成驱动。本地开发配置supabase/config.toml 是本地/自托管形态下 CLI 的配置文件。从其中的节区section能反推出本地运行时会拉起哪些能力[api]、[db]、[studio]、[inbucket]本地邮件测试、[storage]含[storage.buckets.fonts]示例 bucket、[auth]含[auth.email]、[auth.external.apple]等 OAuth 外部登录配置、[functions]本地 Edge Functions以及[remotes.prod]关联远端项目。该仓库还配套了完整的数据库迁移示例见 supabase/migrations覆盖从文档向量检索到错误码表等一系列真实演进。为项目添加 Made with Supabase 徽章README 面向使用 Supabase 构建产品的开发者给出了两枚项目徽章的资源与用法浅色版 apps/www/public/badge-made-with-supabase.svg 与深色版 apps/www/public/badge-made-with-supabase-dark.svg。在 i18n/README.sv.md 中可以看到完整的 Markdown 与 HTML 两种引入写法部署后按徽章资源实际 URL 引用HTML 写法可自定义width与height尺寸。将自己的作品标注为基于 Supabase 构建是开源生态中表达技术栈的常见做法。多语言生态i18n 目录的角色值得特别说明的是本篇文章所依据的 i18n/README.sv.md 属于该仓库的国际化文件体系根目录 README 被翻译为数十种语言统一存放在 i18n 目录并以 i18n/languages.md 作为翻译文件总索引README 中还留有一条维护性注释翻译时只保留指向语言总索引的链接避免在多份文件中维护容易过期的清单。翻译文件末尾还链接到本仓库的开发者入门指南 DEVELOPERS.md其中包含本地环境搭建、贡献流程等说明。这也解释了该仓库能够长期维护如此庞大且与主 README 同步的翻译体系的原因i18n 文件并非静态孤本而是与根 README、AGENTS.md、CLAUDE.md 等协作文档共同维护的开放协作产物。小结透过 i18n/README.sv.md 这份瑞典语版 README我们可以提炼出理解 Supabase 的三条主线定位Firebase 的开源替代但以 Postgres 为核心不是功能的一比一复刻架构用 Postgres Realtime PostgREST pg_graphql Storage postgres-meta GoTrue 网关等开源组件拼装出数据库、认证、API、实时、存储、AI 一体的开发平台——这套架构在 docker/docker-compose.yml 与 supabase/config.toml 中都有可运行、可验证的实现生态模块化客户端库、托管/自托管/本地开发三种形态、i18n 多语言文档共同支撑了其面向全球开发者的开源协作模式。无论你是想在 Supabase 上快速搭建应用、研究其自托管方案还是希望借鉴这套组件化开源平台的架构设计本文梳理的文档脉络与仓库落点都可以作为入门的索引地图。【免费下载链接】supabaseThe Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.项目地址: https://gitcode.com/GitHub_Trending/supa/supabase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考