SMTP 集成示例

前言

本指南提供了如何使用各种编程语言、框架和电子邮件客户端与 Forward Email 的 SMTP 服务集成的详细示例。我们的 SMTP 服务设计可靠、安全，并且易于与您现有的应用程序集成。

转发电子邮件的 SMTP 处理如何工作

在深入了解集成示例之前，了解我们的 SMTP 服务如何处理电子邮件非常重要：

电子邮件队列和重试系统

当您通过 SMTP 向我们的服务器提交电子邮件时：

初步处理：电子邮件经过验证、恶意软件扫描和垃圾邮件过滤器检查
智能排队：电子邮件被放置在复杂的队列系统中以便发送
智能重试机制：如果配送暂时失败，我们的系统将：
- 使用我们的 getBounceInfo 功能
- 确定问题是暂时的（例如，“稍后再试”、“暂时推迟”）还是永久的（例如，“用户未知”）
- 对于临时问题，请将电子邮件标记为重试
- 对于永久性问题，生成退回通知
5 天重试期：我们会重试投递长达 5 天（类似于 Postfix 等行业标准），以便有时间解决临时问题
递送状态通知：发件人会收到有关其电子邮件状态（已送达、延迟或退回）的通知

[!NOTE] 成功投递后，出于安全和隐私考虑，出站 SMTP 电子邮件内容将在可配置的保留期（默认 30 天）后被删除。仅会保留一条占位符消息，表示已成功投递。

可靠性验证

我们的系统旨在处理各种边缘情况：

如果检测到黑名单，则会自动重试发送电子邮件
如果发生网络问题，将重新尝试投递
如果收件人的邮箱已满，系统将稍后重试
如果接收服务器暂时不可用，我们将继续尝试

这种方法在保证隐私和安全的同时显著提高了投递率。

Node.js 集成

使用 Nodemailer

注意邮件是一个从 Node.js 应用程序发送电子邮件的流行模块。

