Mailtrain 自托管邮件列表应用安装指南

Mailtrain 自托管邮件列表应用安装指南

mailtrain Self hosted newsletter app 项目地址: https://gitcode.com/gh_mirrors/ma/mailtrain

1. 项目基础介绍

Mailtrain 是一个基于 Node.js (v14+) 和 MySQL (v8+) 或 MariaDB (v10+) 开发的自托管邮件列表管理应用。它允许用户管理订阅者列表、创建邮件模板、发送邮件活动，并提供自动化功能。Mailtrain 适合企业级使用，支持多用户和细粒度的权限管理。

2. 项目使用的关键技术和框架

• Node.js: 服务器端运行环境，用于执行 JavaScript 代码。
• MySQL/MariaDB: 数据库管理系统，用于存储用户数据、订阅者信息、邮件模板等。
• Express: 基于 Node.js 的 Web 应用框架，用于构建和运行 Mailtrain 的服务器端。
• MJML: 一个用于编写电子邮件的标记语言，它转换为 HTML，以适应不同的电子邮件客户端。
• Zone-MTA: 内置邮件传输代理，用于简化邮件发送过程。

3. 项目安装和配置的准备工作

准备环境

• 确保服务器安装了 Node.js (v14+) 和 MySQL (v8+) 或 MariaDB (v10+)。
• 准备好用于访问 Mailtrain 的域名，并配置好 DNS 记录。
• 确保服务器允许 80 (HTTP) 和 443 (HTTPS) 端口的入站连接。

安装步骤

步骤 1: 安装依赖

登录服务器，以 root 用户执行以下命令安装必要的依赖：

对于 CentOS 7:

sudo su -
yum install -y git

对于 Ubuntu 18.04 LTS:

sudo su -
apt-get install -y git

步骤 2: 克隆项目

将 Mailtrain 项目克隆到服务器的 /opt 目录下：

cd /opt
git clone https://github.com/Mailtrain-org/mailtrain.git
cd mailtrain
git checkout v2

步骤 3: 安装 Mailtrain

根据你的操作系统，运行相应的安装脚本。以下为 CentOS 7 的示例：

bash setup/install-centos7-https.sh mailtrain.example.com sbox-mailtrain.example.com lists.example.com admin@example.com

替换 mailtrain.example.com, sbox-mailtrain.example.com, lists.example.com 和 admin@example.com 为你的域名和邮箱地址。

步骤 4: 启动 Mailtrain 服务

启动并设置为开机自启：

systemctl start mailtrain
systemctl enable mailtrain

步骤 5: 访问 Mailtrain

通过浏览器访问 https://mailtrain.example.com，使用默认的 admin 用户和密码 test 登录。

步骤 6: 配置 Mailtrain

在 Mailtrain 管理界面中，更新密码和全局设置。如果需要通过 DKIM 签名邮件，请在发送配置中设置 DKIM 密钥和选择器。

完成以上步骤后，你的 Mailtrain 应该已经可以正常运行，并可以开始创建和管理你的邮件列表了。

mailtrain Self hosted newsletter app 项目地址: https://gitcode.com/gh_mirrors/ma/mailtrain