> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 配置

讓應用配置保持顯式，供應商憑證留在服務端。

## 進行一項配置更改並檢查它

從正在執行的 Web 應用程式開始。在編輯器中開啟apps/web/.env.local；如果不存在，請使用 Web 教程將 .env.example 複製到那裡。對於無害的首次檢查，請找到 EMAIL_PROVIDER=local 並將其保留在本地。此設定將產品電子郵件傳送到本地預覽而不是真正的收件箱。不要將 KEY=value 線貼上到終端中。

對於您啟用的每項服務，請遵循該提供商的設定指南，僅替換指定值，儲存檔案，使用 Ctrl + C 停止 Web 伺服器，然後使用以下命令重新啟動。如果驗證指定了丟失的金鑰，請重新開啟此檔案並將該金鑰與提供程式指南進行比較。僅對資料庫遷移使用的值保持 root .env 同步；單獨複製它不會配置 Next.js。

[查詢配置金鑰](https://supastack.dev/zh-tw/docs/web/project-structure.md)

[瞭解如何執行命令和編輯檔案](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)

```
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
```


如果你想繼續完成設定，可以閱讀《[設定資料庫](https://supastack.dev/zh-tw/docs/web/setup-database.md)》。


## 下一篇

[構建你的第一個功能](https://supastack.dev/zh-tw/docs/web/first-feature.md)