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) | 账户、工作区和数据的表 | 真实登录和任何已存数据 | 设置数据库 |
| Stripe | Web 端的银行卡支付与订阅 | 在 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 Program | iOS 签名、App Store 提交、Sign in with Apple | iPhone 发布与 Apple 登录 | 创建移动端账户 / 添加 Apple 登录 |
| Google Play Console | Android 商店条目 | 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。
从哪开始
下面的详细指南会逐个点过每个控制台。自上而下进行:登录提供商,然后是支付、邮件和其余提供商密钥的账户演练,然后是你产品要上线的服务对应的提供商设置参考,然后是部署;到达移动端或桌面端时再读平台账户指南。