sensebox/sensebox-mailer

sensebox-mailer

镜像概述

该镜像为openSenseMap生态系统中的核心邮件服务组件，用于为openSenseMap-API及其他关联服务提供模板化邮件发送能力。采用Golang开发，可编译为单二进制文件，具备轻量、高效的特性。

核心功能

• 模板化邮件生成：从指定Git仓库拉取多语言邮件模板，支持动态数据填充
• 安全HTTP接口：通过TLS客户端证书认证的HTTP接口接收邮件请求
• SMTP集成：对接外部SMTP服务器实现邮件发送
• 模板自动更新：可配置间隔自动拉取模板仓库更新
• 开发测试支持：兼容MailHog等测试邮件服务器

使用场景

1. 开发测试：结合MailHog模拟邮件发送，验证模板渲染与功能正确性
2. 生产环境：为openSenseMap平台提供用户注册、数据通知等正式邮件服务

配置说明

服务通过环境变量配置，关键参数如下：

Docker部署示例

开发环境（结合MailHog）

1. 启动MailHog测试邮件服务器：

bash
docker run -d --name mailhog -p 1025:1025 -p 8025:8025 mailhog/mailhog

2. 生成证书并运行mailer：

bash
# 生成自签名证书（需先安装certstrap）
./genCerts.sh
# 构建镜像
docker build -t sensebox/sensebox-mailer .
# 启动容器
docker run -d --name sensebox-mailer \
  -e CA_CERT="$(cat ca.pem)" \
  -e SERVER_CERT="$(cat server.pem)" \
  -e SERVER_KEY="$(cat server-key.pem)" \
  -e SMTP_SERVER="localhost" \
  -e SMTP_PORT="1025" \
  -p 3924:3924 \
  sensebox/sensebox-mailer

生产环境（Docker Compose）

创建docker-compose.yml：

yaml
version: '3'
services:
  mailer:
    image: sensebox/sensebox-mailer
    environment:
      CA_CERT: "${CA_CERT}"
      SERVER_CERT: "${SERVER_CERT}"
      SERVER_KEY: "${SERVER_KEY}"
      SMTP_SERVER: "smtp.your-domain.com"
      SMTP_PORT: "587"
      SMTP_USER: "mailer@your-domain.com"
      SMTP_PASSWORD: "your-smtp-password"
      FROM_DOMAIN: "your-domain.com"
      TEMPLATES_REPOSITORY: "https://github.com/sensebox/sensebox-mailer-templates"
    ports:
      - "3924:3924"
    restart: always

启动服务：

bash
docker-compose up -d