Mailtrain v2 自托管邮件列表系统全面指南

Mailtrain v2 自托管邮件列表系统全面指南

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

项目概述

Mailtrain 是一个基于 Node.js 和 MySQL/MariaDB 的自托管邮件列表管理系统，专为需要完全控制数据和技术栈的用户设计。作为传统邮件营销服务（如 MailChimp）的开源替代品，它提供了完整的订阅者管理、邮件模板设计和批量发送功能。

核心功能特性

1. 订阅者管理：

   • 支持多列表管理
   • 自定义字段设置
   • 批量导入/导出功能
   • 订阅表单嵌入

2. 高级分段功能：

   • 基于订阅者属性的动态分组
   • 行为触发条件设置
   • 复杂查询构建器

3. 邮件设计系统：

   • 响应式邮件模板
   • 可视化编辑器
   • 代码编辑模式
   • A/B测试支持

4. 发送与投递：

   • 定时发送
   • 发送速率控制
   • 投递状态跟踪
   • 退信处理

技术架构要求

基础环境

• Node.js v10+ 运行时环境
• MySQL v8+ 或 MariaDB v10+ 数据库
• Redis（可选，用于多进程会话管理）

推荐配置

• 2GB+ 内存
• 2CPU+ 处理器
• 20GB+ 存储空间（根据订阅者数量调整）

安装部署方案

Ubuntu 系统一键安装

对于全新 Ubuntu 服务器，可使用自动化安装脚本：

curl -sL 安装脚本地址 | sudo bash

此脚本将自动配置：

• Node.js 运行环境
• MariaDB 数据库
• 防火墙规则（开放 22,25,80,443 端口）
• ZoneMTA 邮件传输代理
• Redis 缓存服务
• 日志轮转配置
• 系统服务管理

Docker 容器化部署

适合已有 Docker 环境的用户：

1. 克隆代码仓库
2. 复制并修改 docker-compose.override.yml 配置文件
3. 启动服务栈：

   docker-compose up -d
   

手动安装（通用方案）

1. 获取源代码
2. 安装依赖：

   npm install --production
   

3. 复制并修改配置文件：

   cp config/default.toml config/production.toml
   

4. 启动服务：

   NODE_ENV=production npm start
   

关键配置项详解

邮件投递优化配置

1. SPF 记录配置：

   • 在发送域名的 DNS 中添加 TXT 记录
   • 示例：v=spf1 mx a a:mail.example.net -all

2. DKIM 签名设置：

   • 生成密钥对：

     openssl genrsa -out domain.key 2048
     openssl rsa -in domain.key -pubout -out domain.pub
     

   • 添加 DNS TXT 记录：default._domainkey.domain.com

3. DMARC 策略：

   • 建议初始配置：v=DMARC1; p=none
   • 稳定后调整为：v=DMARC1; p=reject

4. PTR 反向解析：

   • 确保服务器 IP 的反向解析与发送域名匹配
   • 需联系主机提供商设置

退信处理机制

Mailtrain 支持多种退信处理方式：

1. Webhook 集成：

   • AWS SES
   • SparkPost
   • SendGrid
   • Mailgun
   • ZoneMTA

2. VERP 技术：

   • 需要配置专用 MX 记录
   • 适用于自建邮件服务器环境

3. Postfix 日志分析：

   • 通过 TCP 5699 端口接收日志
   • 实时解析退信信息

安全最佳实践

1. 初始安全设置：

   • 首次登录后立即修改 admin 密码
   • 禁用示例账户

2. 访问控制：

   • 配置 HTTPS 加密
   • 设置 IP 访问限制
   • 启用双因素认证

3. 数据保护：

   • 定期数据库备份
   • 敏感字段加密
   • 访问日志审计

性能调优建议

1. 数据库优化：

   • 为订阅者表添加适当索引
   • 定期执行 OPTIMIZE TABLE

2. Redis 配置：

   • 启用持久化
   • 调整内存分配策略

3. 发送性能：

   • 根据服务器配置调整并发数
   • 监控系统资源使用情况

常见问题解决方案

1. 邮件进入垃圾箱：

   • 检查 SPF/DKIM/DMARC 配置
   • 验证 PTR 记录
   • 测试邮件内容评分

2. 发送速度慢：

   • 检查网络带宽
   • 调整 ZoneMTA 队列配置
   • 验证 DNS 解析速度

3. 订阅表单不工作：

   • 检查 CORS 配置
   • 验证 JavaScript 加载顺序
   • 测试跨域请求

系统监控与维护

1. 健康检查：

   • 设置定时服务状态检测
   • 监控队列积压情况

2. 日志分析：

   • 集中收集访问日志
   • 设置异常告警

3. 升级策略：

   • 建立测试环境
   • 制定回滚方案
   • 监控升级后性能

Mailtrain 作为功能完善的自托管解决方案，既适合小型社区通讯，也能扩展支持大规模商业邮件发送需求。通过合理配置和持续维护，可以构建出完全自主可控的高效邮件营销平台。

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