如何支持该项目
这个解决方案对任何人都是免费使用和学习的。如果您想看到更多类似的项目,请考虑使用我们在AWS Marketplace上的一些产品,或者与您认为可能对使用它们感兴趣的人分享。
📫 S3 邮件
创建这个堆栈是出于对目前仍然没有一种简单方法来拥有完整的邮件服务器而感到沮丧,因为这需要安装和配置所有处理收发邮件所需的服务器。我们想要一个简单的、没有界面和无需服务器管理的解决方案,于是我们想出了S3-Email。这包括使用AWS SES作为我们的邮件服务器(接收和发送)以及S3作为我们的数据库和界面。然后我们通过AWS Lambda用一些代码将所有内容绑定在一起。
结果是一个无需管理的邮件服务器,拥有无限的电子邮件地址,还提供通过在邮件名称中添加+
字符轻松组织邮件的好处。+
被转换为/
,对应于S3中的对象路径。
无限的电子邮件地址
一旦您在SES中添加并确认了您的域名,只要符合电子邮件地址标准,您就可以在@
前面放任何您想要的字符串。这意味着您将拥有无限的电子邮件地址,并且能够以前所未有的方式组织您的生活。例如,您可以为每个注册的服务提供一个特殊的电子邮件:
使用+进行组织
话虽如此,您可以用这种方式使用+
字符组织您的邮件:
- accounts+social+facebook@example.com
- accounts+social+instagram@example.com
- accounts+social+linkedin@example.com
- accounts+travel+car+hertz@example.com
- accounts+travel+air+jetblue@example.com
- accounts+money+paypal@example.com
- 等等
在处理客户时,我们想出了这样的文件夹结构:
- clients+company_name+aws+account_name@example.com
- clients+company_name+stripe@example.com
- clients+company_name+sentry@example.com
- clients+company_name+heroku@example.com
- 等等
对于各种警报,我们喜欢这样分组:
- alarms+company_name+aws+account_name+alarm_type@example.com
- alarms+company_name+sentry+alarm_type@example.com
- 等等
这通过将+
替换为/
字符将所有邮件分组到相应的文件夹中,从而在S3中创建文件夹结构。可能性是无限的。
基本上,就是接收和发送邮件,还有一些技巧。
免责声明!
这个堆栈对任何人都是免费的,但是按原样提供。0x4447 LLC不对您使用该堆栈时可能发生的任何损害或成本负责。使用时您需要承担全部责任。
如何部署
要部署这个堆栈,您只需点击左侧的按钮,然后按照CloudFormation在AWS控制台中提供的说明进行操作。或者您可以从这里下载CF文件。
将部署什么?
该堆栈利用AWS S3、AWS SES、AWS Lambda和AWS触发器系统将所有内容连接在一起。您将获得:
- 1个SES规则集
- 2个S3存储桶
- 1个用于CodePipeline存储构件
- 1个用于存储邮件
- 3个CodePipeline
- 3个CodeBuild
- 3个Lambda
- 1个IAM组
所有项目资源可以在这里找到。
自动部署
该堆栈的设置方式是,每当有新代码推送到选定的分支时,CodePipeline会捕捉到变更并为您更新Lambda。这些是可用的分支:
- master:最新的稳定代码
- development:我们在测试环境中测试的不稳定代码 - 我们不建议您使用这个分支
手动工作
请记住,当您部署时,并非所有内容都能立即正常工作。
向SES确认您拥有该域名
您必须添加您的域名并确认您拥有它。按照以下步骤操作:
- 进入SES控制台。
- 点击左侧菜单中的
Domains
。 - 点击蓝色的
Verify a New Domain
按钮。 - 在模态框中输入您的域名并选择
Generate DKIM Settings
。 - 下一个窗口显示配置域名所需的所有信息。
- 完成后,您需要等待一段时间,直到域名从
待验证
状态变为已验证
状态。
启用SES规则集
部署创建了SES 规则集
。在新的AWS账户上,这应该默认启用,但在您已经有一些规则的账户上,这可能不起作用。这种行为是AWS在CloudFormation中的一个已知bug。采取以下步骤将启用该规则:
- 进入SES控制台。
- 点击左侧菜单中的
Email receiving
。 - 在
All rule sets
标签页中选中0x4447_S3_Email
。 - 点击
Set as active
来激活该规则。
将用户附加到IAM组
堆栈部署后,您将获得一个附加了策略的IAM组,该策略将为使用它的用户提供访问S3存储桶的最低权限,以读取和创建邮件。
SES限制
SES有两个主要限制:
- 出于安全原因,AWS默认每24小时期间发送200封电子邮件,速率为1封/秒。如果您需要发送更多,您需要向AWS申请提高限制。
- 默认情况下,您不能向未验证的地址发送邮件。如果您想能够发送(而不仅仅是接收),您需要联系AWS以从您的账户中移除此限制。
堆栈如何工作
接收电子邮件:
- 电子邮件到达SES并被存储在
TMP
S3文件夹中。 - S3将触发入站Lambda函数,该函数将根据
to
、from
和date
字段组织电子邮件。此外,Lambda将读取添加到SES的域名,并使用该数据来确定电子邮件是应该放入Inbox
还是Sent
文件夹。如果to
字段包含SES中的域名,它将进入Inbox
,如果不是,则假定该电子邮件是发出的。 Inbox
或Sent
文件夹触发另一个Lambda函数,该函数加载原始电子邮件,将其转换为.html
和.txt
文件,并将其与原始消息一起存储,同时将任何附件存储在attachments
中。 除了这个流程外,当有新邮件到达时,会在"Today"文件夹中保存一份副本,以显示哪些邮件是新的。S3存储桶有一个生命周期策略,会删除"Today"文件夹中超过一天的任何邮件。这样你就能随时知道哪些是新邮件。
发送邮件:
- 创建一个格式正确的JSON文件(参见下一节)。
- 将文件保存到"TMP/email_out/json"路径。文件名和扩展名无关紧要,只要内容是文本且为JSON格式即可。
- 这个操作会触发一个Lambda函数,生成原始邮件,使用SES发送,并将原始邮件保存到"Sent"文件夹。
- "Sent"文件夹会触发另一个Lambda函数,加载原始邮件,将其转换为".html"和".txt"文件,并与原始邮件一起存储。
这个流程设计利用了S3触发系统,将每个操作拆分成小型Lambda函数。
如何创建邮件消息
创建一个自定义JSON文件,然后上传到"TMP/email_out/json"文件夹(如果你还没有这个文件夹结构,请先创建)。JSON结构应该如下所示:
{
"from": "name@example.com",
"to": "name@example.com",
"subject": "From SES",
"html": "给你要发送此消息的人写一条友好的信息。",
"text": "给你要发送此消息的人写一条友好的信息。"
}
请记住,"from"字段必须包含你添加到SES的域名。你无法从未验证的域名发送邮件。
备份旧邮件
这个堆栈的一个额外功能是可以处理手动上传的邮件。这得益于堆栈的事件驱动特性。只需将原始邮件上传到"TMP/email_in"文件夹,你的邮件就会被自动处理。
唯一的前提是邮件文件需要是邮件本身的原始表示。例如:以".eml"结尾的文件实际上只是包含邮件原始内容的txt文件。
这意味着你可以直接将这些文件上传到S3存储桶。
定价
通过此堆栈部署的所有资源都可能会产生费用。但要发生这种情况,你需要做以下事情:
- 每月调用Lambda函数超过1,000,000次
- 每月发送和接收超过1000封邮件
- 在S3存储桶中执行超过10,000次Get和Put操作,以及超过2000次Delete操作
- CodeBuild构建时间超过100分钟
- 每个活跃的CodePipeline收费1美元(每月至少运行一次才被视为活跃)
从第一天开始,你唯一会遇到的费用是邮件和CodePipeline工件的S3存储费用。
如何使用这个项目
当你想部署堆栈时,你只需关注"CloudFormation.json"文件。如果你想修改堆栈,我们建议使用Grapes框架,它的设计目的是让处理CloudFormation文件变得更容易。如果你想保持理智,千万不要直接编辑主CF文件🤪。
结语
如果你喜欢这个项目,请考虑给它一个🌟。并查看我们的0x4447 GitHub账户,那里有你可能觉得有用或有趣的其他资源。
赞助 🎊
这个项目由0x4447 LLC带来,这是一家专门在AWS之上构建定制解决方案的软件公司。点击此链接了解更多:https://0x4447.com。或者,发送电子邮件至[hello@0x4447.email](mailto:hello@0x4447.email?Subject=Hello%20From%20Repo&Body=Hi%2C%0A%0AMy%20name%20is%20NAME%2C%20and%20I%27d%20like%20to%20get%20in%20touch%20with%20someone%20at%200x4447.%0A%0AI%27d%20like%20to%20discuss%20the%20following%20topics%3A%0A%0A-%20LIST_OF_TOPICS_TO_DISCUSS%0A%0ASome%20useful%20information%3A%0A%0A-%20My%20full%20name%20is%3A%20FIRST_NAME%20LAST_NAME%0A-%20My%20time%20zone%20is%3A%20TIME_ZONE%0A-%20My%20working%20hours%20are%20from%3A%20TIME%20till%20TIME%0A-%20My%20company%20name%20is%3A%20COMPANY%20NAME%0A-%20My%20company%20website%20is%3A%20https%3A%2F%2F%0A%0ABest%20regards.)。