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-tw/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。
從哪開始
下面的詳細指南會逐個點過每個控制台。自上而下進行:登入提供商,然後是支付、郵件和其餘提供商金鑰的賬戶演練,然後是你產品要上線的服務對應的提供商設定參考,然後是部署;到達移動端或桌面端時再讀平臺賬戶指南。
如果你想繼續完成設定,可以閱讀《新增 Google 登入》。