Plausible社区版自定义邮件服务配置指南

在部署Plausible社区版时，邮件通知功能是重要组成部分。虽然官方文档列出了Postmark、Mailgun、Mandrill和SendGrid四种主流邮件服务提供商，但实际业务中可能需要接入其他SMTP兼容的邮件服务。

核心配置原理

Plausible的邮件系统采用适配器模式设计。当MAILER_ADAPTER参数留空时，系统会自动启用标准SMTP协议支持。这意味着任何符合SMTP标准的邮件服务都可以通过基础配置接入，包括企业自建邮件服务器或小众云邮件服务。

详细配置参数

实现自定义邮件服务需要配置以下环境变量：

1. 服务器连接配置

   • SMTP_HOST_ADDR: 邮件服务器地址（如smtp.example.com）
   • SMTP_HOST_PORT: 端口号（通常587或465）
   • SMTP_USER_NAME: 认证用户名
   • SMTP_USER_PWD: 认证密码

2. 安全传输配置

   • SMTP_HOST_SSL_ENABLED: 启用SSL加密（布尔值）
   • SMTP_RETRIES: 发送失败重试次数

3. 发件人标识

   • SMTP_FROM_EMAIL: 显示的发件人邮箱
   • SMTP_FROM_NAME: 显示的发件人名称

典型配置示例

以阿里云企业邮箱为例：

SMTP_HOST_ADDR=smtp.qiye.aliyun.com
SMTP_HOST_PORT=465
SMTP_USER_NAME=[e-mail]
SMTP_USER_PWD=your_password
SMTP_HOST_SSL_ENABLED=true
SMTP_FROM_EMAIL=[e-mail]
SMTP_FROM_NAME=Plausible Analytics

注意事项

1. 端口选择需匹配加密方式：

   • 465端口通常用于SSL加密
   • 587端口通常用于STARTTLS加密

2. 企业自建邮件服务器需确保：

   • 开放对外SMTP访问权限
   • 正确配置SPF/DKIM/DMARC记录
   • 避免被收件方服务器标记为垃圾邮件

3. 测试建议：

   • 先通过命令行工具测试SMTP连通性
   • 检查Plausible日志中的邮件发送记录
   • 验证收件箱是否收到测试邮件

通过这种配置方式，Plausible可以灵活适配各类邮件服务，满足不同组织的部署需求。对于有特殊安全要求的企业，还可以结合TLS证书验证等高级配置实现更安全的邮件传输。