在生產環境中掌握 Email 模板自訂化的 Appwrite 部署

在生產環境中運行 Appwrite—尤其是透過像 Digital Ocean Marketplace 這樣的管理平台部署時—通常需要調整電子郵件範本以反映您的品牌身份。本指南將引導您使用 Docker volume 掛載來實現持久的自訂，確保您的更改在版本升級和容器生命周期事件中得以保存。

Appwrite 的電子郵件基礎架構運作方式

支援 Appwrite 的電子郵件系統依賴兩個相互連結的層級：

範本層 (TPL 檔案)：負責電子郵件結構的 HTML 標記檔案，存放於 /usr/src/code/app/config/locale/templates/

本地化層 (JSON 檔案)：按語言組織的文字內容與翻譯，位於 /usr/src/code/app/config/locale/translations/

平台內包含數個預先配置的範本：

• email-magic-url.tpl – 無密碼認證訊息
• email-inner-base.tpl – 帳戶恢復通訊
• email-otp.tpl – 一次性驗證碼
• email-mfa-challenge.tpl – 多重驗證提示
• email-session-alert.tpl – 登入活動通知

為何在生產環境中直接編輯容器會失敗

預建的 Appwrite 發行版將所有內容打包在 Docker 容器中。試圖直接修改運行中的容器內的範本檔案會造成一個嚴重問題：所有修改在以下情況下都會消失：

• 升級到較新版本的 Appwrite
• 重啟或重建容器實例
• 水平擴展基礎設施
• 執行維護操作

利用 Volume 掛載實現持久自訂

Docker volume 掛載提供了解決方案，將您的自訂檔案覆蓋到容器目錄上，同時將它們存放在主機檔案系統中——完全獨立於容器的生命週期。

設置電子郵件範本自訂的實務方法

初始伺服器設置

首先建立與您的基礎架構的 SSH 連線：