
摘要: EdgeOne Makers 的 SaaS Starter 模板整合 Supabase 与 Stripe,提供用户认证、数据存储、订阅支付与博客内容能力。本文给出 Supabase 建表与第三方登录、Stripe 密钥与 Webhook、环境变量填写、商品创建的完整配置顺序与关键回调地址格式。
搭一个能收款的 SaaS 站点,真正耗时的不是写页面,而是把用户认证、数据存储、订阅支付三套外部服务的回调地址与密钥对齐。EdgeOne Makers 的 SaaS Starter 模板把这三块的集成代码预置好了,剩下的工作是按正确顺序填配置。顺序很关键:Supabase 建表 → Stripe 拿密钥 → 部署拿到项目域名 → 回填 Stripe Webhook 地址与 Supabase 重定向地址 → 创建商品 → 重新部署。跳步会导致回调地址对不上。
SaaS Starter 模板整合 Supabase 与 Stripe,预置了 SaaS 站点的核心功能矩阵:用户管理、订阅支付、博客内容。
它解决的问题:搭建功能完备的 SaaS 站点需要处理用户认证、数据存储、支付处理等复杂环节,传统开发方式对小团队和个人开发者成本很高。模板的价值在于不用从零构建后端与支付系统。
主要特性:
深度整合 Supabase 做用户认证与数据存储,整合 Stripe 做订阅支付系统。
适用于工具类、内容订阅类等常规 SaaS 站点。
无需自建服务器或维护复杂技术架构。
集成 AI 模块,配置 LLM Key 后可接入多种大模型,并提供 AI 文生图模块。
适用人群:资源有限、需要快速验证商业想法的个人开发者;初期资金和技术资源有限、需要快速把 AI 产品推向市场的创业团队。
Supabase 在这套方案里承担两个角色——存储应用核心数据(用户信息、商品信息、价格信息),以及提供用户认证(邮箱、GitHub、Google 等登录方式)。
第一步:取三个密钥。 完成 Supabase 注册和接入后,进入项目的 Project Settings,找到并记录 Project Url、Anon Public Key、Service_role Secret Key,后续填环境变量要用。
第二步:初始化数据库。 下载模板提供的初始化 SQL 文件,在 Supabase 管理界面导航至 SQL 编辑器,把 SQL 代码完整复制进去,点击 Run 执行。执行成功后会创建所有必要的数据表和关系。
第三步:关闭邮箱验证。 这是一个容易漏掉的步骤——模板没有实现邮箱验证,需要在 Project Settings → Authentication → Sign In / Up 里关闭邮箱验证,否则新用户注册会卡住。
第四步:配置站点 URL 与重定向 URL。 在 Authentication → URL Configuration 中配置 Site URL 和 Redirect URLs。这一步依赖部署后拿到的项目域名,可以先占位、部署后回填。
模板支持 GitHub 登录和 Google 登录,两者的配置模式一致——在第三方平台创建 OAuth 应用拿到 Client ID 与 Client Secret,再填回 Supabase。
回调 URL 格式是关键,两个平台都用同一个格式:
https://${your-supabase-url}/auth/v1/callbackGitHub 配置路径:GitHub 任意页面右上角头像 → Settings → Developer settings → OAuth Apps,创建网站 OAuth 应用,填入网站标志、名称、回调 URL。保存 Client ID 和 Client Secret 后,进入 Supabase 的 Authentication → Sign In/Providers → Auth Providers,选 GitHub,填入两个值并开启。
Google 配置路径:在 Google Auth Platform 创建客户端,填入网站名称、网站 URL、回调 URL。拿到 Client ID 和 Client Secret 后,在 Supabase 的 Auth Providers 里选 Google,填入并开启。
两个平台的 OAuth 应用都要求填写网站 URL——这同样依赖部署后的项目域名,需要在部署完成后回来更新。
第一步:取 Secret key。 注册 Stripe 账户后进入 Dashboard,左侧菜单底部的 Developers → API Keys 标签页,复制并安全保存 Secret key。这个凭据用于建立 EdgeOne Makers 与 Stripe 服务之间的连接。
第二步:创建 Webhook。 左下角 Developer → Webhooks,配置触发器,用于在产品和价格变化时触发 Supabase 的数据更新,保持应用数据同步。
Webhook 的接收端 URL 格式为:
https://${your-app-name}.edgeone.run/api/webhook其中 ${your-app-name} 替换为在 EdgeOne Makers 部署后获得的实际项目名称。这个 URL 可以暂时不填,等项目部署完成后再回来补。 配置完成后,Stripe 会通过这个 Webhook 向 Supabase 发送产品和价格变更通知,触发数据库自动更新。
第三步:保存 Signing secret。 创建 Webhook 后复制 Signing secret 记录下来,后续填环境变量要用。
Contentful(可选)。模板默认引用项目本地 /content 目录的博客和案例研究文章。暂时不配置也能正常运行;需要用 Contentful 动态管理内容时再按集成指引接入。
AI 文生图模型(可选)。模板在使用 AI 模块时会调用大模型,给用户使用前需要预先配置 API Key。环境变量格式如下:
# OpenAI
OPENAI_API_KEY=your-openai-api-key
# Stability AI
STABILITY_API_KEY=your-stability-api-key
# FAL AI
FAL_API_KEY=your-fal-api-key
# FIREWORKS AI
FIREWORKS_API_KEY=your-fireworks-api-key新增其他大模型的做法是在模型配置文件里按同样结构追加:
// src/lib/ai-models-config.ts
export const modelProviderMap = {
'fal-ai/flux/schnell': { provider: createFal, envKey: 'FAL_API_KEY', envName: 'FAL' },
'dall-e-3': { provider: createOpenAI, envKey: 'OPENAI_API_KEY', envName: 'OpenAI' },
'dall-e-2': { provider: createOpenAI, envKey: 'OPENAI_API_KEY', envName: 'OpenAI' },
// ...
}图像生成的调用链路在模板中已实现:解析模型配置 → 构建模型实例 → 构建生成选项 → 调用 AI SDK 生成图像。新增厂商只需在 modelProviderMap 里加一项并配好对应环境变量。
进入控制台的 SaaS Starter 模板页,在部署配置面板填两项。
Project Name。设置后这个名称会成为应用 URL 的一部分。拿到后需要做三件回填工作:把 Stripe Webhook 的 Endpoint URL 补成 ${your-project-name}.edgeone.run/api/webhook;更新第三方登录平台里的网站 URL;更新 Supabase 里的 Site URL 和 Redirect URLs。
Environment Variables。添加所有必要配置参数:
来源 | 需要填入的内容 |
|---|---|
Supabase | Project Url、Anon Public Key、Service_role Secret Key |
Stripe | Secret key、Webhook Signing secret |
AI 模型(可选) | 各厂商的 API Key |
Contentful(可选) | CMS 相关凭据 |
填完点击立即创建开始部署,部署会花费 1~3 分钟。部署失败时根据 Build Logs 和 Build Summary 信息修改项目。
部署成功后还有两步才能看到价格。
创建商品。在 Stripe 控制面板的左侧导航栏访问 Product catalog,点击 Create product 创建新产品。添加产品时必须选择 Recurring——模板是按照订阅逻辑适配的,一次性收费的产品类型不匹配。
创建完成后,产品信息会自动同步至 Supabase 数据库中的 products 表。
重新部署一次。价格页是服务端动态渲染的,商品同步到数据库后需要回控制台重新部署,才能在价格页看到价格等信息。这一步容易被忽略——商品建好了但价格页空白,原因通常就是没有重新部署。
把前面的步骤按依赖关系排成一条线,避免来回返工:
顺序 | 操作 | 产出物 |
|---|---|---|
1 | Supabase 注册、取三个密钥 | Project Url、Anon Key、Service_role Key |
2 | 执行初始化 SQL、关闭邮箱验证 | 完整数据表结构 |
3 | Stripe 注册、取 Secret key | Stripe Secret key |
4 | 填环境变量、设置 Project Name、首次部署 | 项目域名 |
5 | 回填 Stripe Webhook URL、取 Signing secret | Webhook 配置完成 |
6 | 回填 Supabase 的 Site URL 与 Redirect URLs | 认证重定向可用 |
7 | 配置 GitHub / Google OAuth(可选) | 第三方登录可用 |
8 | Stripe 创建 Recurring 商品 | products 表有数据 |
9 | 重新部署 | 价格页显示价格 |
第 4 步是分界线——它之前的配置不依赖项目域名,它之后的配置都要用到。
这套方案的工程量集中在配置对齐,不在写代码。三个最容易卡住的点:忘记在 Supabase 关闭邮箱验证导致注册流程中断;Stripe 创建商品时没选 Recurring 导致订阅逻辑不匹配;商品建好后没有重新部署导致价格页空白。
回调地址有两个固定格式需要记住:第三方登录回调是 https://${your-supabase-url}/auth/v1/callback,Stripe Webhook 是 https://${your-app-name}.edgeone.run/api/webhook。
支付、订阅与用户数据涉及合规要求,上线前请按所在地区的法规核对收款资质、隐私政策与数据存储要求。
产品完整能力与控制台入口见 EdgeOne Makers 产品页:https://cloud.tencent.com/product/makers
当前首购特惠 EdgeOne Makers 专业版 Pro 套餐 39 元/月,具体以活动页实际展示为准:https://cloud.tencent.com/act/pro/makers-pro
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。