Reflex 与 Supabase 集成指南为纯 Python Web 应用接入托管 Postgres 与实时数据能力【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflexSupabase 是一个托管 Postgres 数据库服务平台在 PostgreSQL 之上提供了实时订阅、认证与文件存储等能力。通过 Reflex 的 Supabase 集成你的应用可以直接查询和更新托管数据库中的数据为仪表盘、内部工具或 AI 工作流提供安全的数据底座。本文以 supabase.md 为骨架结合 Reflex 的数据库机制、配置系统与密钥管理实践完整讲解从获取凭据、配置集成到安全使用的全过程。什么是 Supabase 集成Supabase Integration允许你的 Reflex 应用连接到 Supabase——一个托管的 Postgres 数据库服务提供实时订阅、身份认证和文件存储能力。一旦连接成功应用即可安全地查询和更新数据支撑仪表盘展示并让工作流实时同步。与 Reflex 中通用的 Database Integration面向 PostgreSQL、MySQL、MSSQL、SQLite 等任意 SQL 数据库不同Supabase 集成针对 Supabase 托管平台做了开箱即用的对接你只需提供项目 URL 和 API Key即可获得一个生产就绪的托管数据库连接。接入后你可以做什么接入 Supabase 后你的 Reflex 应用可以读写数据通过简单的 REST 或客户端 API 使用 Postgres 存取数据实时更新启用实时订阅能力数据变更自动同步到 UI安全控制利用行级安全Row-Level SecurityRLS与访问控制进行安全的数据管理文件存储通过 Supabase Storage 存储和检索文件无缝集成与 AI 应用、仪表盘或内部工具深度结合。第一步获取 Supabase URL 与 Key在配置集成之前需要先从 Supabase 控制台取得两项凭据登录你的 Supabase 项目 控制台选择要连接的项目进入Project Settings项目设置打开Data API页面复制Supabase_URL打开API Keys页面复制Supabase_Key即 secret key。示例值如下URL 示例https://your-project.supabase.coKey 示例sb_xxxxxxxxxxxxxxxxxxxxxxxxxxxx.注意Supabase_Key是敏感凭据。请务必只在受信任的服务端环境中使用切勿将其暴露在客户端代码中详见后文密钥安全一节。第二步在应用中配置集成拿到凭据后在 Reflex 应用中进行配置打开应用设置进入Integrations集成→ Add Supabase将Supabase URL与Supabase Key粘贴到对应字段点击Connect连接系统会校验并保存该集成。连接成功后你的应用即可直接从工作流和 UI 操作中查询、更新 Supabase 数据库。该集成保存在项目级别之后可以在具体应用的Integrations面板中按需启用这一设计与 Database Integration 中集成保存在项目级、按应用启用的模型保持一致。连接之后在 Reflex 中如何使用 Supabase 数据Supabase 的底层就是 Postgres因此连接之后你可以直接沿用 Reflex 对 SQL 数据库的标准支持来读写数据。Reflex 使用 sqlmodel。配置数据库连接在rxconfig.py中通过db_url指向你的数据库即可# rxconfig.py import reflex as rx config rx.Config( app_namemy_app, db_urlpostgresql://user:passwordhost:5432/database, )从源码实现看db_url正是 Reflex 创建数据库引擎的入口在 reflex/model.py 中create_engine_and_session_maker等函数会读取conf.db_url并据此创建 SQLAlchemy 引擎见 reflex/model.py#L86、reflex/model.py#L105表结构的创建则通过ModelRegistry.get_metadata().create_all(engine)完成见 reflex/model.py#L125-L128。也就是说只要db_url正确指向 Supabase 的 Postgres 实例Reflex 的 ORM 体系就能直接工作。需要留意的是Supabase 的 Postgres 连接通常要求启用 SSL 传输加密具体连接串格式遵循 SQLAlchemy 的 URL 规范见 docs/database/overview.md#L44-L47并请确保已安装对应的 DBAPI 驱动如psycopg。定义表并查询连接就绪后用rx.Model定义表结构class Product(rx.Model, tableTrue): name: str price: float stock: int用rx.session()进行读写它会自动管理连接的打开与关闭with rx.session() as session: session.add(Product(nameReflex T-Shirt, price29.9, stock100)) session.commit()首次在新应用中使用数据库功能前需要执行reflex db init初始化 Alembic 并生成当前 schema 的迁移脚本之后 schema 变更通过reflex db makemigrations生成迁移、reflex db migrate应用迁移详见 docs/database/overview.md#L61-L79。这套流程同样适用于连接 Supabase 的 Postgres 实例。第三步注意事项与安全最佳实践原文档对使用 Supabase 集成提出了明确的安全与运维要求逐条展开如下密钥安全绝不写入客户端代码Supabase_Key属于服务端凭据永远不要将其暴露在客户端代码中。一旦密钥随前端分发任何访问页面的人都能直接读取并滥用你的数据库权限。请只在服务端逻辑事件处理器、后端任务中使用该密钥。使用环境相关的独立密钥为开发dev、预发布staging和生产production分别创建独立的 Supabase 项目与密钥以实现干净的环境隔离和访问控制。不同环境的凭据互不串用即便某个环境的密钥泄露也不会波及其他环境的数据。结合 Reflex 的密钥管理实践Reflex 应用支持通过环境变量覆盖rxconfig.py中的任何配置项——环境变量采用REFLEX_前缀加参数名大写的形式且优先级高于配置文件见 docs/advanced_onboarding/configuration.md#L28-L38。数据库连接串对应地可通过REFLEX_DB_URL注入REFLEX_DB_URLpostgresql://user:passwordhost:5432/database uv run reflex run同时Reflex 支持通过env_file配置或REFLEX_ENV_FILE环境变量加载 dotenv 格式的.env文件这需要安装python-dotenv见 docs/advanced_onboarding/configuration.md#L50-L63config rx.Config( app_namemy_app, env_file.env, )在 Reflex Build 平台中更推荐将 API Key、数据库 URL 等敏感配置存入Secrets应用会在运行时以环境变量的形式接收这些值见 docs/ai_builder/features/secrets.md。切忌把密钥写进提示词、知识库、源码或截图。实时同步RealtimeSupabase 原生支持实时数据同步数据库中的变更可以实时推送驱动 Reflex 应用中的 UI 自动更新非常适合仪表盘、协作工具等需要即时反馈的场景。行级安全RLS务必为表配置合适的 RLS 策略。行级安全允许你按用户、角色或业务条件限制对数据的访问粒度是托管数据库多租户场景下的一道重要防线。策略应遵循最小权限原则只开放业务所需的读写范围。常见连接问题排查若集成连接失败可参考 Database Integration 提供的通用排查思路确认 Supabase 项目可达URL 拼写正确形如https://your-project.supabase.co确认网络端口开放、Key 有效且未被撤销确认数据库用户具备应用所需的表结构读取权限且只拥有业务需要的数据权限若使用代理或隧道方式访问确认转发链路配置正确。小结Reflex 的 Supabase 集成把托管 Postgres 实时订阅 文件存储能力以最简方式接入纯 Python Web 应用在 Supabase 控制台复制Supabase_URL与Supabase_Key在应用设置的Integrations → Add Supabase中粘贴并点击Connect即可完成连接。连接之后既可借助 Reflex 的 sqlmodel ORMdb_urlrx.Modelrx.session()直接读写 Postgres 数据也可结合 RLS、实时订阅与密钥管理最佳实践构建安全、实时的数据驱动应用。【免费下载链接】reflex️ Web apps in pure Python 项目地址: https://gitcode.com/GitHub_Trending/re/reflex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考