ykanazawa/sendgrid-maildev Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

概述

SendGrid MailDev是SendGrid模拟API与MailDev的组合，用于在开发过程中测试SendGrid邮件功能。

核心功能与特性

• 集成SendGrid模拟API，可模拟SendGrid邮件发送接口
• 包含MailDev组件，提供Web界面查看接收到的测试邮件
• 支持通过API和SMTP两种方式测试邮件发送
• 无需依赖真实SendGrid账户即可完成本地开发测试

使用场景与适用范围

适用于开发和测试阶段，需要验证SendGrid邮件发送逻辑的场景。可避免向真实***发送测试邮件，确保开发环境中邮件功能的正确性和稳定性。

使用方法与配置说明

开发示例

docker-compose.yml示例

以下配置中的环境变量为默认值：

yaml
version: '2'

services:
  sendgrid-maildev:
    image: ykanazawa/sendgrid-maildev
    hostname: sendgrid-maildev
    environment:
      - SENDGRID_DEV_API_SERVER=:3030  # SendGrid模拟API服务地址和端口
      - SENDGRID_DEV_API_KEY=SG.xxxxx  # 访问模拟API的密钥
      - SENDGRID_DEV_SMTP_SERVER=127.0.0.1:1025  # SMTP服务器地址和端口
    container_name: sendgrid-maildev
    ports:
      - 1025:1025  # MailDev SMTP端口
      - 1080:1080  # MailDev Web界面端口
      - 3030:3030  # SendGrid模拟API端口

curl使用示例

通过curl命令测试模拟API接口：

bash
# 进入容器
docker exec -it sendgrid-maildev bash

# 发送测试邮件请求
curl --request POST \
  --url http://127.0.0.1:3030/v3/mail/send \
  --header 'Authorization: Bearer SG.xxxxx' \
  --header 'Content-Type: application/json' \
  --data '{"personalizations": [{ 
    "to": [{"email": "to@example.com"}]}], 
    "from": {"email": "from@example.com"}, 
    "subject": "Test Subject", 
    "content": [{"type": "text/plain", "value": "Test Content"}] 
  }'

AWS示例

!AWS示例