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

# 郵件供應商配置

配置事務性投遞，並獨立驗證其結果。

## 安裝與配置

在執行任何步驟之前，請閱讀[開始之前](https://supastack.dev/zh-tw/docs/web/before-you-start.md) 和[終端基礎知識](https://supastack.dev/zh-tw/docs/web/terminal-basics.md)。這些說明假設您在 VS Code 中開啟了完整的 supastack monorepo；它的根 package.json 標記儲存庫根。在 pnpm 命令中，工作區包是應用程式或共享程式碼資料夾；在產品中，工作空間是團隊的資料容器和安全邊界。 corepack pnpm --filter ... 從 monorepo 選擇一個包，同時從其根執行命令。如果您僅開啟同步的移動或桌面資料夾，則它不包含 Web 後端、Docker 設定或根指令碼：從此 monorepo 或可訪問的託管伺服器執行後端，並使用平臺資料夾自己的指令碼。環境變數是儲存在本地 .env 檔案或託管儀錶板中的命名設定；更改後重新啟動相關應用程式，並將伺服器機密保留在 NEXT_PUBLIC_ 和 EXPO_PUBLIC_ 值之外。

1、開啟apps/web/.env.local，設定EMAIL_PROVIDER=local進行開發； EMAIL_FROM 是模板使用的發件人標籤。

2. 使用 corepack pnpm --filter @supastack/web dev 從儲存庫根啟動 Web 應用程式，並使用測試地址觸發一次登入或邀請流程。預期：應用程式會記錄本地電子郵件結果，而無需聯絡真正的提供商。僅在驗證其發件人域並限制測試收件人後，才能連線重新傳送、SES 或其他服務。

EMAIL_PROVIDER=local 保持本地確定性交付。對於配置的生產交付，請檢視重新傳送或 SES 介面卡並提供其伺服器憑據。 EMAIL_FROM 必須與所選提供商驗證的身份相符。

```
EMAIL_PROVIDER=local
EMAIL_FROM=supastack <hello@example.test>
# Production adapter configuration is listed in .env.example.
```


## 要複製的命令

按照註釋檢視命令在哪個資料夾中執行。如果標記了兩個終端，請開啟兩個終端視窗，並在使用第二個命令時保持第一個命令執行。

```
corepack pnpm --filter @supastack/web dev
```


## 實現流程

認證與完成訊息走事務性郵件邊界。營銷觸達屬於使用方產品並保持分離。絕不要把這條路徑複用為未經評審的群發子系統。

投遞與生成分開記錄。模型結果可用時，其完成訊息可能失敗。恢復應檢查投遞狀態，而不是把同一結果再生成一遍。


## 驗證與排障

如果沒有出現本地電子郵件，請檢查apps/web/.env.local中是否設定了EMAIL_PROVIDER並重新啟動Web。如果真實提供商拒絕郵件，請確認 EMAIL_FROM 與經過驗證的發件人匹配，並檢查提供商的傳送記錄。即使後續電子郵件失敗，生成的人工智慧答案也能成功；再次執行 AI task 之前請檢查交付情況。

在專用測試環境中驗證收件人限制、發件身份與供應商錯誤。本地介面卡結果不是真實郵件投遞的證據。opt-in 冒煙路徑通過 REAL_SMOKE_EMAIL_ALLOWED_DOMAIN 限制收件人。


## 下一篇

[審計、分析與錯誤](https://supastack.dev/zh-tw/docs/modules/observability.md)