在生产环境中掌握Appwrite部署的电子邮件模板定制

在生产环境中运行 Appwrite——尤其是在通过 Digital Ocean Marketplace 等托管平台部署时——通常需要调整电子邮件模板以反映您的品牌身份。本指南将引导您通过使用 Docker 卷挂载实现持久的自定义，确保您的更改在版本升级和容器生命周期事件中得以保存。

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
• 重启或重建容器实例
• 横向扩展基础设施
• 执行维护操作

通过卷挂载实现持久化自定义

Docker 卷挂载提供了解决方案，它通过将您的自定义文件覆盖到容器目录上，同时将文件保留在主机文件系统中——完全独立于容器生命周期。

设置电子邮件模板自定义：实用方法

初始服务器设置

首先建立与您的基础设施的 SSH 连接：