跳轉到內容
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-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)賬戶、工作區和資料的表真實登入和任何已存資料設定資料庫
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 美元(Next.js(Web)、Expo(iOS 與 Android)、Tauri(macOS 與 Windows 桌面)倉庫任選其一),雙棧 398 美元(任選兩個倉庫),或完整套裝 399 美元(全部三個倉庫與完整 monorepo),每個額外開發者席位 75 美元。套件本身沒有訂閱。本站結賬後通過郵件傳送許可證金鑰,倉庫訪問通過 GitHub 邀請授予。

工作區如何界定我的資料?

使用者記錄按 workspaceId 劃定邊界。身份、許可權、AI 用量、計費事件與審計條目都留在個人工作區邊界內。

後臺任務如何工作?

Trigger.dev 是明確的任務執行時。JobRunner 契約只承諾 enqueue、status 與 cancel——工作流語義保持 Trigger.dev 專有且顯式。

郵件與營銷觸達有何不同?

事務性郵件覆蓋產品工作流,如任務完成通知。冷觸達與營銷活動屬於產品自身的範疇,不在本套件的郵件模組內。

移動端購買如何運作?

移動端已支援 RevenueCat 原生購買和恢復購買,訪問許可權由服務端驗證。釋出前需配置商店賬戶並完成裝置測試。Web 計費保持獨立。

AI 供應商金鑰存放在哪裡?

自帶金鑰憑證經過加密且僅存於服務端。金鑰在日誌中被脫敏;用量與預算在工作區級別保持可見。

結賬支援哪些付款方式?

Stripe 託管結賬接受銀行卡,在 Stripe 賬戶啟用後還可提供支付寶與微信支付——方便中國買家。錢包授權為非同步確認,付款完成後許可證頁面會立即更新。

我能申請退款嗎?

獲得程式碼倉庫訪問許可權後,supastack 將永久歸你所有,因此無法退款。但請放心,你將獲得包含終身更新的完整原始碼,可為你自己或客戶構建併發布無限數量的產品。你只需注意不能轉賣程式碼,也不能將倉庫作為啟動模板二次分發。唯一的例外是上線返現——上線一款用 supastack 打造的真實產品並公開分享,在購買後 60 天內達到 5,000 次自然瀏覽或 50 個自然按讚,即可退還已付款項的 50%;詳見條款。

TW
主題