在AWS上部署Mail for Good邮件营销平台完全指南

在AWS上部署Mail for Good邮件营销平台完全指南

mail-for-good An open source email campaign management tool for nonprofits 项目地址: https://gitcode.com/gh_mirrors/ma/mail-for-good

前言

Mail for Good是一款开源的邮件营销平台，专为非营利组织和教育机构设计。本文将详细介绍如何在AWS云平台上部署该系统的完整流程，从创建EC2实例到最终配置完成，帮助技术爱好者快速搭建自己的邮件服务平台。

准备工作

在开始部署前，请确保：

1. 拥有有效的AWS账户
2. 了解基本的Linux命令操作
3. 准备开发者账号用于OAuth认证

第一部分：创建EC2实例

1. 选择实例类型

登录AWS控制台后，在"构建解决方案"区域选择"启动虚拟机"。这里我们选择EC2实例服务，这是AWS提供的弹性计算服务。

2. 配置实例参数

• 命名实例：建议使用"Mail-for-Good"等有意义的名称
• 操作系统：选择Ubuntu Server（推荐18.04 LTS或更高版本）
• 实例类型：t2.micro（免费套餐适用）

3. 密钥对管理

AWS会自动创建SSH密钥对，这是安全连接实例的关键。请：

1. 下载生成的.pem密钥文件
2. 妥善保存在本地安全位置
3. 建议重命名为"MfG-private-key.pem"便于识别

第二部分：安全组配置

1. 访问安全组设置

通过EC2控制台→实例→安全组，找到关联的安全组规则。

2. 添加入站规则

必须添加以下规则允许HTTP访问：

• 类型：自定义TCP规则
• 协议：TCP
• 端口范围：80
• 来源：0.0.0.0/0（允许所有IP访问）

注意：生产环境建议限制来源IP增强安全性

3. 分配弹性IP

为避免实例重启后公网IP变化，建议：

1. 在EC2控制台创建弹性IP
2. 将弹性IP与实例关联
3. 记录下分配的公网DNS名称

第三部分：连接EC2实例

1. 准备SSH连接

将密钥文件移动到合适位置并设置权限：

chmod 400 ~/MfG-private-key.pem

2. 建立SSH连接

使用以下命令连接实例：

ssh -i "~/MfG-private-key.pem" ubuntu@your-public-dns

成功连接后应看到Ubuntu欢迎信息。

第四部分：安装必要组件

1. 更新系统

sudo apt-get update

2. 安装Docker

Docker是容器化部署的核心组件：

sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    software-properties-common
    
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"
   
sudo apt-get install docker-ce docker-compose

第五部分：OAuth配置

1. 启用API

在开发者控制台：

1. 启用相关API
2. 创建OAuth客户端ID
3. 选择"Web应用"类型

2. 配置授权信息

• 授权JavaScript来源：填写EC2的公网DNS
• 授权重定向URI：填写http://<your-dns>/auth/callback

第六部分：部署Mail for Good

1. 获取源代码

git clone https://github.com/freeCodeCamp/mail-for-good && cd mail-for-good

2. 配置环境变量

复制并编辑.env文件：

cp .env.example .env
nano .env

关键配置项包括：

• CONSUMER_KEY：客户端ID
• CONSUMER_SECRET：客户端密钥
• CALLBACK：回调URL（必须与控制台配置一致）
• ENCRYPTION_PASSWORD：随机加密密码

3. 启动服务

sudo docker-compose up

首次启动会下载依赖镜像，可能需要较长时间。

访问与验证

在浏览器中输入EC2实例的公网DNS地址，应该能看到Mail for Good的登录界面。使用配置的开发者账号即可登录系统。

常见问题排查

1. 连接问题：检查安全组规则和密钥文件权限
2. 登录失败：确认回调URL完全匹配
3. 服务启动失败：检查docker日志和.env文件配置

后续维护建议

1. 定期备份数据库
2. 设置自动化监控
3. 考虑使用Nginx反向代理增加安全性
4. 配置HTTPS加密传输

通过以上步骤，您已成功在AWS上部署了Mail for Good邮件营销平台。这套系统可以帮助组织高效管理邮件列表和发送营销邮件，同时保持对数据的完全控制。

mail-for-good An open source email campaign management tool for nonprofits 项目地址: https://gitcode.com/gh_mirrors/ma/mail-for-good