const nodemailer = require('nodemailer');
// Create a transporter object
const transporter = nodemailer.createTransport({
host: 'smtp.forwardemail.net',
port: 465,
secure: true, // Use TLS
auth: {
user: 'your-username@your-domain.com',
pass: 'your-password'
}
});
// Send mail with defined transport object
async function sendEmail() {
try {
const info = await transporter.sendMail({
from: '"Your Name" <your-username@your-domain.com>',
to: 'recipient@example.com',
subject: 'Hello from Forward Email',
text: 'Hello world! This is a test email sent using Nodemailer and Forward Email SMTP.',
html: '<b>Hello world!</b> This is a test email sent using Nodemailer and Forward Email SMTP.'
});
console.log('Message sent: %s', info.messageId);
} catch (error) {
console.error('Error sending email:', error);
}
}
sendEmail();
使用 Express.js
以下是如何将转发电子邮件 SMTP 与 Express.js 应用程序集成：
const express = require('express');
const nodemailer = require('nodemailer');
const app = express();
const port = 3000;
app.use(express.json());
// Configure email transporter
const transporter = nodemailer.createTransport({
host: 'smtp.forwardemail.net',
port: 465,
secure: true,
auth: {
user: 'your-username@your-domain.com',
pass: 'your-password'
}
});
// API endpoint for sending emails
app.post('/send-email', async (req, res) => {
const { to, subject, text, html } = req.body;
try {
const info = await transporter.sendMail({
from: '"Your App" <your-username@your-domain.com>',
to,
subject,
text,
html
});
res.status(200).json({
  success: true,
  messageId: info.messageId
});
} catch (error) {
console.error('Error sending email:', error);
res.status(500).json({
success: false,
error: error.message
});
}
});
app.listen(port, () => {
console.log(Server running at http://localhost:${port});
});












Python 集成
使用 smtplib
import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
Email configuration
sender_email = "your-username@your-domain.com"
receiver_email = "recipient@example.com"
password = "your-password"
Create message
message = MIMEMultipart("alternative")
message["Subject"] = "Hello from Forward Email"
message["From"] = sender_email
message["To"] = receiver_email
Create the plain-text and HTML version of your message
text = "Hello world! This is a test email sent using Python and Forward Email SMTP."
html = "<html><body><b>Hello world!</b> This is a test email sent using Python and Forward Email SMTP.</body></html>"
Turn these into plain/html MIMEText objects
part1 = MIMEText(text, "plain")
part2 = MIMEText(html, "html")
Add HTML/plain-text parts to MIMEMultipart message
message.attach(part1)
message.attach(part2)
Send email
try:
server = smtplib.SMTP_SSL("smtp.forwardemail.net", 465)
server.login(sender_email, password)
server.sendmail(sender_email, receiver_email, message.as_string())
server.quit()
print("Email sent successfully!")
except Exception as e:
print(f"Error sending email: {e}")
使用 Django
对于 Django 应用程序，将以下内容添加到您的 settings.py:
# Email settings
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.forwardemail.net'
EMAIL_PORT = 465
EMAIL_USE_SSL = True
EMAIL_HOST_USER = 'your-username@your-domain.com'
EMAIL_HOST_PASSWORD = 'your-password'
DEFAULT_FROM_EMAIL = 'your-username@your-domain.com'
然后在您的视图中发送电子邮件：
from django.core.mail import send_mail
def send_email_view(request):
send_mail(
'Subject here',
'Here is the message.',
'from@your-domain.com',
['to@example.com'],
fail_silently=False,
html_message='<b>Here is the HTML message.</b>'
)
return HttpResponse('Email sent!')








PHP 集成
使用 PHPMailer
<?php
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;
require 'vendor/autoload.php';
$mail = new PHPMailer(true);
try {
// Server settings
$mail->isSMTP();
$mail->Host       = 'smtp.forwardemail.net';
$mail->SMTPAuth   = true;
$mail->Username   = 'your-username@your-domain.com';
$mail->Password   = 'your-password';
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
$mail->Port       = 465;
// Recipients
$mail->setFrom('your-username@your-domain.com', 'Your Name');
$mail->addAddress('recipient@example.com', 'Recipient Name');
$mail->addReplyTo('your-username@your-domain.com', 'Your Name');

// Content
$mail->isHTML(true);
$mail->Subject = 'Hello from Forward Email';
$mail->Body    = '&#x3C;b>Hello world!&#x3C;/b> This is a test email sent using PHPMailer and Forward Email SMTP.';
$mail->AltBody = 'Hello world! This is a test email sent using PHPMailer and Forward Email SMTP.';

$mail->send();
echo 'Message has been sent';
} catch (Exception $e) {
echo "Message could not be sent. Mailer Error: {$mail->ErrorInfo}";
}
使用 Laravel
对于 Laravel 应用程序，更新您的 .env 文件：
MAIL_MAILER=smtp
MAIL_HOST=smtp.forwardemail.net
MAIL_PORT=465
MAIL_USERNAME=your-username@your-domain.com
MAIL_PASSWORD=your-password
MAIL_ENCRYPTION=ssl
MAIL_FROM_ADDRESS=your-username@your-domain.com
MAIL_FROM_NAME="${APP_NAME}"
然后使用 Laravel 的邮件外观发送电子邮件：
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Mail;
use App\Mail\WelcomeEmail;
class EmailController extends Controller
{
public function sendEmail()
{
Mail::to('recipient@example.com')->send(new WelcomeEmail());
    return 'Email sent successfully!';
}
}










Ruby 集成
使用 Ruby Mail Gem
require 'mail'
Mail.defaults do
delivery_method :smtp, {
address: 'smtp.forwardemail.net',
port: 465,
domain: 'your-domain.com',
user_name: 'your-username@your-domain.com',
password: 'your-password',
authentication: 'plain',
enable_starttls_auto: true,
ssl: true
}
end
mail = Mail.new do
from     'your-username@your-domain.com'
to       'recipient@example.com'
subject  'Hello from Forward Email'
text_part do
body 'Hello world! This is a test email sent using Ruby Mail and Forward Email SMTP.'
end
html_part do
content_type 'text/html; charset=UTF-8'
body '<b>Hello world!</b> This is a test email sent using Ruby Mail and Forward Email SMTP.'
end
end
mail.deliver!
puts "Email sent successfully!"



Java 集成
使用 Java Mail API
import java.util.Properties;
import javax.mail.*;
import javax.mail.internet.*;
public class SendEmail {
public static void main(String[] args) {
// Sender's email and password
final String username = "your-username@your-domain.com";
final String password = "your-password";
    // SMTP server properties
    Properties props = new Properties();
    props.put("mail.smtp.auth", "true");
    props.put("mail.smtp.starttls.enable", "true");
    props.put("mail.smtp.host", "smtp.forwardemail.net");
    props.put("mail.smtp.port", "465");
    props.put("mail.smtp.socketFactory.port", "465");
    props.put("mail.smtp.socketFactory.class", "javax.net.ssl.SSLSocketFactory");

    // Create session with authenticator
    Session session = Session.getInstance(props,
        new javax.mail.Authenticator() {
            protected PasswordAuthentication getPasswordAuthentication() {
                return new PasswordAuthentication(username, password);
            }
        });

    try {
        // Create message
        Message message = new MimeMessage(session);
        message.setFrom(new InternetAddress(username));
        message.setRecipients(Message.RecipientType.TO, InternetAddress.parse("recipient@example.com"));
        message.setSubject("Hello from Forward Email");

        // Create multipart message
        Multipart multipart = new MimeMultipart("alternative");

        // Text part
        BodyPart textPart = new MimeBodyPart();
        textPart.setText("Hello world! This is a test email sent using JavaMail and Forward Email SMTP.");

        // HTML part
        BodyPart htmlPart = new MimeBodyPart();
        htmlPart.setContent("&#x3C;b>Hello world!&#x3C;/b> This is a test email sent using JavaMail and Forward Email SMTP.", "text/html");

        // Add parts to multipart
        multipart.addBodyPart(textPart);
        multipart.addBodyPart(htmlPart);

        // Set content
        message.setContent(multipart);

        // Send message
        Transport.send(message);

        System.out.println("Email sent successfully!");

    } catch (MessagingException e) {
        throw new RuntimeException(e);
    }
}
}




电子邮件客户端配置
雷鸟
flowchart TD
    A[Open Thunderbird] --> B[Account Settings]
    B --> C[Account Actions]
    C --> D[Add Mail Account]
    D --> E[Enter Name, Email, Password]
    E --> F[Manual Config]
    F --> G[Enter Server Details]
    G --> H[SMTP: smtp.forwardemail.net]
    H --> I[Port: 465]
    I --> J[Connection: SSL/TLS]
    J --> K[Authentication: Normal Password]
    K --> L[Username: full email address]
    L --> M[Test and Create Account]

打开 Thunderbird 并转到帐户设置
点击“帐户操作”，选择“添加邮件帐户”
输入您的姓名、电子邮件地址和密码
单击“手动配置”并输入以下详细信息：

接收服务器：

IMAP：imap.forwardemail.net，端口：993，SSL/TLS
POP3：pop3.forwardemail.net，端口：995，SSL/TLS


发件服务器（SMTP）：smtp.forwardemail.net，端口：465，SSL/TLS
身份验证：普通密码
用户名：您的完整电子邮件地址


点击“测试”，然后点击“完成”
苹果邮箱

打开邮件并转到邮件 > 偏好设置 > 帐户
点击“+”按钮添加新帐户
选择“其他邮件帐户”，点击“继续”
输入您的姓名、电子邮件地址和密码，然后单击“登录”
当自动设置失败时，请输入以下详细信息：

传入邮件服务器：imap.forwardemail.net（或对于 POP3，则为 pop3.forwardemail.net）
外发邮件服务器：smtp.forwardemail.net
用户名：您的完整电子邮件地址
密码： 您的密码


点击“登录”完成设置
Gmail（以…的名义发送邮件）

打开 Gmail，然后转到“设置”>“帐户和导入”
在“以…身份发送邮件”下，点击“添加其他电子邮件地址”
输入您的姓名和电子邮件地址，然后单击“下一步”
输入以下 SMTP 服务器详细信息：

SMTP 服务器： smtp.forwardemail.net
端口：465
用户名：您的完整电子邮件地址
密码： 您的密码
选择“使用 SSL 的安全连接”


点击“添加帐户”并验证您的电子邮件地址








故障排除
常见问题及解决方案


身份验证失败

验证您的用户名（完整电子邮件地址）和密码
确保您使用的是正确的端口（SSL/TLS 为 465）
检查您的账户是否启用了 SMTP 访问



连接超时

检查你的互联网连接
验证防火墙设置未阻止 SMTP 流量
尝试使用其他端口（使用 STARTTLS 的 587）



消息被拒绝

确保您的“发件人”地址与经过验证的电子邮件相符
检查你的 IP 是否被列入黑名单
确认您的邮件内容不会触发垃圾邮件过滤器



TLS/SSL 错误

更新你的应用程序/库以支持现代 TLS 版本
确保系统的 CA 证书是最新的
尝试显式 TLS 而不是隐式 TLS


获取帮助
如果您遇到这里未涵盖的问题，请：

查看我们的 常见问题解答页面 常见问题
查看我们的 关于电子邮件传递的博客文章 详细信息
联系我们的支持团队 support@forwardemail.net






其他资源

转发电子邮件文档
SMTP 服务器限制和配置
电子邮件最佳实践指南
安全实践


结论
Forward Email 的 SMTP 服务提供了一种可靠、安全且注重隐私的方式，可从您的应用程序和电子邮件客户端发送电子邮件。借助我们的智能队列系统、5 天重试机制和全面的投递状态通知，您可以确信您的电子邮件将到达目的地。
如需更多高级用例或自定义集成，请联系我们的支持团队。