vorteil/smtp

SMTP镜像说明

镜像概述

vorteil/smtp是一个简洁的SMTP客户端镜像，旨在提供便捷的邮件发送功能。用户通过配置关键参数，即可完成邮件的发送操作，适用于自动化工作流或简单邮件通知场景。

核心功能

• 支持单/多收件人配置
• 可指定SMTP服务器地址与端口（如587/TLS、465/SSL）
• 允许嵌入图片（需配合模板使用，图片src需设为cid:图片名）
• 提供结构化错误输出，便于问题定位

使用场景

• 自动化工作流中的通知邮件发送（如Direktiv工作流）
• 应用程序的邮件提醒功能集成
• 简单批量邮件发送需求

配置说明

输入参数

发送邮件需提供以下必填参数：

yaml
input:
  to: ["recipient@example.com"]  # 收件人列表（数组形式）
  subject: "邮件主题"
  message: "邮件内容"  # 支持base64编码（需开启template参数）
  from: "sender@example.com"  # 发件人邮箱
  password: "发件人密码"  # 邮箱授权码或密码
  server: "smtp.example.com"  # SMTP服务器地址
  port: 587  # SMTP端口
  # 可选参数
  images: ["logo.png"]  # 嵌入图片列表（仅template=true时有效）
  template: false  # 是否启用模板（true/false）

Direktiv工作流示例

以下是在Direktiv平台中使用该镜像的工作流配置：

yaml
id: send-email
functions:
- id: send
  image: vorteil/smtp:v2
description: "通过SMTP发送测试邮件" 
states:
- id: SendEmail
  type: action
  action:
    function: send
    input:
      to: ["user@example.com"]
      subject: "SMTP测试邮件"
      template: false
      message: "你好，这是一封通过SMTP镜像发送的测试邮件！"
      from: "test@example.com"
      password: "your_auth_code"
      server: "smtp.example.com"
      port: 587

输出与错误处理

• 成功输出：无返回内容
• 错误输出：返回结构化错误信息

json
{
    "errorCode": "com.smtp.error",
    "errorMsg": "具体错误描述（如服务器连接失败、认证错误等）"
}

注意：嵌入图片时，需确保图片文件存在且HTML中图片src设置为cid:图片名（例如<img src="cid:logo.png">）。