跳转到内容
supastack
浏览文档
WebNext.js

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/web/external-accounts.md (or send Accept: text/markdown).

创建外部账户

总清单:本套件可以使用哪些外部服务、每项服务能为你带来什么,以及创建它们的顺序。

询问本指南
打开方式

先构建,再付费

套件中的每项功能都先通过一个本地替身运行——一个无需账户即可模拟真实服务的内置适配器。EMAIL_PROVIDER=local 把消息写入预览页面而不是真正发送,AI_PROVIDER=fake 返回确定性的假答案,BILLING_PROVIDER=local 在没有支付服务商的情况下完成结账,JOB_PROVIDER=local 把后台任务排入内存队列而不执行,CAPTCHA_PROVIDER=off 让公开表单保持开放。.env.example 配置出厂即是如此,因此五分钟教程不需要任何付费账户。

只有当你要上线某项功能时才创建对应的真实外部账户:真实登录之前先建数据库,消息必须送达收件箱之前再配邮件服务商,开始收费之前再接支付服务商。下面的每篇指南都会写明控制台页面、要复制的值以及粘贴位置。

完整账户清单

下表列出了 supastack 产品可能用到的每一项外部服务。凡是你的功能不需要的行都可以跳过——纯 Web 起步完全不会碰到移动端和桌面端的行。指南列给出逐步带你操作对应控制台的文档;真正的链接在本页末尾的“从哪开始”一节。

服务它能为你提供什么什么场景需要指南
Postgres 数据库(Supabase、Neon 或 Docker)账户、工作区和数据的表真实登录和任何已存数据设置数据库
StripeWeb 端的银行卡支付与订阅在 Web 应用中收费添加 Stripe 支付
Resend 或 Amazon SES事务性邮件投递登录验证码和收据送达真实收件箱添加 Resend 邮件 / 设置 Amazon SES 邮件
Google Cloud OAuth 客户端“使用 Google 继续”按钮提供 Google 登录添加 Google 登录
GitHub OAuth App“使用 GitHub 继续”按钮提供 GitHub 登录添加 GitHub 登录
AI 服务商密钥(OpenAI、Anthropic 或 OpenRouter)真实的模型回答用真实 AI 任务替代假适配器收集其余提供商密钥
Trigger.dev托管的后台任务运行生产环境的后台工作收集其余提供商密钥
S3 兼容存储桶(如 Cloudflare R2)文件与对象存储上传与已存文件收集其余提供商密钥
Sentry 或 PostHog错误追踪与产品分析生产环境的可观测性收集其余提供商密钥
Cloudflare Turnstile公开表单的垃圾信息检查公开的注册与联系表单收集其余提供商密钥
域名注册商 + DNS你自己的域名公开的 https://yourdomain.com 地址收集其余提供商密钥 / 部署到 Google Cloud
托管(Google Cloud Run 或 VPS + Coolify)Web 应用的公开 HTTPS URL面向真实用户上线部署到 Google Cloud / 部署清单
Expo + EAS原生应用的云端构建Expo Go 预览之外的任何事情创建移动端账户
Apple Developer ProgramiOS 签名、App Store 提交、Sign in with AppleiPhone 发布与 Apple 登录创建移动端账户 / 添加 Apple 登录
Google Play ConsoleAndroid 商店条目Play Store 提交创建移动端账户
RevenueCat经过验证的原生内购与恢复在应用内销售订阅设置 RevenueCat 购买
Apple Developer ID + 签名 CA已签名且经过公证的桌面安装包无警告的公开桌面发布创建桌面端发布账户

合理的创建顺序

按照功能上线的顺序创建账户。对大多数 Web 产品而言,这意味着:1. Postgres 数据库,2. 事务性邮件,3. Google 和/或 GitHub 登录,4. 支付,5. AI 服务商——然后按产品需要再接入存储、后台任务、可观测性和垃圾信息防护。

托管和域名放在最后——公开 URL 只有在有一个可以指向的可用应用时才有意义。移动端账户(Expo、Apple、Google Play、RevenueCat)和桌面端签名账户只有在你到达那些平台时才重要;纯 Web 发布可以完全跳过它们。

把每一个密钥——OAuth 客户端密钥、API 密钥、webhook 签名密钥以及 DATABASE_URL 中的密码——保存在 .env.local 文件或托管方的密钥管理器中。切勿把它们放进 NEXT_PUBLIC_ 或 EXPO_PUBLIC_ 变量,也切勿提交到 Git。

从哪开始

下面的详细指南会逐个点过每个控制台。自上而下进行:登录提供商,然后是支付、邮件和其余提供商密钥的账户演练,然后是你产品要上线的服务对应的提供商设置参考,然后是部署;到达移动端或桌面端时再读平台账户指南。

如果你想继续完成设置,可以阅读《添加 Google 登录》。

常见问题

14 个问题

supastack 是什么?

supastack 是用于构建 AI 驱动 SaaS 产品的模块化基础。它把通用基础设施整合在一起,让你专注于产品专属的功能。

它支持 Web 和移动端吗?

支持。supastack 包含 Next.js 与 Expo 应用,作为 Web 与移动端体验的起点。

包含哪些认证方式?

Better Auth 覆盖邮箱/密码、OTP 与社交登录。个人工作区随账户一起开通,产品记录从第一天起就有边界。

AI 是如何支持的?

supastack 包含可配置的多供应商 AI、用量追踪、预算,以及加密的自带密钥(BYOK)支持。

订阅如何处理?

对于基于该套件构建的产品,Stripe 计费、订阅与权限构成付费访问的基础。供应商密钥仅存于服务端。

我的产品专属代码放在哪里?

产品专属功能保留在独立的代码库中,产品通过配置接入 supastack 的基础模块。

supastack 如何定价?

套件为一次性购买、终身更新:单框架 249 美元(限时优惠价,较常规价 349 美元优惠 100 美元),或全框架(Next.js、iOS、Android)499 美元(限时优惠价,较常规价 599 美元优惠 100 美元),每个额外开发者席位 75 美元。套件本身没有订阅。本站结账后通过邮件发送许可证密钥,仓库访问通过 GitHub 邀请授予。

工作区如何界定我的数据?

用户记录按 workspaceId 划定边界。身份、权限、AI 用量、计费事件与审计条目都留在个人工作区边界内。

后台任务如何工作?

Trigger.dev 是明确的任务运行时。JobRunner 契约只承诺 enqueue、status 与 cancel——工作流语义保持 Trigger.dev 专有且显式。

邮件与营销触达有何不同?

事务性邮件覆盖产品工作流,如任务完成通知。冷触达与营销活动属于产品自身的范畴,不在本套件的邮件模块内。

移动端购买如何运作?

移动端已支持 RevenueCat 原生购买和恢复购买,访问权限由服务端验证。发布前需配置商店账户并完成设备测试。Web 计费保持独立。

AI 供应商密钥存放在哪里?

自带密钥凭证经过加密且仅存于服务端。密钥在日志中被脱敏;用量与预算在工作区级别保持可见。

结账支持哪些付款方式?

Stripe 托管结账接受银行卡,在 Stripe 账户启用后还可提供支付宝与微信支付——方便中国买家。钱包授权为异步确认,付款完成后许可证页面会立即更新。

我能申请退款吗?

获得代码仓库访问权限后,supastack 将永久归你所有,因此无法退款。但请放心,你将获得包含终身更新的完整源代码,可为你自己或客户构建并发布无限数量的产品。你只需注意不能转卖代码,也不能将仓库作为启动模板二次分发。

CN
主题