域名 AXUM.RS 将于 2025 年 10 月到期。我们无意再对其进行续费,如果你有意接续这个域名,请与我们取得联系。
  • AXUM.RS 现仅需人民币 3000 元(大写:叁仟元整。接受适度议价
  • 按照行业规则,AXUM.RS 到期后,大概率会进入长时间的赎回期,该期间内,如果你想拥有该域名,将要付出高额的费用
  • 我们已启用 AXUM.EU.ORG 域名,并将持续运营
  • 仅接受微信或支付宝交易
如果你对 AXUM.RS 有兴趣,请和我们进行联系:

通过 lettre 发送邮件

本章将讨论使用 lettre 在 rust 中实现发送邮件。我们将分别使用 Gmail 和 Mail.ee 来作测试。

Gmail 的设置

如果你要在 rust 中(包括其它非 Gmail 官方的所有第三方邮件程序)使用 Gmail 发送邮件,必须满足以下条件:

  • 开启了两步验证
  • 创建了应用专用密码

详细操作,请查看官方文档

Mail.ee 的设置

依赖

[dependencies]
# ...
lettre = {version="0.10",features=["tokio1-native-tls"]}

配置

#[derive(Deserialize)]
pub struct EmailConfig {
    pub username: String, // 邮箱用户名,通常就是邮箱地址
    pub password: String, // 密码。Gmail要填应用专用密码;Mail.ee要填专用密码
    pub host: String, // smtp 地址
}
EMAIL.USERNAME='[email protected]'
EMAIL.PASSWORD='<你的专用密码>'
EMAIL.HOST='smtp.gmail.com'

示例二:Mail.ee配置

EMAIL.USERNAME='[email protected]'
EMAIL.PASSWORD='<你的专用密码>'
EMAIL.HOST='mail.mail.ee'

模型

我们定义了一个模型,用于映射每一封邮件:

pub struct Email {
    pub from: String, // 发件人地址。通常和配置中的username一样
    pub to: String, // 收件人地址
    pub subject: String, // 邮件主题
    pub body: String, // 邮件内容
}

impl Email {
    /// 转换为 letter 的 Message 类型
    pub fn to_message(&self) -> Result<Message> {
        Message::builder()
            .from(self.from.as_str().parse().unwrap())
            .to(self.to.as_str().parse().unwrap())
            .subject(self.subject.as_str())
            .header(ContentType::TEXT_PLAIN) // 如要发送 HTML 邮件,将这个换成 ContentType::TEXT_HTML
            .body(self.body.clone())
            .map_err(Error::from)
    }
}

lettre 同步发送邮件

/// 同步发送
pub fn sync_send(cfg: &EmailConfig, m: &model::email::Email) -> Result<Response> {
    let message = m.to_message()?;

    let creds = Credentials::new(cfg.username.clone(), cfg.password.clone());

    let mailer = SmtpTransport::relay(&cfg.host)
        .map_err(Error::from)?
        .credentials(creds)
        .build();

    mailer.send(&message).map_err(Error::from)
}
  • 生成一个邮件内容:let message = m.to_message()?;
  • 生成身份验证信息: let creds = Credentials::new(用户名, 密码);
  • 连接服务器: SmtpTransport::relay()
  • 发送邮件: mailer.send(&message)

测试

lettre 异步发送邮件

和同步发送大同小异:

  • 连接服务器时,使用了 AsyncSmtpTransport::relay()
  • 发送邮件时,直接使用消息,而不是它的引用 mailer.send(message)

测试

#[tokio::test]
async fn test_async_send_email() {
    let cfg = get_cfg().unwrap();
    let m = model::email::Email {
        from: format!("{}", &cfg.username),
        to: format!("[email protected]"),
        subject: format!("试试异步发送"),
        body: format!("你好呀,这是用lettre异步发送的邮件!"),
    };
    let resp = super::send(&cfg, &m).await.unwrap();
    tracing::info!("{:?}", resp);
}

本章代码位于02/lettre分支。

要查看完整内容,请先登录