Rust邮件发送库mail-send的使用，支持SMTP和IMAP协议的高效邮件发送与接收

mail-send是一个Rust库，用于构建、签名和通过SMTP发送电子邮件。它包含以下特性：

• 生成符合互联网消息格式标准（RFC 5322）的电子邮件
• 完整的MIME支持（RFC 2045-2049），自动为每个消息体部分选择最佳编码
• 支持DKIM签名（RFC 6376），包括ED25519-SHA256、RSA-SHA256和RSA-SHA1
• SMTP（RFC 5321）发送
• 支持TLS的SMTP安全扩展（RFC 3207）
• SMTP认证扩展（RFC 4954），支持多种认证机制：
  • CRAM-MD5
  • DIGEST-MD5
  • XOAUTH2
  • LOGIN
  • PLAIN
• 完全异步（需要Tokio）

使用示例

示例1：通过需要认证的SMTP服务器发送消息

// 构建一个简单的多部分消息
let message = MessageBuilder::new()
    .from(("John Doe", "john@example.com"))
    .to(vec![
        ("Jane Doe", "jane@example.com"),
        ("James Smith", "james@test.com"),
    ])
    .subject("Hi!")
    .html_body("<h1>Hello, world!</h1>")
    .text_body("Hello world!");

// 连接到SMTP提交端口，升级到TLS并使用提供的凭据进行认证
SmtpClientBuilder::new("smtp.gmail.com", 587)
    .implicit_tls(false)
    .credentials(("john", "p4ssw0rd"))
    .connect()
    .await
    .unwrap()
    .send(message)
    .await
    .unwrap();

示例2：使用DKIM签名消息并通过SMTP中继服务器发送

// 构建一个带有单个附件的简单文本消息
let message = MessageBuilder::new()
    .from(("John Doe", "john@example.com"))
    .to("jane@example.com")
    .subject("Howdy!")
    .text_body("These pretzels are making me thirsty.")
    .attachment("image/png", "pretzels.png", [1, 2, 3, 4].as_ref());

// 使用RSA-SHA256签名电子邮件
let pk_rsa = RsaKey::<Sha256>::from_rsa_pem(TEST_KEY).unwrap();
let signer = DkimSigner::from_key(pk_rsa)
    .domain("example.com")
    .selector("default")
    .headers(["From", "To", "Subject"])
    .expiration(60 * 极速 60 * 7); // 签名过期前的秒数（可选）

// 通过TLS连接到SMTP中继服务器
// 使用配置的DKIM签名器为每条消息签名
SmtpClientBuilder::new("smtp.gmail.com", 465)
    .connect()
    .await
    .unwrap()
    .send_signed(message, &signer)
    .await
    .unwrap();

完整示例代码

use mail_send::{MessageBuilder, SmtpClientBuilder};
use mail_send::dkim::{DkimSigner, RsaKey, Sha256};

#[tokio::main]
async fn main() {
    // 示例1：基本SMTP发送
    // 构建包含文本和HTML内容的邮件
    let basic_message = MessageBuilder::new()
        .from(("Sender Name", "sender@example.com"))
        .to("receiver@example.com")
        .subject("Test Email")
        .text_body("This is a test email sent using mail-send library.")
        .html_body("<h1>Test Email</h1><p>This is a test email sent using mail-send library.</p>");

    // 连接到SMTP服务器并发送邮件
    SmtpClientBuilder::new("smtp.example.com", 587)
        .implicit_tls(false)  // 显式TLS
        .credentials(("username", "password"))  // 认证凭据
        .connect()
        .await
        .unwrap()
        .send(basic_message)
        .await
        .unwrap();

    // 示例2：带DKIM签名的发送
    // 构建带附件的邮件
    let dkim_message = MessageBuilder::new()
        .from(("Sender Name", "sender@example.com"))
        .to("receiver@example.com")
        .subject("Test DKIM Signed Email")
        .text_body("This email is signed with DKIM.")
        .attachment(
            "text/plain",  // MIME类型
            "note.txt",    // 附件文件名
            "This is an attached file.".as_bytes()  // 附件内容
        );

    // 加载RSA私钥
    let private_key = "-----BEGIN RSA PRIVATE KEY-----\n...";
    let pk_rsa = RsaKey::<Sha256>::from_rsa_pem(private_key).unwrap();
    
    // 配置DKIM签名器
    let signer = DkimSigner::from_key(pk_rsa)
        .domain("example.com")  // 域名
        .selector("default")    // 选择器
        .headers(["From", "To", "Subject"]);  // 需要签名的头字段

    // 连接到SMTP服务器并发送带DKIM签名的邮件
    SmtpClientBuilder::new("smtp.example.com", 465)
        .connect()
        .await
        .unwrap()
        .send_signed(dkim_message, &signer)
        .await
        .unwrap();
}

测试

运行测试套件：

$ cargo test --all-features

或者使用MIRI运行测试套件：

$ cargo +nightly miri test --all-features

许可证

根据以下任一许可证授权：

• Apache License, Version 2.0
• MIT license

版权

Copyright © 2020-2022, Stalwart Labs Ltd.