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/configuration.md (or send Accept: text/markdown).
配置
讓應用配置保持顯式，供應商憑證留在服務端。
進行一項配置更改並檢查它
從正在執行的 Web 應用程式開始。在編輯器中開啟apps/web/.env.local；如果不存在，請使用 Web 教程將 .env.example 複製到那裡。對於無害的首次檢查，請找到 EMAIL_PROVIDER=local 並將其保留在本地。此設定將產品電子郵件傳送到本地預覽而不是真正的收件箱。不要將 KEY=value 線貼上到終端中。
對於您啟用的每項服務，請遵循該提供商的設定指南，僅替換指定值，儲存檔案，使用 Ctrl + C 停止 Web 伺服器，然後使用以下命令重新啟動。如果驗證指定了丟失的金鑰，請重新開啟此檔案並將該金鑰與提供程式指南進行比較。僅對資料庫遷移使用的值保持 root .env 同步；單獨複製它不會配置 Next.js。
corepack pnpm --filter @supastack/web dev你最先真正要改的設定
儲存庫根部的 .env.example 是套件認識的全部設定清單；不在那個檔案裡的名字就不存在。開頭你只會動少數幾個——其餘保持預設，直到某篇提供商指南要求它們。
各應用讀哪個檔案：根部 .env 供給遷移命令，apps/web/.env.local 供給 Next.js 伺服器，apps/mobile/.env.local 供給 Expo。改一個檔案不會配置其餘幾個，所以 DATABASE_URL 同時存在於根部 .env 和 apps/web/.env.local。
APP_URL——應用所在的地址；本地是http://localhost:3000，生產環境是你的域名。DATABASE_URL——遷移與伺服器共用的 Postgres 連線字串。AUTH_SECRET和CREDENTIAL_ENCRYPTION_KEY——生成的機密；node scripts/setup-env.mjs會替你填好（該助手隨 Web 儲存庫和 All Platforms monorepo 附帶）。- 提供商選擇器——
EMAIL_PROVIDER、AI_PROVIDER、BILLING_PROVIDER、JOB_PROVIDER、CAPTCHA_PROVIDER——各自決定執行哪個介面卡；local/fake/off預設值不需要賬戶。 RESEND_API_KEY、STRIPE_SECRET_KEY等提供商機密——只在對應提供商指南要求時再新增。
從環境示例開始
根目錄的 .env.example 是配置清單。共享校驗在 packages/config。把選定的應用環境與供應商模式放在一起審閱；本地介面並不等於生產憑證策略。
無憑證的參考模式要求 local/test 應用配置與 fake/本地供應商。選擇生產供應商會改變執行要求。
讓金鑰留在 API 之後
認證金鑰、資料庫憑證、供應商金鑰、Stripe 金鑰與 Trigger 憑證都屬於服務端。絕不要給它們加 NEXT_PUBLIC_ 或 EXPO_PUBLIC_ 字首。安裝過程中不要列印它們，也不要把它們放進錯誤響應。
瀏覽器只拿到公開配置與允許的模型別名。工作區歸屬、許可權決策、預算與供應商選擇都由服務端強制執行。
先用再信：檢查變更
通過現有的 config 包校驗配置，並執行相關的確定性測試。準備好驗證真實整合時，再走單獨 opt-in 的供應商冒煙路徑。
corepack pnpm test
corepack pnpm check
corepack pnpm build如果你想繼續完成設定，可以閱讀《設定資料庫》。